Skip to main content
對外撥號可讓你將目標號碼和智慧體設定交給 ThunderPhone，由人工智慧代表你撥打電話。常見使用情境：
  • 預約確認
  • 問卷回撥
  • 未接來電後的「第二次」追蹤
  • 調度式通知
要撥打整份名單嗎？控制台的 行銷活動 功能 （/dashboard/campaigns）可接收聯絡人的 CSV，並為你處理 依時區設定的撥號時段、併發數與重試政策。本指南涵蓋單次程式化撥號。

​
先決條件

1

準備 VoIP 號碼

對外撥號要求你透過 VoIP 連線擁有 from_number。 示範號碼僅限撥入。請參閱 自備號碼。
2

建立智慧體

偏向對外撥號的提示詞通常會先讓智慧體說明自己的身分與目的——「嗨，這裡是 Acme，來電是為了確認你明天下午 3 點的預約……」。將 outbound_speak_order 設為 agent_first（預設值）。
3

維持正餘額

餘額 ≤ $0.00 時，對外撥號會回傳 402 Payment Required。透過 POST /v1/billing/top-up 儲值，或啟用自動儲值。

​
使用已儲存的智慧體撥打電話

最簡單的方式——透過 ID 參照智慧體：
回應：
status: "initiated" 僅表示請求已被接受——通話 尚未接通。輪詢 GET /v1/calls/{call_id} 以取得即時狀態（in_progress → completed / failed）。

​
使用內嵌設定撥打電話

如果你需要一次性提示詞，不值得將它儲存為智慧體， 請改為傳入 config。其結構與 call.incoming webhook的回應結構描述相同：

​
追蹤通話

同時訂閱 telephony.complete webhook—— 這是得知通話已結束最快的方式。如果你無法接收撥入 webhook， 請每隔幾秒輪詢 GET /v1/calls/{call_id}；通話結束後，紀錄會包含 end_reason、duration_seconds 和錄音 URL。

​
值得處理的失敗情境

​
控制保留時間

若因被叫方回應緩慢（IVR 樹、佇列）而導致撥出通話時間過長，可使用 max_hold_seconds 設定上限：
若過去 N 秒內未收到任何真人語音，智慧體會掛斷通話。預設值為 900（15 分鐘）。

​
後續步驟

撥出通話參考資料

所有請求欄位與錯誤代碼。

接收 call.complete

將已完成的撥出通話串流至你的系統。

帳務

自動儲值，避免撥出通話因餘額不足而失敗。

測試撥出智慧體

在正式上線前，先進行撥出智慧體的模擬測試。