連線
你的智慧體可使用的 應用程式、API、MCP 伺服器及 VoIP 供應商。
組織
組織是租戶單位。其他所有資源——智慧體、電話號碼、通話、金鑰——都恰好屬於一個組織。你的帳號可以隸屬於多個組織；每個組織都有各自的餘額、金鑰及成員清單。 你在 組織 → 金鑰 下建立的sk_live_ API 金鑰會繫結至一個組織。這項繫結讓 REST API 保持扁平：你無須在 URL 路徑中加入組織 ID，因為你的金鑰已能識別該組織。
**在控制台中：**組織切換器（側邊欄頁尾）及
組織設定——包含「我的帳號」、「一般」、「金鑰」、「警示」、
「帳務設定」及「帳務紀錄」分頁。請參閱
組織設定參考資料。
在 API 中：/v1/orgs、
/v1/developer/api-keys。
智慧體
智慧體是執行通話的人工智慧設定。它整合了：- 用於規範智慧體說什麼及如何行為的提示—— 包括轉接、按鍵及掛斷等通話動作；這些都是一般提示文字，而非獨立設定。
- 引擎層級（
spark、bolt、storm-*）：Spark 專為成本最佳化， Bolt 專為速度最佳化，Storm 則為處理複雜提示時的智慧能力而設計。 - 語音、主要語言及可選的其他語言——當來電者變更 語言時，智慧體會自動切換。請參閱支援的語言。
- 已附加的功能：已連線應用程式、 API 連線、知識庫、 MCP 伺服器，以及內嵌的 函式工具。
- 行為設定：發言順序、確認模式、背景音軌、 保留逾時時間。
/dashboard/agents)。請參閱
建立你的第一個語音智慧體。
在 API 中：/v1/agents——CRUD、
複製、轉接、版本歷程及提示輔助工具。
語音
語音庫包含智慧體可使用的語音、可播放的 範例、相容語言、性別與口音分類，以及任何進階語音／語言附加費。你可以透過付費試聽工具，在選擇前合成自己的 1–500 字元片語。 符合資格的組織也可以透過簡短的 WAV 或 MP3 範例建立自訂語音。自訂語音有配額與非同步建立狀態；準備完成後，會與語音庫中的語音一同顯示在智慧體選擇器中。 在控制台中： 語音（/dashboard/voices）。請參閱
語音庫與自訂語音。
在 API 中： /v1/voices、
語音範例，以及
自訂語音。
電話號碼
電話號碼隸屬於組織，並將來電路由至 智慧體（也可用於撥出電話）。來源有兩種：- 示範號碼——從 ThunderPhone 號碼池配置的真實美國號碼，幾秒內即可啟用。僅限來電，接聽時會播放簡短的語音 免責聲明，且控制台將每個組織限制為最多 10 個。非常適合首次測試；不適合正式環境。
- VoIP 號碼——透過你自己的供應商和 VoIP 連線導入。Twilio 和 Telnyx 可直接連線 （Telnyx 提供引導式設定）；SignalWire 和 Vonage 即將推出—— 目前你可透過手動 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 指令後，AI 精靈會草擬工具定義；你也可以手動建立。測試請求按鈕會在你部署前發出沙箱呼叫。請參閱 API 連線——這是/v1/integrations的控制台介面。 - MCP（
/dashboard/mcp-connections）——透過 URL 新增 Model Context Protocol 伺服器，讓智慧體使用它提供的工具。 請參閱新增 MCP 伺服器。 - VoIP（
/dashboard/voip-connections）——供 使用你自己的電話號碼使用的服務供應商憑證。請參閱 連接 VoIP 服務供應商。
/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）。你最多有 10 秒可回應；若逾時，系統會由靜態指派的智慧體處理通話。 - 非阻塞事件為即發即忘的通知，並會以指數退避方式重試——請參閱傳送語意。
X-ThunderPhone-Signature 中附帶 HMAC-SHA256 簽章。請參閱簽章驗證。
函式工具
函式工具是你的智慧體可在對話中途呼叫的 HTTP 端點。你向 ThunderPhone 提供 OpenAI 風格的函式結構描述與端點 URL；智慧體會決定何時呼叫，ThunderPhone 則會從其伺服器發出已簽署的 HTTP 請求，並將結果交回智慧體。 智慧體也提供內建通話功能——轉接通話、傳送按鍵輸入（DTMF）、結束通話、保留等待——你只需加入簡單的提示詞行，而不必定義工具。 **在控制台中：**建置器的 API 連線區段（請參閱連線）。 在 API 中：/v1/integrations 與函式工具規格。
團隊與角色
每個組織都有成員清單，並提供兩種角色：成員可建置及操作智慧體；管理員還可管理團隊與帳務。可透過電子郵件邀請——邀請會在 7 天後到期，也可撤銷；成員列上的 ⋯ 選單可用於變更角色或移除成員。可為整個組織設定單一登入——請參閱SSO。 在控制台中： 組織 → 一般。請參閱邀請你的團隊。 在 API 中：/v1/members、/v1/invites。
帳務
ThunderPhone 採用預付制。每個組織都有 USD 餘額；通話會依智慧體的每分鐘費率扣款（引擎級別加上附加費——當你變更設定時，建置器會即時顯示總費率，而特定附加語言每分鐘另加 3¢）。當餘額歸零時，系統會拒絕接聽來電，撥出電話則會回傳402 Payment Required。
你可以手動儲值，或啟用自動儲值，設定餘額門檻、儲值金額及選填的每月支出上限——確保通話不會在句子說到一半中斷。
在控制台中： 組織 → 帳務設定與帳務紀錄。請參閱儲值並啟用自動儲值，以及完整定價參考。
在 API 中：/v1/billing。
應用程式內 AI 副駕
控制台內建 AI 副駕——向它詢問「我要如何 X」，它會根據這些文件提供答案、提供逐步操作導覽並突顯實際控制項，也可以重新播放任何引導導覽。這是尋找本頁提及控制項的最快方式。請參閱詢問應用程式內 AI 副駕。整合使用
控制台快速入門
五步驟精靈：智慧體 → 計費 → 號碼 → 模擬 → 檢視。
API 快速入門
透過四次 REST 呼叫完成相同的首次通話。
使用控制台
建立智慧體、儲值、取得號碼、模擬並檢視通話。
連接工具與資料
OAuth 應用程式、自訂 API、MCP 伺服器與 VoIP 供應商。
分析與改善
報告、可觀測性、實驗、問題與警示。
團隊與帳戶
邀請與角色、API 金鑰、安全性與 SSO。
開發人員手冊
API 範例：來電、撥出電話、動態設定、工具與測試。
驗證 Webhook 簽章
一次正確完成 HMAC 檢查，並在各處重複使用。