- **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 存取相同資料,用於回填/重播。
