配置TELEGRAM渠道

前提条件

• 已联系系统管理员在“配置中心 > 扩展与集成管理 > 接口配置 > APP服务 > APP管理”，找到订阅了ccmessage_telegram_north_v1.0.0、telegram_north_v1.0.0和file_donload_get-v1.0.0-manual - v1.0.0接口并绑定了待配置TELEGRAM渠道租间的APP，获取APP标识和APP密钥。
• 已联系系统管理员在“配置中心 > 系统管理 > 系统参数配置”，在系统参数分类“系统参数 > 服务渠道配置 > 公共类”下中的【ApiFabric接口地址】绑定ApiFabric的IP 端口（必须是IP端口格式）。
• 已向系统管理员提出申请将系统前台登录IP和端口加入地址白名单中，以https://开头，示例：https://*.*.*.*:28090。本渠道配置暂不支持域名。
• 已获取API Fabric提供的认证证书，和当前系统的身份证书并在管理证书中上传。获取认证证书方式如下：
  1. 联系运维人员，由运维人员登录系统后台，在容器主节点上执行如下命令，生成证书。

     openssl s_client -showcerts -connect IP:28090 </dev/null 2>/dev/null|openssl x509 -outform PEM >mycertfile.pem

     其中，IP请配置为系统前台登录IP或NSLB所在服务器的IP。

  2. 转换证书格式，即可获得认证证书。

     openssl x509 -in mycertfile.pem -outform der -out mycert.cer

• 已安装TELEGRAM软件。

背景信息

当API Fabric提供的APPID、APPSecret发生变化时，涉及的TELEGRAM渠道需要同步修改，修改方式：租户管理员进入“配置中心 > 接入配置 > 渠道配置”，单击涉及渠道操作列的“修改”，更新APP标识、APP密钥的值。

操作步骤

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

   输入“渠道接入编码”，选择“TELEGRAM”渠道，单击“下一步”，继续下一步配置。

   

   渠道接入编码必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。

3. 配置TELEGRAM渠道的“选择配置方法”参数。

   表1 TELEGRAM渠道参数配置

   参数	说明
   个性化配置
   APP标识	填入从API Fabric获取的APPID信息，即AK。
   APP密钥	填入从API Fabric获取的APPSecret信息，即SK。
   BaseUrl	系统前台登录IP和端口，以https://开头，示例：https://*.*.*.*:28090。暂不支持域名。
   信任证书	API Fabric侧的认证证书，并在在管理证书中上传。
   身份证书	当前系统的身份证书，并在管理证书中上传。
   公共配置
   渠道接入编码	展示在2设置的渠道接入编码，支持修改。
   信息配置	需要配置以下参数： 技能队列：配置框会查询当前租间的所有多媒体被叫配置，用户酌情选择。 转人工关键字：用户在TELEGRAM客户端输入该关键字后会由机器人服务转为人工座席服务。 说明： 若不开启智能机器人，转人工关键字可不设置。
   熟客模式	默认关闭。熟客模式配置参考如何开启熟客模式。
   会话结束方式	自定义访客未回复超时时间，若不开启，默认分钟3分钟超时。开启后配置方式参考如何设置会话结束方式。
   座席超时转移设置	自定义座席未回复超时时间。默认关闭，开启后配置方式参考如何设置座席超时转移。
   会话转移设置	座席转移会话时仅展示对应渠道类型的技能队列。开启后配置方式参考如何设置会话转移设置。
   离线消息	默认关闭。开启后配置方式参考如何开启离线消息。
   座席工作时间	工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。 非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击新增，可增加时间段配置。 非工作时间提醒信息：不在非工作日配置的时间段内，客户呼入时，提醒信息。
   机器人设置	默认关闭，表示直接转座席。开关开启，需要根据实际情况配置机器人信息。需配置以下参数： 更换头像：可更换机器人头像。 名字：为机器人添加名字。 性别：为机器人添加性别。 机器人接入码：从智能IVR中选择配置好的机器人接入码。 默认回复语：当机器人不能识别客户语意，自定义回复语。 超时回复语：当客户会话超时，自定义超时回复语。 转人工提示语：自定义转人工成功提示语。 静默座席技能队列：配置框会查询当前租间的所有多媒体被叫配置，用户酌情选择。
   机器人助手配置	默认关闭。开关开启，则在座席侧开启机器人助手。 机器人助手接入码：从智能IVR中选择配置好的机器人助手接入码。

4. 单击“保存并进入下一步”，进入到集成说明页面。

   查看上行消息处理url。

   

5. 通过TELEGRAM软件，生成Token。
   1. 使用任意账号登录TELEGRAM。
   2. 搜索@BotFather，添加联系人。

      

   3. 输入命令/newbot
   4. 输入机器人名称：AICCCustomize_TWbot

      需以bot结尾。

   5. 保存生成的Token。

      

6. 设置回调地址，实现消息转发。

   调用https://api.telegram.org/botToken/setWebhook接口。

   

   Token请替换成5中生成Token。

   请求参数：配置成4中获取的上行消息处理url。