mode="webhook" 的可公開金鑰啟動時,ThunderPhone 會向你的
舊版 webhook URL
傳送一個阻塞式
telephony.incoming / web.incoming 請求,並最多等待 10 秒
以取得設定回應。使用此交換流程,為每通電話動態選擇提示、語音與工具——
如需端對端模式,請參閱動態通話設定指南。
已訂閱的 webhook 端點 也會收到
telephony.incoming / web.incoming——針對每一個來電與
網頁工作階段,無論是否已設定智慧體——但這些傳送皆為帶有 event_id
的即發即忘通知,絕不會阻塞。只有舊版單一 URL webhook 會承載本頁所述的
設定交換流程。端點通知格式請參閱
事件目錄。502/422 失敗)。請快速回應——當你進行判斷時,來電者會
聽到回鈴音。
請求酬載
電話通話(telephony.incoming):
網頁小工具工作階段(
web.incoming)的 data 會識別嵌入頁面,而非
電話號碼:
當已設定時,webhook 模式的小工具會將此請求傳送至可公開金鑰本身的
webhook_url,否則會改用組織層級的 webhook URL。無論哪種方式,
都會使用組織 webhook 的 secret 進行簽署。回應結構
回傳一個描述此次通話智慧體設定的 JSON 物件。prompt 與 voice 為必填欄位;其他欄位皆為選填。
未知的頂層鍵會被靜默忽略——拼錯的欄位名稱不會拒絕設定,
只是無法套用。此處不接受說話順序與
max_hold_seconds;
它們只能在智慧體本身設定。prompt 與 voice 為必填欄位,回傳 {} 或任何未通過驗證的
回應都會以 422 拒絕通話——此路徑沒有靜態智慧體備援機制(Webhook
模式中的號碼或金鑰沒有指派智慧體)。
回應大小限制
處理常式範例
搭配函式工具的回應
附加工具,讓 AI 能在對話途中呼叫你的 API:產品層級速查表
相關內容
telephony.complete / web.complete
非阻塞式的通話結束事件。
函式工具
tools[] 的完整 JSON 結構描述,以及已簽署端點合約。Webhook 端點
將多個 URL 訂閱至
telephony.incoming / web.incoming。動態通話設定
依來電者設定提示、工具與 A/B 測試的模式。
