在线服务接入微信公众号_用户指南

微信接入流程

下面是整体流程, 具体每个流程的细节在下面各个小节。

获取聊天窗信息：拿到自己的租户 ID 和聊天窗 ID。
配置管理增加配置：增加微信的 TOKEN 配置以及其他配置。
配置公众号：配置公众号服务器地址和 TOKEN。
测试验证

步骤1. 获取聊天窗信息

首先打开服务配置 -> 聊天窗管理页面. 选择希望服务于公众号的聊天窗, 点击对应聊天窗的 聊天窗 URL 如下图:

聊天窗 URL

在点击聊天窗 URL 之后, 弹出框内容如下:

弹出框 URL

上图红色的部分, 在步骤3配置公众号的时候会用到.

步骤2. 配置管理增加配置

打开服务配置 -> 在线高级配置, 点击新增按钮, 新增内容如下:

配置新增

配置名称: 随意填写.

配置编码: 固定为WECHAT_PUBLIC_TOKEN

配置值 : 任意字符串(推荐写租户 ID) 在步骤3会用到

配置说明: 随意填写

步骤2.1 新增 AccessToken 获取URL 配置

服务配置 -> 在线高级配置, 点击新增按钮, 新增内容如下:

AK 回调 URL

配置名称: 随意填写.

配置编码: 固定为GET_WECHAT_ACCESSTOKEN_URL

配置值 : 为获取accesstoken的服务地址（注意：配置前请充分测试，确保该地址可通过公网正常访问并得到accesstoken）POST 请求

配置说明: 随意填写

回调接口接收内容

note: 云客服会按照如下参数调用客户自己封装的接口，来获取accesstoken

{
    "sceneCode" : "SE123456", //聊天窗编码,多个公众号同时接入云客服使用.
    "timestamp" : 1234312321412, //当前时间戳毫秒
    "digest" : "hmac_sha1(timestamp, key)" //用于消息安全校验，获取accesstoken，用户不需要获取key来做解密
}

note: hmac_sha1的计算方法见: https://help.aliyun.com/document_detail/62586.html? 的第4小节摘要计算方法

回调接口返回内容

{
    "result" : true,
    "timestamp" : 123432131232,//响应时间戳
    "data" : {
        "accesstoken" : "wechat_access_token",
        "expires_timestamp"  : "timestamp_in", //失效的时间点时间戳,毫秒
        "expires_duration" : "timeout_timestamp", //剩余失效时间长度,毫秒
    }
}

步骤3 微信公众平台配置

登录微信公众平台管理后台，左侧菜单，开发-基本配置，如下图:

微信配置

修改“服务器地址”和“令牌”这两个配置。服务器地址，将步骤1截图的红框部分和https://cschat-ccs.aliyun.com/openapi/wechat 拼接成完整的URL，如：https://cschat-ccs.aliyun.com/openapi/wechat?tntInstId=ZPLKH1CN&scene=SCE00000031 ; 令牌即为步骤2的WECHAT_PUBLIC_TOKEN的配置值。

步骤4 测试

测试前需要将聊天窗url中的 tntInstId 提供给我们的工单同学，并告知接入微信公众号渠道，需要注册 tntInstId，由我们后台开发同学注册后再进行测试。

步骤1选用的聊天窗对应的人工技能组的客服通过在线工作台上线，访客在测试公众号原生聊天界面发送消息，经过若干轮和机器人的对话（具体规则取决于聊天窗的配置），访客和客服会自动建立会话连接，即可开始消息通信。

接入小程序渠道

需要用户提供检验文件（文件和文件名称）给我们的工单同学

上传完成后可以配置域名为：租户ID.cschat-ccs.aliyun.com

注意：租户id是聊天窗url中的tntInstId字段

例如：

聊天窗url为：https://cschat-ccs.aliyun.com/index.htm?tntInstId=_0GBRgxA&scene=SCE00000001

则绑定域名为：https://0GBRgxA.cschat-ccs.aliyun.com

在小程序中绑定的聊天窗url也要修改为：https://0GBRgxA.cschat-ccs.aliyun.com/index.htm?tntInstId=_0GBRgxA&scene=SCE00000001

小程序校验文件就是在微信公众平台上的域名校验文件，在小程序使用外界域名的时候，微信小程序需要校验，用户在微信公众平台配置域名的地方可以下载