全部产品
阿里云办公

在线服务接入微信渠道

更新时间:2018-08-20 10:10:43

微信接入流程

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

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

步骤1. 获取聊天窗信息

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

聊天窗 URL

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

弹出框 URL

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

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

打开在线工作台 -> 配置管理页面, 点击新增按钮, 新增内容如下:

配置新增

配置名称: 随意填写.

配置编码: 固定为WECHAT_PUBLIC_TOKEN

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

配置说明: 随意填写

步骤2.1 新增 AccessToken 获取URL 配置

note : 该步骤与步骤2.2互斥, 由于新的微信公众号强制打开 IP 白名单(不能使用 IP 段), 现在不再推荐使用步骤2.2的方式, 除非该公众号并没有配置过 IP白名单.

在线工作台 -> 配置管理页面, 点击新增按钮, 新增内容如下:

AK 回调 URL

配置名称: 随意填写.

配置编码: 固定为GET_WECHAT_ACCESSTOKEN_URL

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

配置说明: 随意填写

回调接口接收内容

  1. {
  2. "sceneCode" : "SE123456", //聊天窗编码,多个公众号同时接入零号云客服使用.
  3. "timestamp" : 1234312321412, //当前时间戳毫秒
  4. "digest" : "hmac_sha1(timestamp, key)" //Key 请联系零号云客服获取
  5. }

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

回调接口返回内容

  1. {
  2. "result" : true,
  3. "timestamp" : 123432131232,//响应时间戳
  4. "data" : {
  5. "accesstoken" : "wechat_access_token",
  6. "expires_timestamp" : "timestamp_in", //失效的时间点时间戳,毫秒
  7. "expires_duration" : "timeout_timestamp", //剩余失效时间长度,毫秒
  8. }
  9. }

步骤2.2 新增 APPID 和 SECRET 配置

note: 本接口已经不再适合所有公众号, 并且由于 secret 是明文配置在租户自己的工作台的, 请保证自己的信息安全.

同步骤2.1一样, 配置管理新增两个配置.

一个配置编码为WECHAT_PUBLIC_APPID, 配置值请从微信公众号管理后台获取。

一个配置编码为WECHAT_PUBLIC_SECRET,配置值请从微信公众号管理后台获取。

步骤3 微信公众平台配置

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

微信配置

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

步骤4 测试

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