ThunderPhone 2.0 正式登場。自助開通,價格低至每分鐘 2¢查看公告

Getting Started

核心概念

平台所有功能的地圖——各個物件的用途、在控制台中的位置,以及會使用到它的 API。

ThunderPhone 是一個完整的平台,讓你建立、運行及持續改進 AI 語音智能體。本頁為你提供全覽:每個你會遇到的概念均有簡短說明,並列出相應的控制台介面及支援它的 API。先快速瀏覽一次,日後遇到需要進一步了解的術語時可隨時回來查閱。

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

互動

即時監控及外撥 活動

品質與測試
事件處理

供你的程式碼使用的 Webhooks函式工具


組織

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

你在組織 → 金鑰下建立的 sk_live_ API 金鑰,會綁定至一個組織。這項綁定令 REST API 的結構保持簡潔:你毋須在 URL 路徑中加入組織 ID,因為你的金鑰已可識別該組織。

控制台內:組織切換器(側邊欄底部),以及組織設定——包括「我的帳戶」、「一般」、「金鑰」、「提示」、「帳單設定」及「帳單記錄」分頁。請參閱組織設定參考資料

API 內/v1/orgs/v1/developer/api-keys


智能體

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

  • 用以規範智能體說話內容及行為的提示詞——包括轉接、按鍵及掛線等通話操作;這些均是一般提示詞內容,而非獨立設定。
  • 引擎級別sparkboltstorm-*):Spark 針對成本最佳化,Bolt 針對速度最佳化,Storm 則為複雜提示詞提供更高智能。
  • 語音主要語言及可選的額外語言——來電者切換語言時,智能體會自動切換。請參閱支援的語言
  • 已附加的功能:已連接應用程式API 連接知識庫MCP 伺服器及內嵌 函式工具
  • 行為設定:說話順序、確認模式、背景音軌及保留逾時。

你在建立工具中的修改會自動儲存為草稿;只有按下部署後才會正式生效。每次部署均會在建立工具的記錄分頁建立快照,讓你檢視及還原任何過往版本。

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

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


語音

語音庫包含智能體可使用的語音、可播放的示範、相容語言、性別及口音分類,以及任何高級語音/語言附加費。你可透過付費試聽功能,在選擇前合成一段 1–500 字元的自訂短句。

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

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

在 API 中: /v1/voices語音範例自訂語音


電話號碼

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

  • ThunderPhone 號碼——由 ThunderPhone 號碼池配置的真實美國號碼,數秒內啟用,$1/月,另加每分鐘 1¢ 附加費。僅支援來電;撥出電話需要使用你自己的電訊商。一個機構預設最多可 持有 25 個。
  • VoIP 號碼——透過你自己的供應商,使用 VoIP 連線接入。Twilio 及 Telnyx 可直接連線 (Telnyx 提供引導式設定);SignalWire 及 Vonage 即將推出—— 目前可透過手動 SIP 設定接入,支援任何 SIP trunk。匯入並驗證後,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 供應商

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。提供兩種傳送模式:

  • 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 採用預繳模式。每個組織均有美元餘額;通話會按智能體的每分鐘費率扣款(引擎級別加上附加費——當你變更設定時,建立工具會即時顯示總費率,而 指定額外語言 會增加 3¢/分鐘)。當餘額降至零時,系統會拒絕來電,而撥出電話會傳回 402 Payment Required

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

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

在 API 中: /v1/billing


應用程式內智能助手

控制台內置 智能助手——向它提問「如何完成 X」,它會根據這些文件提供答案,提供逐步操作導覽以突出顯示實際控制項,亦可重播任何導覽。這是尋找本頁提及控制項的最快方法。請參閱 詢問應用程式內智能助手


整合各項功能