接收客服主动邀评通知

为了提高用户参评率，七鱼为客服增加了主动邀请用户评价会话的入口。对于使用消息接口的企业，此处相应的增加了一种事件类型通知，通知事件类型为：EVA_INVITATION。客服主动邀评后，开发者服务器会收到如下POST请求

curl --location --request POST 'https://?time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "sessionId": 62927, "staffId": 1234, "staffName": "lantian", "staffType": 0, "staffIcon": "https://ysf.nosdn.127.net/29C25737ABC2524667D223A90FEF156D", "uid": "user1" }'

{ "code": 0, "staffId": 0, "message": "string", "count": 0, "sessionId": 0, "staffName": "string", "staffType": 0, "staffIcon": "string", "evaluationModel": { "title": "string", "note": "string", "type": 0, "list": [ { "name": "string", "value": 0 } ] } }

请求参数

Path 参数

QIYU_MSG_URL

string

必需

Query 参数

eventType

string

可选

示例值:

EVA_INVITATION

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

sessionId

integer

必需

staffId

integer

必需

staffName

string

必需

staffType

integer

必需

staffIcon

string

必需

uid

string

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码。200表示分配到客服，14005：没有客服在线，14006：需要排队，14010：没有客服在线，且留言功能已关闭。

staffId

integer

客服 ID。

必需

message

string

必需

如果分配到客服，此字段是客服的欢迎语，如果没有分配到客服，则是错误提示信息。

count

integer

必需

仅返回需要排队时该参数有效，表明排队队列中排在你前面你的人数。如果为0，则表示你排在队列最前面。

sessionId

integer

必需

会话 ID，后续对会话评价时有用。仅返回分配到客服时该参数有效。

staffName

string

客服名字。

必需

staffType

integer

必需

客服类型，0 表示机器人，1 表示人工会话。

staffIcon

string

必需

客服头像的 url。

evaluationModel

object

必需

满意度评价模型，在申请到人工客服时有值，后面根据该模型 value 值进行客服评价。

title

string

必需

note

string

必需

type

integer

必需

list

array [object {2}]

必需