Open in
核心概念
平台中所有項目的地圖——各個物件的用途、它在控制台中的位置,以及可與其互動的 API。
ThunderPhone 是一個用於建立、執行及改善 AI 語音智慧體的完整平台。本頁是導覽地圖:你將遇到的每個概念各有一個簡短章節,並附上對應的控制台介面與支援它的 API。先快速瀏覽一次,之後遇到需要釐清的術語時再回來查閱。
控制台側邊欄對應以下結構:
你的智慧體可使用的 應用程式、API、MCP 伺服器及 VoIP 供應商。
組織
組織是租戶單位。其他所有資源——智慧體、電話號碼、通話、金鑰——都只屬於一個組織。你的帳戶可以隸屬於多個組織;每個組織都有自己的餘額、金鑰及成員清單。
你在 組織 → 金鑰 下建立的 sk_live_ API 金鑰會綁定至一個組織。這項綁定讓 REST API 如此簡潔:你無須在 URL 路徑中加入組織 ID,因為金鑰已能識別組織。
控制台位置:組織切換器(側邊欄頁尾)及 組織設定——包含「我的帳戶」、「一般」、「金鑰」、「通知」、 「帳務設定」及「帳務紀錄」分頁。請參閱 組織設定參考。
API 中:/v1/orgs、
/v1/developer/api-keys。
智慧體
智慧體是執行通話的 AI 設定,包含:
- 一個提示詞,用於規範智慧體說什麼及如何行動—— 包括轉接、按鍵及掛斷等通話動作;這些都是一般提示詞內容,而非獨立設定。
- 一個引擎層級(
spark、bolt、storm-*):Spark 針對成本最佳化, Bolt 針對速度最佳化,Storm 則針對複雜提示詞的智慧表現最佳化。 - 一個語音,以及一個主要語言和可選的其他語言——當來電者切換語言時, 智慧體會自動切換。請參閱支援的語言。
- 已附加的功能:已連線應用程式、 API 連線、知識庫、 MCP 伺服器,以及內嵌的 函式工具。
- 行為調整選項:說話順序、確認模式、背景音軌、保留逾時。
在建立器中編輯時會自動儲存為草稿;只有在你點選 部署 後才會正式上線。每次部署都會儲存在建立器的 歷程 分頁中,因此你可以檢視及還原任何先前版本。
控制台位置:語音智慧體 → 智慧體建立器
(/dashboard/agents)。請參閱
建立第一個語音智慧體。
API 中:/v1/agents——CRUD、
複製、轉接、版本歷程及提示詞輔助工具。
聲音
聲音庫包含智慧體可使用的聲音、可播放的樣本、相容的語言、性別與口音分類,以及任何進階聲音/語言附加費。你可透過付費試聽功能,在選擇前合成自訂的 1–500 個字元片語。
符合資格的組織也可透過簡短的 WAV 或 MP3 樣本建立自訂聲音。自訂聲音設有配額與非同步建立狀態;準備完成後,會與聲音庫中的聲音一同顯示於智慧體選擇器中。
在控制台中: 聲音(/dashboard/voices)。請參閱
聲音庫與自訂聲音。
在 API 中: /v1/voices、
聲音樣本,以及
自訂聲音。
電話號碼
電話號碼隸屬於組織,並將撥入來電路由至智慧體(也可承載撥出通話)。來源有兩種:
- ThunderPhone 號碼 —— 從 ThunderPhone 的號碼池佈建的真實美國號碼,數秒內即可啟用,$1/月,另加每分鐘 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)——與 Slack、HubSpot、Salesforce、Google Calendar、Google Sheets 和 Cal.com 的 OAuth 連線。連線一次後,即可將每項操作工具(傳送 Slack 訊息、更新或建立 HubSpot 聯絡人、預約 Cal.com 時段……)切換啟用於 任一智慧體。請參閱連接應用程式。 - API(
/dashboard/api-connections)——將任何 HTTP API 轉換為 智慧體動作。貼上 cURL 指令,人工智慧精靈便會草擬工具定義;你也可以手動建立。測試請求按鈕會在你正式發布前發出沙盒呼叫。請參閱 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 秒。 沒有備援智慧體:若沒有可用的設定,電話通話將會結束,小工具工作階段將會失敗。 - 非阻塞事件是即發即忘的通知,會以指數退避方式重試——請參閱 傳送語意。
每個請求都會在 X-ThunderPhone-Signature-V2 中附帶含時間戳記的 HMAC-SHA256 簽章,以及僅涵蓋本文內容的舊版
X-ThunderPhone-Signature。請參閱
簽章驗證。
函式工具
函式工具是你的智慧體可在對話途中呼叫的 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」,它會根據這些文件回答、提供逐步點擊導覽以標示實際控制項,並可重新播放任何引導式導覽。這是找到本頁提及控制項最快的方式。請參閱詢問應用程式內智慧副手。