立即開始

核心概念

ThunderPhone 是一個用於建立、運行及持續改進 AI 語音智能體的完整平台。本頁是你的導覽地圖：涵蓋你將會遇到的每個概念，每個概念均有簡短章節，並說明相關的控制台介面及其支援 API。先快速瀏覽一次，日後需要了解某個術語時再回來查閱。

控制台側邊欄亦依照此結構編排：

核心

智能體、語音、電話號碼、 網頁小工具、通話、 客戶入口網站、知識庫。

互動

即時監控及對外 推廣活動。

連接

你的智能體可使用的應用程式、API、MCP 伺服器及 VoIP 供應商。

品質與測試

模擬、驗證集、 實驗、 問題、報告、 可觀測性。

組織

團隊與角色、API 金鑰、 警示、計費。

事件

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

組織

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

你在 組織 → 金鑰 下建立的 sk_live_ API 金鑰，會綁定至一個組織。這項綁定令 REST API 的結構保持扁平：你毋須在 URL 路徑中加入組織 ID，因為你的金鑰已可識別所屬組織。

在控制台中：組織切換器（側邊欄底部）及組織設定——包括「我的帳戶」、「一般」、「金鑰」、「警示」、「計費設定」及「計費記錄」分頁。請參閱組織設定參考資料。

在 API 中：/v1/orgs、 /v1/developer/api-keys。

智能體

智能體是負責運行通話的 AI 設定，當中包括：

你在建立工具中作出的修改會自動儲存為草稿；在你按下發布前，任何修改均不會生效。每次發布均會在建立工具的歷史紀錄分頁中建立快照，讓你可檢視及還原任何舊版本。

**在控制台中：**語音智能體 → 智能體建立工具 (/dashboard/agents)。請參閱 建立你的第一個語音智能體。

在 API 中：/v1/agents——CRUD、 複製、轉接、版本記錄及提示詞輔助工具。

語音

語音庫包括智能體可使用的語音、可播放的示範音檔、支援的語言、性別及口音分類，以及任何高級語音／語言附加費。你可使用付費試聽功能，在選擇前合成自訂的 1–500 個字元短句。

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

在控制台中： 語音（/dashboard/voices）。請參閱 語音庫與自訂語音。

在 API 中： /v1/voices、 語音樣本及 自訂語音。

電話號碼

電話號碼屬於某個組織，並會將來電路由至智能體（亦可用於外撥通話）。來源有兩種：

每個號碼列均可讓你設定路由模式、選擇來電智能體，以及為號碼加上標籤。

在控制台中： 電話號碼（/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）用於文件庫；建構器中的 知識庫 部分用於將知識庫連接至智能體。請參閱 為智能體建立知識庫。

連接

連接讓智能體可連接至外部服務。四種類型，集中於一個側邊欄群組：

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 事件。

控制台內： 組織 → 提示。參閱 提示。

Webhooks

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

事件分為兩類：

每個請求均會在 X-ThunderPhone-Signature 內附帶 HMAC-SHA256 簽名。請參閱 簽名驗證。

函數工具

函數工具 是你的智能體可於對話中途呼叫的 HTTP 端點。你只需向 ThunderPhone 提供 OpenAI 風格的函數架構及端點 URL；智能體會決定何時呼叫，ThunderPhone 則會從其伺服器發出已簽名的 HTTP 請求，並將結果交回智能體。

智能體亦提供內建通話功能——轉駁通話、傳送鍵盤（DTMF）輸入、結束通話及保留等候——你可透過簡單的提示文字行啟用，而毋須定義工具。

在控制台中： 建立工具的 API 連接 區段（請參閱 連接）。

在 API 中： /v1/integrations 及 函數工具規格。

團隊及角色

每個機構均有成員名單，並設有兩種角色：成員 可建立及操作智能體；管理員 亦可管理團隊及帳單。 可透過電郵邀請成員——邀請會在 7 日後到期，亦可撤銷；成員列中的 ⋯ 選單可用於更改角色或移除成員。你可為整個機構設定單一登入——請參閱 SSO。

在控制台中： 機構 → 一般。請參閱 邀請你的團隊。

在 API 中： /v1/members， /v1/invites。

帳單

ThunderPhone 採用預繳模式。每個機構均設有美元餘額；通話會按智能體的每分鐘費率從餘額扣除費用（引擎級別加上附加費——當你變更設定時，建立工具會即時顯示全包費率，而 指定附加語言 每分鐘增加 3¢）。當餘額降至零，系統會拒絕接聽來電，而撥出電話會傳回 402 Payment Required。

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

在控制台中： 機構 → 帳單設定 及 帳單記錄。請參閱 新增資金並啟用自動增值，以及 完整定價參考。

在 API 中： /v1/billing。

應用程式內協作助手

控制台內置 協作助手——向它詢問「如何執行 X」，它會根據這些文件提供答案、提供逐步操作導覽以聚焦實際控制項，並可重新啟動任何導覽行程。這是尋找本頁提及控制項的最快方法。 請參閱 詢問應用程式內協作助手。

整合各項功能

控制台快速入門

五個步驟的精靈：智能體 → 付款 → 號碼 → 模擬 → 檢閱。

API 快速入門

透過四個 REST 呼叫完成相同的首個通話。

使用控制台

建立智能體、儲值、取得號碼、模擬及檢閱通話。

連接工具及資料

OAuth 應用程式、自訂 API、MCP 伺服器及 VoIP 供應商。

分析及改善

報告、可觀測性、實驗、問題及警示。

團隊及帳戶

邀請及角色、API 金鑰、安全性及 SSO。

開發人員食譜

API 範例：來電、撥出電話、動態設定、工具及測試。

驗證 Webhook 簽名

一次正確完成 HMAC 檢查，隨處重複使用。