配置X (Twitter)渠道

前提条件

• 本功能仅适用于除中国大陆以外的海外区域，中国大陆不适用。
• 该特性需AICC 25.200.0版本只支持演示，不可商用。若需要商用，需将AICC版本升级到AICC 25.200.0.SPC1。
• 该渠道对应的账号由客户侧提供，该账号产生相关的费用由客户承担。

• 系统管理员已在“配置中心 > 系统管理 > 证书管理”中上传Twitter认证证书。
• 获取Twitter平台中开发者信息。
  1. 打开推特开发者页面申请开发者账号https://developer.twitter.com/en，开发者账号申请成功后，可在如下页面查看。

     

  2. 查看相关配置参数：API Key&Secret、Access Token&Secret。

     

背景信息

• Twitter本身支持一个项目可以对接多个系统，但是AICC要求Twitter上的项目和渠道配置是一对一的， 不然会造成消息重复接收的情况 。
• API key、API key secret、Access Token、Access Token Secret由X (Twitter)提供，当X (Twitter)侧发生变化时，涉及的X (Twitter)渠道需要同步修改，修改方式：租户管理员进入“配置中心 > 接入配置 > 渠道配置”，单击涉及渠道操作列的“编辑”，更新API key、API key secret、Access Token、Access Token Secret的值。

操作步骤

1. 以租户管理员角色登录AICC，选择“配置中心 > 接入配置 > 渠道配置”，进入渠道列表页面。
2. 单击“新建”，打开社交媒体开通配置页面。
3. 配置渠道信息。

   表1 渠道信息参数说明

   参数	说明
   渠道选择	选择X (Twitter)
   API码	输入X (Twitter)平台中开发者页面的信息。
   API密钥
   访问令牌
   访问令牌密钥
   账号等级	企业级账号默认开通WebHooks实时消息推送。其他等级账号不支持实时消息推送，且消息拉取数量受限于X官方限制，无法保证全量消息同步到AICC。建议商用阶段使用企业级账号。请按照实际情况正确选择账号等级。 取值范围： Basic：基础 Enterprise：企业 Pro：高级 说明： 选择Enterprise，企业级账号时，采用WebHook（推模式）的方式，获取消息。 选择Basic或Pro，非企业级账号时，采用拉模式，获取消息。AICC每分钟向Twitter拉取一次消息。
   对接加密算法	对接X (Twitter)的加密算法，取值范围： SHA-1 SHA-256 说明： SHA-1算法强度不够，存在安全风险。如果平台支持，建议选择更高强度的算法SHA-256。

4. 配置基础配置。

   表2 基础配置参数说明

   参数	说明
   渠道名称	渠道名称必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。
   组织配置	为渠道资源分配组织机构，从配置组织机构中选择一个创建好的组织机构。
   技能队列	会查询当前租间的所有多媒体被叫配置，配置方法请参见配置被叫。 其中查询条件：“所有可访问组织”，由租户级参数“租户是否开启组织间的数据强制隔离机制”控制，开启后支持根据组织机构查询被叫配置。同时未配置组织机构权限的非管理员账号仅支持查询当前组织下的被叫配置。
   转人工关键字	用户在客户端输入该关键字后会由机器人服务转为人工座席服务。 说明： 开启智能机器人，转人工关键字必须设置。
   座席工作时间	工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。 非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。 非工作日为在“配置中心 > 工作台配置 > 在线交谈服务时间”页面设置的休息日。
   非工作时间提醒信息	非工作时间内，客户呼叫接入后，提示已配置的消息内容，提醒客户当前座席休息。
   排队提醒	选择排队提醒方式。 全部提醒 排队提醒 排队进展提醒 关闭提醒
   排队提醒内容	设置排队提醒内容。 长度限制256，不允许配置特殊字符<>'"/\ “排队提醒”设置为“全部提醒”、“排队提醒”时，该参数为必填项。
   排队进展提醒内容	设置排队进展提醒内容。 长度限制256，不允许配置特殊字符<>'"/\ 支持设置变量，绑定变量仅支持userId（用户ID）、nickName（用户名称）、position（排队位置）、waitTime（预估等待时间，单位：秒） 默认值：您当前正在排队中，排在第${position}位，预计还要等待${waitTime}秒。 “排队提醒”设置为“全部提醒”、“排队进展提醒”时，该参数为必填项。
   呼叫转移交互次数	座席给用户发送的消息数，如果达到配置的交互次数，才可以使用呼叫转移功能。 当取值为0或为空时，座席可以随时使用呼叫转移功能。
   更多配置
   熟客模式	配置方法请参见如何开启熟客模式
   客户超时结束会话	配置方法请参见如何设置客户超时结束会话
   座席超时转移会话	配置方法请参见如何设置座席超时转移会话
   会话转移设置	配置方法请参见如何设置会话转移设置

5. 配置机器人配置。

   表3 机器人配置参数说明

   参数	说明
   接入智能机器人	配置方法请参见如何接入智能机器人
   接入机器人助手	配置方法请参见如何接入机器人助手

6. 单击“下一步”，进入到集成说明页面。

   

7. 单击“提交”进行Token认证，认证通过后，说明接入成功，进入到接入成功页面。

   

后续操作

导出渠道配置。

• 导出范围：基础配置、机器人配置下所有配置。密码密钥不支持导出。
• 单次导出渠道配置记录最多100000条，单个导出文件限制2000条。
• 不勾选渠道，默认导出全部渠道配置。
• 输入压缩密码后，单击可以查看密码的明文。

1. 返回在渠道配置列表。
2. 勾选已创建的渠道配置，单击，导出渠道配置。
3. 单击，当“导出任务状态”为“成功”。
4. 单击“下载”，即可获得导出的渠道配置。