ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Getting Started

核心概念

平台各項功能的全貌——每個物件的作用、在控制台中的位置,以及會透過哪個 API 存取。

ThunderPhone 是一個用於建立、運行及改進 AI 語音智能體的完整平台。本頁是概覽地圖:你將會遇到的每個概念均設有簡短章節,並列出控制台介面及支援它的 API。先快速瀏覽一次,日後遇到需要釐清的術語時可隨時回來參考。

舊版控制台檢視的側邊欄沿用此結構:

互動
連接
品質及測試
事件處理

供你自行編寫程式碼使用的 Webhook 及 函數工具。


組織

組織是租戶管理的基本單位。所有其他資源——智能體、電話號碼、通話及金鑰——均只屬於一個組織。你的帳戶可屬於多個組織;每個組織均有獨立餘額、金鑰及成員名單。

你在 整合 → API 金鑰 下建立的 sk_live_ API 金鑰 (組織選單;舊版檢視中為 組織 → 金鑰)會 綁定至一個組織。正因為這項綁定,REST API 才能如此精簡: 你毋須在 URL 路徑中加入組織 ID,因為你的金鑰已經識別該組織。

控制台:組織切換器(側邊欄底部)及 組織設定——包括「我的帳戶」、「一般」、「金鑰」、「通知」、 「帳單設定」及「帳單記錄」標籤頁。請參閱 組織設定參考。

API: /v1/orgs、 /v1/developer/api-keys。


智能體

智能體是在通話中運行的 AI 設定,當中包括:

  • 一個規管智能體說話內容及行為方式的 提示詞 —— 包括轉駁、按鍵及掛線等通話操作;這些均為一般提示詞指令,而非獨立設定。
  • 其 設定:智能程度(Core 或 Pro)、聆聽能力(Lite、Standard、Plus 或 Max)及回覆速度,當中需在成本、速度及準確度之間取捨。
  • 一個 聲音,以及一種 主要語言 和可選的 附加語言 —— 當來電者轉換語言時,智能體會自動切換。請參閱支援的語言。
  • 已連接的功能:已連接應用程式、API 連接、知識庫、MCP 伺服器,以及內嵌的函數工具。
  • 行為控制項:說話次序、確認模式、背景音軌、保留逾時。

你在建構器中的修改會自動儲存為草稿;在按下發佈前,不會正式生效。每次發佈均會儲存至建構器的歷史紀錄標籤頁,你可檢視及還原任何先前版本。

控制台:語音智能體 → 智能體建構器 (/dashboard/agents)。請參閱 建立你的第一個語音智能體。

API: /v1/agents——CRUD、 複製、轉接、版本記錄及提示詞輔助功能。


語音

語音庫包含智能體可使用的語音、可播放的 樣本、相容語言、性別及口音分類,以及哪些語音屬於進階版本。付費試聽功能讓你可在選擇前,合成自訂的 1–500 字元短句。

符合資格的機構亦可透過短 WAV 或 MP3 樣本建立自訂語音。自訂語音設有配額及非同步建立狀態;準備就緒後,會與語音庫語音一同顯示於智能體選擇器中。

控制台: 語音(/dashboard/voices)。請參閱 語音庫及自訂語音。

API: /v1/voices、 語音樣本及 自訂語音。


電話號碼

電話號碼屬於某個機構,並會將來電路由至智能體(亦可用作撥出電話)。來源有兩種:

  • ThunderPhone 號碼 —— 由 ThunderPhone 號碼庫提供的真實美國號碼,數秒內即可啟用,$1/月;其通話 分鐘數按電話線路收費。初始僅支援來電。機構管理員可在「電話號碼」頁面申請 撥出通話;ThunderPhone 會人手審核每項 申請,獲批號碼即可撥打電話及執行活動。 每個機構預設最多可持有 25 個號碼。
  • VoIP 號碼 —— 透過 VoIP 連線從你的服務供應商匯入。Twilio 和 Telnyx 可使用 API 金鑰直接連線 (Telnyx 亦提供新帳戶設定指引); SignalWire、Vonage、Plivo 及任何其他 SIP 中繼線路則透過 SIP 設定連線,即人手設定 SIP。完成匯入及驗證後,VoIP 號碼支援來電及撥出通話。

每個號碼列均可讓你設定路由模式、選擇接聽來電的智能體, 並為號碼加入標籤。

控制台: 電話號碼(/dashboard/phone-numbers)。 請參閱取得電話號碼。

API: /v1/phone-numbers、 /v1/voip-connections、 /v1/phone-number-labels。


通話

每一通來電、撥出電話、模擬通話及小工具工作階段 都會成為一筆通話記錄。通話記錄包括完整的角色標示逐字稿、 結構化輪次歷史記錄(包括工具呼叫)、錄音、 計費總額,以及可選用的 AI 評分及問題報告。

通話處於進行中狀態時,你可開啟通話並旁聽——你會以 靜音方式加入,通話中的任何人都不會聽到你。開始旁聽後,你可 使用悄聲指示:在通話期間輸入直接傳送至智能體的指令; 來電者不會聽到,智能體會即時遵從指令。

控制台: 通話記錄(/dashboard/call-history)可查看 封存記錄及個別通話詳情;即時則顯示進行中的通話。請參閱 檢視、旁聽及指導你的通話。

API: /v1/calls——列出、逐字稿、 歷史記錄、音訊、評分、匯出; /v1/issue-reports。


客戶入口網站

客戶入口網站是為外部客戶而設、附有品牌元素的唯讀通話記錄檢視頁面。 機構管理員可選擇要顯示其通話記錄的智能體、加入已核准的 檢視者電郵地址、上載標誌及主題色,並可選擇驗證自訂 網域。入口網站檢視者無需取得控制台存取權,亦可查看通話詳情、 逐字稿及可用錄音。

控制台: 客戶入口網站(/dashboard/client-portals)。請參閱 客戶入口網站。

API: /v1/client-portals 用於 管理員管理介面。


網頁小工具

網頁小工具讓你網站訪客透過咪高峰與智能體對話——無需電話號碼。它使用可公開金鑰(pk_live_...)進行驗證,瀏覽器只可從你允許的網域使用,因此可安全用於用戶端程式碼。網域清單並非驗證機制,而網頁可傳送的工作階段設定預設為關閉,直至你在金鑰上允許為止。

金鑰可在以下兩種模式之一運作:agent(靜態綁定至單一智能體) 或 webhook(你的伺服器按每位訪客選擇設定——請參閱 每通電話的動態設定)。小工具工作階段會使用與電話通話相同的通話基礎架構。

在控制台中: 網頁小工具(/dashboard/web-widgets)—— 建立小工具、設定模式及智能體、管理允許的網域,並複製嵌入程式碼片段。請參閱 建立網頁小工具。

在 API 中: /v1/publishable-key、 /v1/mic-session,以及 Widget SDK 文件。


知識庫

知識庫是一組可讓你的智能體在通話期間搜尋、為回答提供依據的文件——你可上載檔案、貼上文字,或透過 URL 匯入網頁,然後在建立工具中將知識庫附加至智能體。智能體會在對話需要時,透過內置搜尋工具查詢知識庫。

如果文件匯入失敗,你可以重試。至於網頁文件,你亦可以重新整理頁面以再次擷取內容。如果你刪除知識庫,其文件將會保留,並會與該知識庫解除關聯。曾使用該知識庫的智能體將無法再存取這些文件,除非你直接將文件附加至智能體。

在控制台中: 使用 知識庫(/dashboard/knowledge)管理文件庫;在建立工具的 知識庫 區段將知識庫附加至智能體。請參閱 為你的智能體建立知識庫。


連接

連接讓智能體可與外部世界互通。四種類型,集中於一個側邊欄群組:

  • 應用程式 (/dashboard/app-connections) —— 連接 HubSpot、Salesforce、Google Calendar、Google Sheets 與 Cal.com。只需連接一次,然後即可為任何智能體啟用或停用各項操作工具(新增或更新 HubSpot 聯絡人、預約 Cal.com 時段……)。請參閱連接應用程式。
  • APIs (/dashboard/api-connections) —— 將任何 HTTP API 轉換為智能體動作。貼上 cURL 指令後,AI 精靈會草擬工具定義;你亦可手動建立。部署前,可按一下 測試請求 按鈕發出沙盒呼叫。請參閱API 連接——即 /v1/integrations 的控制台介面。
  • MCP (/dashboard/mcp-connections) —— 透過 URL 新增 Model Context Protocol 伺服器,讓智能體使用其提供的工具。請參閱新增 MCP 伺服器。
  • VoIP (/dashboard/voip-connections) —— 用於自備電話號碼的服務供應商憑證。請參閱連接 VoIP 服務供應商。

ThunderPhone 亦提供自己的 MCP 端點,讓外部 MCP 用戶端可列出智能體、查看通話及逐字稿,並撥打電話。請參閱 將 ThunderPhone 用作 MCP 伺服器。

在 API 中: /v1/integrations、 /v1/mcp-servers,以及 /v1/voip-connections;亦請參閱 建立工具整合。


外撥活動

外撥活動可大規模撥打外撥電話:上載聯絡人 CSV、選擇智能體及外撥顯示號碼,並設定撥打時段(日期和時間,支援時區)、並行數量及重試政策(最多嘗試次數,以及哪些結果——無人接聽、留言信箱、失敗——需要重試)。活動會依序處理名單,並在通話記錄中記錄每一通電話。

在控制台中: 外撥活動(/dashboard/campaigns)。請參閱 執行外撥電話活動。

如需一次性以程式撥打電話: 使用 外撥電話 API。

即時監察

即時顯示整個機構所有進行中的通話,並讓你開啟任何一通, 以便即時旁聽及耳語指導。這是監督介面:你可以觀察新提示首次處理真實流量,或持續監察進行中的活動。

控制台內: 即時(/dashboard/live)。參閱 觀看及監督即時通話。


模擬

模擬是由 AI 來電者與你的智能體進行真實對話——採用相同的電話路徑、真實逐字稿及真實評分——讓你可在發布前(及發布後)進行測試。你可指定智能體或電話號碼,自行撰寫來電者情境,或根據智能體的提示使用 AI 產生情境(如有需要,亦可包括邊緣案例),並即時觀看通話。

情境會歸類為套件,設定最低通過率,並可在 CI 中作為發布閘門;系統會按每個情境報告相對於已接受基準的回歸問題。

控制台內: 模擬(/dashboard/simulations),以及智能體建立器中的 模擬 按鈕。參閱 模擬通話。

API 內: /v1/test-calls 及 套件執行器——參閱端對端測試智能體。


驗證集

驗證集會將真實通話片段轉化為可重複執行的單輪回歸檢查。每個範例都會固定對話內容、相關來電者音訊、原始回應及預期行為。重播會針對目前的智能體草稿執行,無需再次撥打電話;而發布對話框亦可顯示最新執行結果是否仍符合該草稿。

控制台內: 用於機構資料集的 驗證集(/dashboard/validation),以及智能體建立器中用於執行結果的 驗證 分頁。參閱 驗證集。

API 內: /v1/validation-sets 及 同一參考頁面上的智能體/範例重播端點。


實驗

實驗可在真實流量上對智能體設定進行 A/B 測試: 定義不同變體(不同提示、引擎或設定)、在變體之間分配 流量,並比較各變體的結果。使用此功能,無需在 webhook 中自行建立分流邏輯。

控制台內: 實驗(/dashboard/experiments)及 智能體建立器中的 A/B 分頁。參閱 實驗(A/B 測試)。


問題

問題是針對特定通話而標記的問題——可由人工審核人員提交, 或由 AI 評分偵測。問題包含嚴重程度、來源及狀態,而「問題」頁面就是分類處理佇列:你可篩選、檢查有問題的通話,並追蹤修正進度。

控制台內: 問題(/dashboard/issues),以及通話記錄中的逐通話標記功能。參閱問題分類處理。

API 內: /v1/issue-reports。


報告

報告會根據你的通話資料回答自然語言問題 (「上星期來電者要求真人協助的三個最主要原因是甚麼?」),並提供由 AI 撰寫的分析;範圍可限於你選擇的智能體及日期區間。

控制台內: 報告(/dashboard/reports)。參閱 報告。


可觀測性

可觀測性是指標介面:通話量、結果及隨時間變化的 質素,可按智能體及時間範圍篩選,並可匯出作後續分析。

控制台內: 可觀測性(/dashboard/observability)。 參閱可觀測性。


警示

警示規則會在一段時間內監察指標(成功率、失敗率、 平均分數、通話量、套件回歸),並在超出你設定的閾值時觸發。通知會發送至電郵及 Slack,並向你的 webhook 端點觸發 alert.triggered 事件。

控制台內: 機構 → 警示。參閱 警示。


Webhook

當通話期間及結束後發生事件時,ThunderPhone 會向你的伺服器發送 HTTP POST webhook。支援兩種傳送模式:

  • Webhook 端點(建議):透過 /v1/developer/webhook-endpoints 管理多個 URL,並為每個端點設定專屬密鑰及事件訂閱。
  • 舊版單一 URL webhook:每個組織一個 URL。可於 /v1/webhook 或 組織 → 一般 中管理。此功能保留以支援向後相容。

事件分為兩類:

  • 阻塞事件預期你的伺服器回傳設定, 以塑造進行中的通話——即 來電事件 (telephony.incoming / web.incoming)。電話通話最多會等待 13 秒,包括一次重試;而小工具工作階段則會等待 10 秒。 系統不設後備智能體:如沒有可用設定,電話通話會結束,而小工具工作階段會失敗。
  • 非阻塞事件屬於即發即棄的通知,並會以 指數退避方式重試——請參閱 傳送語義。

每個請求都會附帶含時間戳記的 HMAC-SHA256 簽章,位於 X-ThunderPhone-Signature-V2,另加僅涵蓋本文內容的舊版 X-ThunderPhone-Signature。請參閱 簽章驗證。


函式工具

函式工具 是你的智能體可在對話途中呼叫的 HTTP 端點。你向 ThunderPhone 提供 OpenAI 風格的函式綱要及端點 URL;智能體會決定何時呼叫,ThunderPhone 則會從其伺服器發出已簽名的 HTTP 請求,並將結果交回智能體。

智能體亦提供 內置通話功能——轉駁通話、傳送按鍵(DTMF)輸入、結束通話及保持等候——你可透過簡單的提示詞行啟用,而無需定義工具。

在控制台中: 建立工具的 API 連接 區段(請參閱 連接)。

在 API 中: /v1/integrations 及 函式工具規格。


團隊及角色

每個組織均設有成員名單,並分為兩種角色:成員 負責建立及營運智能體;管理員 則同時管理團隊及帳單。你可透過電郵邀請成員——邀請會於 7 日後失效,亦可撤銷;在成員列的 ⋯ 選單中可更改角色或移除成員。你可為整個組織設定單一登入——請參閱 SSO。

在控制台中: 組織 → 一般。請參閱 邀請你的團隊。

在 API 中: /v1/members, /v1/invites。


帳單

ThunderPhone 採用預繳模式。每個組織均設有美元餘額;每通電話會按各組件於供應商的標價扣除費用,另加基礎設施費用及 17–25% 利潤率(參閱定價)。當餘額歸零,系統會拒絕接聽來電,而撥出電話則會傳回 402 Payment Required。

你可手動增值,或啟用 自動增值,設定餘額門檻、補充金額及可選的每月支出上限——確保通話不會在句子中途終止。

在控制台中: 組織 → 帳單設定 及 帳單記錄。請參閱 增值及啟用自動增值,以及 完整定價參考。

在 API 中: /v1/billing。


應用程式內助理

控制台提供內置 助理——向它詢問「我如何完成 X」,它會根據這些文件作答、提供逐步點擊導覽以標示實際控制項,並可重新播放任何導覽行程。這是尋找本頁提及控制項的最快方法。請參閱 詢問應用程式內助理。


整合各項功能