- **Webhook 端点**会接收
telephony.complete(电话通话)或web.complete(网页通话和 构建器麦克风测试通话),其中包含下文记录的稳定负载、 每次投递对应的event_id、30 秒超时,以及 最长 24 小时的重试。 - 旧版单 URL webhook 会进行一次同步尝试(10 秒超时,不重试),其负载略有不同——请参阅 旧版负载差异。
请求负载(端点投递)
结束原因
转录格式
transcripts 中的每个条目代表一个对话轮次。角色包括
user(来电者语音)、model(智能体语音以及工具调用)、
tool(工具结果)和 system(语言切换等通话事件)。
如需获取完整结构化轮次历史记录(包括打断标记、确认提示和原始位置),请使用
GET /v1/calls/{call_id}/history。
旧版负载差异
旧版单 URL webhook 信封为{"type": "telephony.complete" | "web.complete", "data": {…}},且
不包含 event_id;其 data 与端点负载不同:
- 轮次数组位于
history下,而非transcripts(轮次架构与上文相同)。 - 字段集合为原始通话结束报告,可能包含上表之外的其他内部字段——将未知字段视为信息性字段。
- Web 通话(
direction: "web")不包含from_number/to_number, 并会添加origin_domain。 - Builder 麦克风测试通话会在旧版路径上报告为
telephony.complete(端点系统会将其映射为web.complete)。 - **转接协调:**当通话以转接结束时,旧版 webhook 会被同步调用,并且可能返回
{"transfer_ready": false},以表示转接目标尚未就绪。任何其他响应(或未配置旧版 webhook)都会让转接继续进行。端点投递不会就此进行查询。
处理程序示例
常见用例
CRM 集成
将每通电话的转写文本和录音 URL 与您的客户记录一同保存。
分析
将转写文本流式传输至处理管道,用于主题建模、CSAT 信号提取或转接率监控。
质量审核
在 QA 工具中打开通话以供人工审核,或通过您自己的评估模型进行评估。
通知
在发生转接或失败时通知人工团队成员。
相关内容
telephony.incoming / web.incoming
在通话开始时运行的阻塞式对应事件。
事件目录
您可以订阅的其他事件类型。
通话记录 API
可通过 REST 访问相同数据,用于回填或重放。