接收用户和机器人消息

2024-07-13

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

譬喻:

APPID: VVVVVVVVVVVVVVV

TOKEN: VVVVVVVVVVVVVVV

EncodingAESKey: VVVVVVVVVVVVVVV

配置人工客服回调接口:

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

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

authentication

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

接口类型:

POST乞求

Content-type: application/json 的 json 乞求

乞求参数注明:

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

音讯加解密注明:

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

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

客服接入形态(kfstate):

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

对话起源(from):

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

渠道注明(channel):

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

客服触发变乱(eZZZent):

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

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

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

客户评估(assessment):

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.

出售本站【域名】【外链】

接收用户和机器人消息

猜你喜欢