一、操作说明
进入已创建的流程画布,依次点击画布上的开始通话 > + > 转接人工 > 转接外线,在弹窗中填写以下配置项:
二、节点名称
填写节点名称,例如“转接合作方热线”。
三、外线号码
必填项。接听本次转接的外部电话号码。支持固定号码或变量。
四、主叫号码
必填项。发起外呼时对外显示的主叫号码,从下拉列表中选择已接入的号码。
五、转接设置
·转接成功设置:可设置开始转接提示文案、等待过程播放的音频、转接成功提示文案。
·转接失败设置:当外线无人接听或转接信息配置错误会导致转接失败,可配置对应的转接失败提示文案。
·转接超时设置:可设置等待时间,等待超过此设置时间会播放等待超时提示音和提示文案,放音结束后客户可以按任意键继续等待或按#键退出等待。
六、携带信息设置
转接时把 AI 阶段积累的上下文一并推送给外部平台,接收方无需让客户重复描述。需先勾选对应项,转接时才会携带该信息:
·携带通话总结:转接时实时调用大模型生成本次通话摘要,帮助接待方快速了解客户诉求。
·携带变量信息:把流程中已采集/赋值的变量(例如客户名称、订单号、车型)传递给接收方,可选全部变量或指定变量。
·携带完整对话记录:把 AI 与用户的逐轮对话(含角色、时间)同步给接收方。
七、第三方平台推送接口规范
转接到外线/第三方时,接收方是客户自有平台,TCCC 会把上述上下文以 HTTP POST 推送到你配置的推送地址(JSON 格式,地址支持变量)。
·请求方式
| 项目 | 值 |
| Method | POST |
| Content-Type | application/json; charset=utf-8 |
| 目标地址 | 画布中配置的 pushUrl |
·请求头
| Header | 说明 |
| Content-Type | application/json; charset=utf-8 |
| X-TCCC-PUSH-UUID | 推送唯一标识,用于去重。同一次推送的重试会携带相同 UUID |
·请求体 JSON 格式
{ "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 非空表示生成失败;两者都为空表示未启用总结
·响应要求:接收端需返回 JSON 格式响应,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 输入或数字采集。 |
| 转接人工 | 将通话转接至人工座席技能组。 |
| 转接智能体 | 将通话转接至其他智能体(对话流或自有模型),保留对话历史和变量。 |
| 结束通话 | 可以选择结束语终止通话。 |
九、相关指引
请根据你的搭建方式选择对应路径:
·第一次使用?五分钟即可上线一个可用的智能体 —— 创建对话流程。
·想了解我们的对话流节点?请前往 对话节点。
·为你的对话流搭建知识库?请前往 搭建你的知识库。
·如何测试你的模型?请参阅 测试对话工作流。
·想查看应用场景?试试 语音通知、线索挖掘、反馈收集 或 客户支持。
·如何进行 AI 智能体的呼出与呼入电话?请参阅 智能体外呼 或 智能体呼入。
·查看数据日志?请参阅 通话记录、通话录音、延迟。
·如何创建和查看通话后标签?请参阅 话后标签(通过 AI 分析洞察创建)。