更新时间:2026-07-31 GMT+08:00
分享

新增自定义扩展字段

前提条件

租户已提供查询客户扩展信息的接口给AICC,并由AICC侧提供用于对接客户查询接口的二次开发接口,完成对接。

操作步骤

  1. 以租户管理员角色登录AICC,选择配置中心 > 扩展与集成 > 接触记录数据项
  2. (自定义扩展字段的“数据来源类型”为“信息数据集”时才需要执行本步骤操作)新增接触记录数据集。

    1. 单击“接触记录数据集”,进入配置页面,单击“新建”
    2. 根据表1,填入参数值。
      表1 数据集参数说明

      属性

      说明

      数据集名称

      自定义数据集名称。字符串长度<=1024,创建多个,名称不可重复。

      数据集来源接口

      输入AICC侧开发的接口路径,用于对接客户提供的查询客户扩展信息的接口,请联系运维人员获取。

    3. 单击“保存”,完成配置。

  3. 新增自定义扩展字段。

    最多可新增10条扩展数据。

    1. 单击“接触记录字段”,进入配置页面,单击“新建”
    2. 根据表2,填入参数值。
      表2 自定义扩展字段参数说明

      属性

      说明

      字段类别

      选择“自定义扩展字段”。

      字段名称

      自定义扩展字段名称。字符串长度<=1024

      不允许包含特殊字符&<>";%/[]=+@

      字段标识

      字符串长度<=128

      请输入下划线(_)、美元符号($)、英文字母或者数字

      接触列表可见性

      扩展字段在接触记录列表是否可见,取值范围:

      • :是
      • :否

      字段顺序

      字段在接触记录侧的展示顺序。序号小的排在前,序号相同的按列表顺序,字段在前的先展示。取值范围:纯数字,1-100。

      数据来源类型

      数据来源的类型。

      取值范围:

      • 呼叫随路数据
      • 信息数据集

      数据来源对象映射字段

      数据来源对象映射字段名称,字符串长度<=128。

      “数据来源类型”为“呼叫随路数据”时此参数才可见。

      “数据来源对象映射字段”支持最多配置3个随路数据字段,中间使用“;”分隔,按照先后顺序获取随路数据字段的值回写扩展字段,前面有一个随路数据字段的值获取到了,后面的随路数据字段的值就不获取了,最终扩展字段中就只写入一个随路数据字段的值。

      来源数据集

      取值范围:租间下已添加的所有接触扩展信息数据集。

      “数据来源类型”为“信息数据集”时此参数才可见。

      数据集映射字段

      数据集映射字段,字符串长度<=32

      “数据来源类型”为“信息数据集”时此参数才可见。

      回写扩展字段

      回写扩展字段,取值范围:

      extField1~extField10

      数据类型

      数据类型,取值范围:

      • 字符串
      • 数据字典

      数据字典值

      数据类型为数据字典时,为必填项。

      输入格式:键值1:值1,键值2:值2

      局点存在WhatsApp渠道业务且需要在接触记录展示“呼叫场景”信息时自定义扩展字段配置如下:

      • “字段名称”配置为“呼叫场景”。
      • “字段标识”配置为“chatScene”。
      • 打开“接触列表可见性”。
      • 配置“字段顺序”的值。
      • “数据来源类型”选择“呼叫随路数据”。
      • “数据来源对象映射字段”配置为“chatScene”。
      • 配置“回写扩展字段”的值。
      • “数据类型”选择“数据字典”。
      • “数据字典值”配置为“0:chat,1:Bulk Message,2:ename card”。
    3. 单击“保存”,完成配置。

  4. 配置完成后,前往客户接触历史 > 接触记录,查看自定义扩展字段展示效果。

相关文档