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(回合結構與上述相同)。
  • 欄位集合為原始通話結束報告,可能包含上表以外的額外內部欄位——請將未知欄位視為參考資訊。
  • 網頁通話(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 存取相同資料,用於回填/重播。