Skip to main content
一筆通話代表針對單一聯絡人立即執行的非同步 AI 語音工作。POST /calls 在工作持久加入佇列後傳回 202 Accepted,不會等待開始撥號或完成。

立即非同步執行

請求會選取一個符合資格的 agent_id,以及一個既有聯絡人或內嵌收話人資料。請求無法選擇排程時間;如需排程開始時間或撥號時段,請使用批次撥號;如需更複雜的時間控制,請使用由儀表板管理的自動化。 容量限制可能讓已接受的通話保持 queued。請使用 API 資源的 id 查詢通話,直到 status 進入終止狀態。

生命週期與接聽分類

status 說明執行為排隊中、進行中、已結束、失敗或取消。answer_status 則獨立將目的端分類為 answeredno_answerbusyvoicemailunknown 因此,正常的 no_answerbusyvoicemail 結果仍可搭配 status: completedfailed 僅用於服務無法安全執行的情況。完整模型請參閱狀態生命週期

API 純量結果

通話 API 資源只包含文件列出的純量欄位: 請將 ID 視為不透明值;結果欄位在適用前可能不會出現。 如需具有修訂版本的通話後內容,請分別輪詢摘要與逐字稿。終止狀態及游標固定分頁方式請參閱取得通話結果

取消

POST /calls/{call_id}/cancel 採盡力而為且具冪等性。若取消及早勝出,會阻止後續派送;若工作已啟動,則要求終止。完成競態仍可能讓最終 status 成為 completed;重複取消會傳回目前的通話資源,不會建立另一個動作。