Skip to main content
每次通话结束后都会触发一个完成事件——无论是呼入电话、 呼出电话、网页通话还是测试通话(构建器麦克风会话)。该事件为 非阻塞式:返回任意 2xx 即可。 事件会通过以下两种路径发送:
  • **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 访问相同数据,用于回填或重放。