抖音开放平台Logo
开发者文档
控制台

抖音客服平台-客服能力消息推送接入指引

收藏
我的收藏

技术接入流程

参考流程图:

详细路径:

步骤一:消息推送能力接入

参考:消息推送配置接入指引 进行接入

步骤二:接收消息

在具体的推送请求中,有效的 payload 会放在请求的 body 中,开发者可在验签成功后对 body 进行解析,并执行具体的推送业务逻辑。

请求

编码协议:JSON
字段
必须
说明
app_id
小游戏ID
conversation_id
会话ID,当前用户所处的会话
msg_id
消息ID(可用作幂等保证)
由于平台无法保障一次推送逻辑只触发一次消息推送,在执行推送时,开发者需通过 msg_id 保障幂等,避免同一个 msg_id 被多次使用。
create_time
用户消息的创建时间,秒级时间戳
msg_type
当前消息的类型,文字消息/图片消息
content
消息内容
示例:
// 文本消息 { "app_id": "tt123456", "conversation_id": 74689827099567557, // 会话 id,后续基于该 id 回复消息 "msg_id": 111111111, // 客服消息唯一 id(基于此做幂等判断) "create_time": 1741266191, "msg_type": "text", "content": "this is content" } // 图片消息 { "app_id": "tt123456", "conversation_id": 74689827099567557, // 会话 id,后续基于该 id 回复消息 "msg_id": 111111111, // 客服消息唯一 id(基于此做幂等判断) "create_time": 1741266191, "msg_type": "image", "pic_url": "this is image url link" }

响应

正常响应
HTTP 状态码:200
HTTP 响应体:JSON
{ "success": true }
异常响应
HTTP 状态码:200
HTTP 响应体:JSON
{ "success": false, "err_code": 100002, "reason": "失败原因" }
err_code 错误码枚举
err_code
说明
100002
触发频控,允许稍后重试

步骤三:回复消息

用户发送信息后,可在48小时内,至多回复5条信息
具体调用方式:参考 回复文本消息回复图片消息 进行回复