tencent cloud

云联络中心

产品公告
产品动态
关于云联络中心术语更新
产品简介
产品概述
功能列表
名词介绍
应对防火墙限制相关
AI 专区
购买指南
语音通话计费概述
在线会话计费概述
查看账单
退费指引
新用户手册
语音通话指引
在线会话指引
场景用例
客服热线（呼入）
电话营销（呼出）
语音提醒（自动外呼）
集成用例(SDK)
管理员操作手册
语音通话分册
在线会话分册
工作台操作手册
语音通话分册
在线会话分册
AI 智能体操作手册
语音智能体介绍
语音智能体实践教程
新建语音智能体
实现智能体通话
查看智能体通话
开发操作手册
SDK 开发指南
数据推送
语音通话 API 文档
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
在线会话 API 文档
服务端 API
回调配置
常见问题
数据删除指引
相关协议
隐私政策
数据隐私和安全协议
服务等级协议
云联络中心用户协议
词汇表
联系我们
文档云联络中心在线会话 API 文档回调配置接口调用

接口调用

聚焦模式
字号
最后更新时间： 2025-05-15 14:58:35

功能说明

接口调用回调用于多轮任务的接口调用节点中，主要是将会话相关的一些信息（例如用户 ID、客服账号 ID）或者应用自定义的其他信息回调到业务后台。

注意事项

要启用回调，必须在 智能客服管理端 的多轮任务接口调用节点进行配置。
回调的方向是即时通信 IM 后台向 App 后台发起 HTTP POST 请求。
收到事件通知后应异步处理内部逻辑，同步返回接收成功应答。
App 后台在收到回调请求之后，务必校验请求 URL 中的参数 SDKAppID 是否是自己的 SDKAppID。
其他安全相关事宜请参见 第三方回调简介：安全考虑 文档。

接口说明

请求 URL 示例

以下示例中 App 配置的回调 URL 为 https://www.example.com。
示例：
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform

请求参数说明

参数
说明
https
请求协议为 HTTPS，请求方式为 POST
www.example.com
回调 URL
SdkAppid
创建应用时在即时通信 IM 控制台分配的 SDKAppID
CallbackCommand
固定为 Chatbot.InterfaceInvocation
contenttype
固定值为 JSON
ClientIP
客户端 IP，格式例如：127.0.0.1

请求包示例

{
    "CallbackCommand": "Chatbot.InterfaceInvocation",  // 回调的命令字
    "Body": 		// 透传给业务方的变量值
  	{		
        "SystemClientUserID": "user517",		// 系统变量，用户ID
        "SystemSessionID": "207cac25-f49e-4ada-9c9f-301cea31dcf2", // 系统变量，SessionID
        "staticKey": "staticValue",		// 固定值
        "testKey3": ""					// 自定义变量
    },
    "EventTime": 1731488371784
}

请求包字段说明

字段
类型
是否必填
说明
CallbackCommand
String
是
回调的命令字，固定是 Chatbot.InterfaceInvocation。
Body
Object
是
透传给业务方的包体，包含了一个map，key是变量名，value是变量值。 具体的变量类型可以参考多轮任务中的 接口调用节点。
EventTime
Integer
是
时间戳。

应答包示例

App 后台同步数据后，发送回调应答包。
{
  "ActionStatus":"OK",
  "ErrorInfo":"",
  "ErrorCode":0,
  "Body": 
  {
    "testKey1":"value1",	// 业务返回的变量
    "testKey3":"10"
  }
}

应答包字段说明

字段
类型
是否必填
说明
ErrorCode
Integer
是
错误码，0:成功，其他：失败。
ErrorInfo
String
是
错误信息。
ActionStatus
String
是
请求处理的结果，OK 表示处理成功。
Body
Object
否
业务方返回给智能客服的包体，包含了一个 map，key 是变量名，value 是变量值，会填充到 Session 中的对应变量中。




上一篇: 会话事件回调下一篇: 常见问题

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈