# 配置AICC侧 租户管理员可以配置用户接入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密钥。 - 已获取API Fabric提供的认证证书，和当前系统的身份证书并在[管理证书](https://support.huaweicloud.com/usermanual-cec/cec_04_0462.html)中上传。获取认证证书方式如下： 1. 联系运维人员，由运维人员登录系统后台，在容器主节点上执行如下命令，生成证书。 ``` openssl s_client -showcerts -connect IP:28090 /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。 | | 信任证书 | API Fabric侧的认证证书，并在在[管理证书](https://support.huaweicloud.com/usermanual-cec/cec_04_0462.html)中上传。 | | 身份证书 | 当前系统的身份证书，并在[管理证书](https://support.huaweicloud.com/usermanual-cec/cec_04_0462.html)中上传。 | 4. 配置基础配置。 表2基础配置参数说明 | 参数 | 说明 | |:---|:---| | 渠道名称 | 渠道名称必须是唯一的，输入值只能由字母，数字或下划线组成（首字符只能用字母和下划线），最大长度为64个字符。 | | 组织配置 | 为渠道资源分配组织机构，从[配置组织机构](https://support.huaweicloud.com/usermanual-cec/cec_04_0003.html#ZH-CN_TOPIC_0000002510095985)中选择一个创建好的组织机构。 | | 技能队列 | 会查询当前租间的所有多媒体被叫配置，配置方法请参见[配置被叫](https://support.huaweicloud.com/usermanual-cec/cec_04_0018.html#ZH-CN_TOPIC_0000002478096036)。 其中查询条件："所有可访问组织"，由租户级参数"租户是否开启组织间的数据强制隔离机制"控制，开启后支持根据组织机构查询被叫配置。同时未配置组织机构权限的非管理员账号仅支持查询当前组织下的被叫配置。 | | 转人工关键字 | 用户在客户端输入该关键字后会由机器人服务转为人工座席服务。 说明： 开启智能机器人，转人工关键字必须设置。 | | 座席工作时间 | - 工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击"添加时段"，可增加时间段配置。 - 非工作日：可配置0-24小时间最多4个工作时间段。默认展示一个时间段，单击"添加时段"，可增加时间段配置。 非工作日为在"配置中心 \> 工作台配置 \> 在线交谈服务时间"页面设置的休息日。 | | 非工作时间提醒信息 | 非工作时间内，客户呼叫接入后，提示已配置的消息内容，提醒客户当前座席休息。 | | 排队提醒 | 选择排队提醒方式。 - 全部提醒 - 排队提醒 - 排队进展提醒 - 关闭提醒 | | 排队提醒内容 | 设置排队提醒内容。 长度限制256，不允许配置特殊字符\<\>'"/\\ "排队提醒"设置为"全部提醒"、"排队提醒"时，该参数为必填项。 | | 排队进展提醒内容 | 设置排队进展提醒内容。 - 长度限制256，不允许配置特殊字符\<\>'"/\\ - 支持设置变量，绑定变量仅支持userId（用户ID）、nickName（用户名称）、position（排队位置）、waitTime（预估等待时间，单位秒）、waitTimeInMinute（预估等待时间，单位分钟）。 变量waitTime、waitTimeInMinute只需配置其中一个即可。 - 默认值：您当前正在排队中，排在第${position}位，预计还要等待 ${waitTime}秒。 "排队提醒"设置为"全部提醒"、"排队进展提醒"时，该参数为必填项。 | | 呼叫转移交互次数 | 座席给用户发送的消息数，如果达到配置的交互次数，才可以使用呼叫转移功能。 当取值为0或为空时，座席可以随时使用呼叫转移功能。 | | **更多配置** || | 熟客模式 | 配置方法请参见[如何开启熟客模式](https://support.huaweicloud.com/usermanual-cec/cec_04_0085.html#ZH-CN_TOPIC_0000002509976059) | | 客户超时结束会话 | 配置方法请参见[如何设置客户超时结束会话](https://support.huaweicloud.com/usermanual-cec/cec_04_0086.html#ZH-CN_TOPIC_0000002478096072) | | 座席超时转移会话 | 配置方法请参见[如何设置座席超时转移会话](https://support.huaweicloud.com/usermanual-cec/cec_04_0087.html#ZH-CN_TOPIC_0000002510096029) | | 会话转移设置 | 配置方法请参见[如何设置会话转移设置](https://support.huaweicloud.com/usermanual-cec/cec_04_0088.html#ZH-CN_TOPIC_0000002477936100) | | 外呼离线消息配置 | 配置方法请参见[如何设置外呼离线消息配置](https://support.huaweicloud.com/usermanual-cec/cec_04_0090.html) | 5. 配置机器人配置。 表3机器人配置参数说明 | 参数 | 说明 | |:---|:---| | 接入智能机器人 | 配置方法请参见[如何接入智能机器人](https://support.huaweicloud.com/usermanual-cec/cec_04_0094.html#ZH-CN_TOPIC_0000002478096076) | | 接入机器人助手 | 配置方法请参见[如何接入机器人助手](https://support.huaweicloud.com/usermanual-cec/cec_04_0095.html#ZH-CN_TOPIC_0000002510096033) | 6. 单击"保存并进入下一步"，进入到集成说明页面。 查看并拷贝上行消息处理url到本地。 7. 通过Telegram软件，生成Token。 1. 使用任意账号登录Telegram。 2. 搜索@BotFather，添加联系人。 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001490729945.png) 3. 输入命令/newbot 4. 输入机器人名称：AICCCustomize_TWbot 需以bot结尾。 5. 保存生成的Token。 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001490932041.png) 8. 设置回调地址，实现消息转发。 调用https://api.telegram.org/bot*Token*/setWebhook接口。 ![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001441095396.png) *Token* 请替换成[7]中生成Token。 请求参数：配置成[6]中获取的上行消息处理url。 #### 后续操作 导出渠道配置。 ![](https://support.huaweicloud.com/usermanual-cec/public_sys-resources/note_3.0-zh-cn.png) - 导出范围：基础配置、机器人配置下所有配置。密码密钥不支持导出。 - 单次导出渠道配置记录最多100000条，单个导出文件限制2000条。 - 不勾选渠道，默认导出全部渠道配置。 - 输入压缩密码后，单击![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000002313845789.png)可以查看密码的明文。 1. 返回在渠道配置列表。 2. 勾选已创建的渠道配置，单击![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001934455232.png)，导出渠道配置。 3. 单击![](https://support.huaweicloud.com/usermanual-cec/figure/zh-cn_image_0000001961693697.png)，当"导出任务状态"为"成功"。 4. 单击"下载"，即可获得导出的渠道配置。