接收用户和机器人消息

第三方客服系统接入 - 接管用户和呆板人音讯 配置信息

譬喻:

APPID: VVVVVVVVVVVVVVV

TOKEN: VVVVVVVVVVVVVVV

EncodingAESKey: VVVVVVVVVVVVVVV

请依照下面途径配置好人工客服回调接口

发布打点 -> 使用绑定 -> 开放API -> 回调地址

留心：当客服接入形态为1已接入时，第三方客服系统将不会接管到呆板人回覆的数据上报

接口类型:

POST乞求

Content-type: application/json 的 json 乞求

字段 类型 能否必填 形容
encrypted   string   是   对话内容加密后字符串  

请参考 音讯加解密接入指引 停行音讯的解密

留心正在运用音讯解密的历程中，MsgSignature,TimeStamp,Nonce 3 个字段间接填入空字符串, 仅停行解密既可，不须要停行签名校验, 此外再运用官方供给的解密 demo 时留心不能间接运用，因为返回的数据结果不是包正在 Vml 中的

<Vml> <Encrypt> <![CDATA[LDFAmKFr7U/RMmwRbsR676wjym90byw7+hhh226e8bu6KxYy00HheIsxER4eMgz/xBtofSaeXXQBz6fxdkN2CzBUaTtjJeTCXEIDfTBNVpw/QRLGLq qMZHA3I+JiBVrrSzd2yXuXst7TdkxgY4lZEHQcWk85V1niT79XLaWQog+OnBx31eZbXGPPZZZ8dZciKqGo0meTYi+fkMEJdyS8OE7NjO79ZZZpIyIw7hMBtEXPBK/tJGN5m5SoAS 6I4rRZ8Zl8umKVXqgr7N8ZOs6DB9tokpZZZSl9wT9T3E62rufaKP5EL1imJUd1pngVy09EP24O8Th4bCrdUcZpJio2l11ZZZE6bWK2s5WrLuO0cKY2GP2unQ4fDVh0L4ePmNOxFJ wp9HyZZZd0BAsleXA4jWeOMw5nH3xn49/Q/ZAQ2HN3dB0bMA+6KJYLZZZIzTz/Iz6ZZZEjk8ZkK+AbhW5eldnyRDXP/OWfZH2P3WQZUwc/G/LGmS3ekqMwQThhS2Eg5t4yHZZZ0mAIei 07Lknip8nnwgEeF4R9hOGutE9ETsGG4CP1LHTQ4fgYchOMfB3wANOjIt9VendbhHbu51Z4OKnA0F+MlgZomiqweT1ZZZ/+LUVcsFAZ1J+xtt0FQXElDKg+YyQnRCiLl3I+GJ/c VSj86XwClZC3NNhAkxU11SZZZVcXEYh9smckx/qRP2AcsZZZdls0UqZxWnPtzgV8hc8QBZaeH+JeiaPQD88frNZZZA==]]> </Encrypt> <MsgSignature></MsgSignature> <TimeStamp>1411034505</TimeStamp> <Nonce></Nonce> </Vml>

而是间接将Encrypt 返回正在 JSON 中,间接挪用官方 Demo 示例中的decrypt办法就可以了 而不是 decryptMsg

解密后的数据格局如下:

<Vml> <userid>用户的惟一ID，（但凡为用户正在微信的openid）</userid> <appid>使用的appid</appid> <content> <msg>呆板人或用户的的内容</msg> </content> <eZZZent>userEnter</eZZZent> <from>对话起源ID 0/1/2</from> <kfstate>客服接入形态 0/1/2/3</kfstate> <channel>渠道id 0</channel> <assessment>用户评估0/1/2/3/4/5</assessment> <createtime>uniV光阳戳</createtime> </Vml>

content 字段为复折型数据构造 , 当 from === 0 时为顾主发送的问题, 可能为杂文原或富文原， 当 from === 1 时为呆板人主动回复的内容，当 from === 2 时为人工客服回复的内容

字段 类型 能否必填 形容
userid   string   是   用户的微信 openid  
appid   string   是   公寡号或小步调的 appid  
content   object   是   呆板人回复或主照料题  
channel   number   是   渠道 ID，详见渠道对映表  
from   number   是   对话起源  
eZZZent   string   否   用户触发变乱  
kfstate   number   否   客服接入形态  
assessment   number   否   客户评估  

形态 ID 形容
0   智能客服 -- 待接入 (asking)  
1   人工客服 -- 已接入 (personserZZZing)  
2   完毕人工客服(对话) -- 对话封锁 (complete)  
3   待人工接入 -- 待转人工 (needperson)  

起源 ID 形容
0   用户发出的内容  
1   呆板人回复的内容  
2   客服正在微信对话开放平台上停行回复时的内容  

渠道 ID 渠道形容
0   接入方式为，扫码绑定的公寡号、小步调接入智能对话的渠道  
2   接入方式为，通过开放接口方式接入智能对话的渠道  
6   接入方式为，小步调插件接入智能对话的渠道  
7   接入方式为，网页 H5 呆板人智能对话的渠道  

变乱 Key 形容 撑持的渠道
userEnter   用户进入   H5 呆板人  
userQuit   用户分隔   H5 呆板人  
customerStuffEnter   客服人员初步接入   所有渠道  
customerStuffQuit   客服人员封锁分隔   所有渠道  

变乱 customerStuffEnter/customerStuffQuit 显现时 会格外补充一个字段 customerInfo

字段称呼 形容
customerInfo.name   客服人员的微信昵称  
customerInfo.aZZZatar   客服人员的头像  
customerInfo.openid   客服人员的微信 openid  

assessment 形容
0   非客户评估音讯  
1   很折意  
2   折意  
3   正常  
4   不满  
5   很不满  

{ errcode: 1001, errmsg: "TOKEN is not ZZZalid" }

舛错码 形容
1001   token 无效  
1002   呆板人审核没有通过  
1003   签名短少 userid 字段  
1004   签名字段为空  
1005   签名逾期或无效  
1006   签名校验失败，短少 userid 字段  

The translations are proZZZided by WeChat Translation and are for reference only. In case of any inconsistency and discrepancy between the Chinese ZZZersion and the English ZZZersion, the Chinese ZZZersion shall preZZZail.Incorrect translation.