更新时间:2024-09-12 GMT+08:00
分享

配置AICC侧

前提条件

  • 已联系系统管理员在配置中心 > 扩展与集成 > 接口管理 > 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. 单击“新建”,打开社交媒体开通配置页面。
  3. 配置渠道信息。

    表1 渠道信息参数说明

    参数

    说明

    渠道选择

    选择Telegram

    APP标识

    填入从API Fabric获取的APPID信息,即AK。

    APP密钥

    填入从API Fabric获取的APPSecret信息,即SK。

    BaseUrl

    系统前台登录IP和端口,以https://开头,示例:https://*.*.*.*:28090。暂不支持域名。

    信任证书

    API Fabric侧的认证证书,并在在管理证书中上传。

    身份证书

    当前系统的身份证书,并在管理证书中上传。

  4. 配置基础配置。

    表2 基础配置参数说明

    参数

    说明

    渠道名称

    渠道名称必须是唯一的,输入值只能由字母,数字或下划线组成(首字符只能用字母和下划线),最大长度为64个字符。

    组织配置

    为渠道资源分配组织机构,从配置组织机构中选择一个创建好的组织机构。

    技能队列

    会查询当前租间的所有多媒体被叫配置,配置方法请参见配置被叫

    转人工关键字

    用户在客户端输入该关键字后会由机器人服务转为人工座席服务。

    说明:

    开启智能机器人,转人工关键字必须设置。

    座席工作时间

    • 工作日:可配置0-24小时间最多4个工作时间段。默认展示一个时间段,单击新增,可增加时间段配置。
    • 非工作日:可配置0-24小时间最多4个工作时间段。默认展示一个时间段,单击新增,可增加时间段配置。

      非工作日为在配置中心 > 工作台配置 > 在线交谈服务时间页面设置的休息日。

    非工作时间提醒信息

    非工作时间内,客户呼叫接入后,提示已配置的消息内容,提醒客户当前座席休息。

    更多配置

    熟客模式

    配置方法请参见如何开启熟客模式

    客户超时结束会话

    配置方法请参见如何设置客户超时结束会话

    座席超时转移会话

    配置方法请参见如何设置座席超时转移会话

    会话转移设置

    配置方法请参见如何设置会话转移设置

    外呼离线消息配置

    配置方法请参见如何设置外呼离线消息配置

  5. 配置机器人配置。

    表3 机器人配置参数说明

    参数

    说明

    接入智能机器人

    配置方法请参见如何接入智能机器人

    接入机器人助手

    配置方法请参见如何接入机器人助手

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

    查看并拷贝上行消息处理url到本地。

  7. 通过Telegram软件,生成Token。

    1. 使用任意账号登录Telegram。
    2. 搜索@BotFather,添加联系人。

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

      需以bot结尾。

    5. 保存生成的Token。

  8. 设置回调地址,实现消息转发。

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

    Token请替换成7中生成Token。

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

后续操作

导出渠道配置。

  • 导出范围:基础配置、机器人配置下所有配置。密码密钥不支持导出。
  • 单次导出渠道配置记录最多100000条,单个导出文件限制2000条。
  • 不勾选渠道,默认导出全部渠道配置。
  1. 返回在渠道配置列表。
  2. 勾选已创建的渠道配置,单击,导出渠道配置。
  3. 单击,当“导出任务状态”“成功”
  4. 单击“下载”,即可获得导出的渠道配置。

相关文档