Skip to main content
本指南將帶你完成四個 REST 呼叫,讓 AI 語音智慧體接聽你的第一通電話。
你需要一個 ThunderPhone 帳戶。 註冊免費,不到一分鐘即可完成。偏好點擊操作而非使用 curl? 控制台快速入門 可讓你在不寫任何程式碼的情況下 完成同樣的第一通電話。

步驟 1:取得 API 金鑰

1

登入

2

前往金鑰

在控制台中前往 組織 → 金鑰
3

建立金鑰

點擊 建立金鑰、為金鑰命名,然後複製 sk_live_... 值。原始金鑰只會顯示一次——請立即將其儲存至 你的密鑰管理工具。
遇到問題?建立伺服器 API 金鑰會逐步詳細說明 此流程,而應用程式內的輔助工具可即時為你標示每個控制項。
在本指南中,請將 sk_live_YOUR_API_KEY 替換為你剛複製的值。 金鑰會自動識別你的組織,因此你無需在 URL 中加入組織 ID。

步驟 2:建立智慧體

智慧體定義 AI 如何處理對話——包括提示、語音、產品方案、工具, 以及小工具使用資格。
產品方案:spark 針對成本最佳化,bolt 針對速度最佳化, storm-base / storm-extra 則針對複雜提示提供更高的智慧處理能力。請參閱 智慧體 以取得完整比較。

步驟 3:佈建電話號碼

此呼叫會向 ThunderPhone 的示範號碼池索取一個號碼,並將你的新智慧體指派為來電處理程式。(若要從 VoIP 服務供應商帶入自己的號碼,請改閱 VoIP 連線。)
你的新號碼一開始會處於 status="provisioning",並在幾秒內轉為 active;當你掛斷瀏覽器時,該號碼已可接聽來電。

步驟 4(選用):設定 Webhook

如需即時事件(動態通話路由、通話後處理),請新增 Webhook 端點。僅訂閱你需要的事件。
回應中包含一次性 secret——請將其複製到你的密鑰管理工具。使用此密鑰驗證傳入請求的 X-ThunderPhone-Signature 標頭(請參閱 Webhook 概覽)。

步驟 5:測試你的智慧體

撥打你剛佈建的號碼。智慧體會接聽、自我介紹,並依照你的提示執行。 在通話結束後檢查通話:
深入檢視特定通話,以取得逐字稿和錄音 URL:

後續步驟

新增函式工具

讓你的智慧體在通話期間呼叫你的 API。

撥打外撥電話

從自己的程式碼觸發通話。

處理 Webhook

即時回應通話事件。

完整 API 參考文件

記錄所有公開端點。