
项目 | 值 |
Method | POST |
Content-Type | application/json; charset=utf-8 |
目标地址 | 画布中配置的 pushUrl |
Header | 说明 |
Content-Type | application/json; charset=utf-8 |
X-TCCC-PUSH-UUID | 推送唯一标识,用于去重。同一次推送的重试会携带相同 UUID |
{"sessionId": "session-xxx","sdkAppId": 1400000000,"summary": "用户来电咨询退款问题,订单号 20240601001,已确认退款资格。","summaryError": "","messages": [{"timestampMs": 1718000001000,"role": "user","content": "您好,我要退款","roundId": "round-1","userId": "user-001"},{"timestampMs": 1718000002000,"role": "assistant","content": "好的,请提供您的订单号","roundId": "round-1"},{"timestampMs": 1718000003000,"role": "user","content": "20240601001","roundId": "round-2","userId": "user-001"},{"timestampMs": 1718000004000,"role": "assistant","content": "已查到您的订单,正在为您转接人工客服","roundId": "round-2"}],"variables": {"orderNo": "20240601001","customerName": "张三","refundReason": "商品质量问题"},"timestamp": 1718000005000}
字段 | 类型 | 说明 |
sessionId | string | 会话 ID |
sdkAppId | number | 应用 ID |
summary | string | 通话总结文本。未启用或生成失败时为空 |
summaryError | string | 总结生成失败时的错误信息 |
messages | array | 对话记录列表(结构同 S2C 的 messages,见第三节) |
variables | object | 变量键值对 |
timestamp | number | 推送时间戳(毫秒级 Unix 时间戳) |
summary 非空表示总结生成成功;summaryError 非空表示生成失败;两者都为空表示未启用总结ErrCode 为 0表示接收成功,非零 ErrCode 或非 JSON 响应将触发重试。{"ErrCode": 0,"ErrMsg": "success"}
项目 | 值 |
最大重试次数 | 3 次 |
重试间隔 | 指数退避:1s → 2s → 4s |
超时时间 | 单次请求 5 秒 |
去重标识 | X-TCCC-PUSH-UUID(重试时保持不变) |
类型 | pushAuthType 值 | 说明 |
无鉴权 | 不填 或 "nil" | 不添加鉴权头 |
BasicAuth | "basic" | 请求头添加 Authorization: Basic base64(username:password) |
OAuth2 | "oauth2" | 使用客户端凭证模式换取 access_token,请求头添加 Authorization: Bearer <token> |
节点 | 用途 |
核心交互单元 — 播放话术、听取用户回复、分类回复并分支。 | |
在通话过程中与外部系统交换数据(例如查询订单、回写结果)。 | |
在流程中显式写入或更新变量(设置默认值、推导值、规范化槽位)。 | |
基于变量值使用比较运算符进行分支 — 通用化的 if / else if / else 逻辑。 | |
按日期、时间和时区分支(例如工作时间或非工作时间)。 | |
收集数字按键(0–9、 *、#)— 适用于菜单式 IVR 分支、验证码/PIN 输入或数字采集。 | |
将通话转接至人工座席技能组。 | |
将通话转接至其他智能体(对话流或自有模型),保留对话历史和变量。 | |
可以选择结束语终止通话。 |
文档反馈