Open in
telephony.incoming / web.incoming
即時設定來電配置的阻塞式 Webhook。
當來電撥至一個未獲指派智能體的
號碼(如來電者回撥你的外撥電話,請參閱 回撥),或網頁小工具工作階段透過
mode="webhook" 的可發布金鑰啟動時,ThunderPhone 會向你的
舊版 webhook URL
發出一個阻塞式
telephony.incoming / web.incoming 請求,並等待設定回應:電話通話最長 13 秒,包括一次重試;小工具工作階段最長 10 秒(請參閱 逾時與重試)。使用這項
交換機制,為每通電話動態選擇提示詞、語音和工具——
完整模式請參閱動態通話設定指南。
已指派智能體的號碼會由該智能體接聽。當智能體設有自己的通話設定 webhook 時,系統會先在該智能體的 URL 執行相同的阻塞式交換,以填入智能體的變數及通話內容。
逾時與重試
請迅速回應:當你作出決定時,來電者正在通話中等候。
如為電話通話(telephony.incoming):
- 首次嘗試最長可達 10 秒。
- 如逾時、無法連線,或收到
5xx、408或429回應,ThunderPhone 會再嘗試一次。重試會取得整個請求往返 13 秒 時限的剩餘時間:首次嘗試逾時後約有 3 秒,快速失敗後則幾乎有完整 13 秒。 如剩餘時間不足 2 秒,則不會重試。 - 任何其他
4xx回應、超過 大小限制的回應,或內容並非有效 設定的2xx回應,均屬最終結果,不會重試。 - 兩次嘗試均會傳送相同的內容、相同的
X-ThunderPhone-Signature及相同的X-ThunderPhone-Idempotency-Key標頭 (telephony-incoming-<call_id>),因此具副作用的處理程式 可以識別重試。
如未收到可用設定,通話會立即結束,而不會讓來電者在線路上靜默等待。通話記錄會顯示為失敗且不收費的通話,end_reason 為
inbound_config_webhook_failed,並會傳送一般的
telephony.complete 事件。控制台中的通話頁面,以及
GET /v1/calls/{call_id} 中的 config_webhook_failure,
會說明你的 webhook 執行結果:{kind, attempts, http_status, host, source}。其中,kind 可以是 http_error、
timeout、connection、dns、tls、response_too_large、
blocked_url、other、invalid_json、non_object_json 或
invalid_config;host 是你的 webhook 主機名稱;source 為
number(此 webhook)或 agent_setup(智能體的通話設定 webhook)。
如屬 invalid_config,reason 會說明回應無法使用的原因,而
fields 會列出相關欄位:no_agent(沒有 agent_id 或
prompt;fields 會列出被忽略的鍵,例如拼錯的
agentId)、agent_not_found、agent_id_not_integer、unexpected_fields
(與 agent_id 並列、但不屬於 variables、context、timezone 及
language 的鍵)、invalid_variables、invalid_context、invalid_language、
unsupported_language、invalid_config_fields 或 agent_settings_invalid。
否則,reason 為 null,而 fields 為空。唯一例外是當該交互本身失敗時,
來電者回撥你其中一通外撥電話:請參閱 Callbacks。
小工具工作階段(web.incoming)只有一次最長 10 秒的嘗試。如失敗,工作階段請求會以 502 或 422 失敗。
請求承載資料
電話通話(telephony.incoming):
{
"type": "telephony.incoming",
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
}
}| 欄位 | 類型 | 說明 |
|---|---|---|
call_id | integer | 通話 ID —— 此通話的所有事件均維持一致 |
from_number | string | E.164 來電者號碼 |
to_number | string | E.164 目的地號碼(你的其中一個 ThunderPhone 號碼) |
returning_call | object | 僅當此號碼在過去 30 日內曾致電該來電者時提供。請參閱 回撥 |
sip_headers | object | 僅當通話透過手動 SIP 連線到達,並附帶 X-* 或 User-to-User SIP 標頭時提供:以小寫標頭名稱 → 值。請參閱 SIP 標頭 |
網頁小工具工作階段(web.incoming)的 data 會識別嵌入頁面,
而非電話號碼:
{
"type": "web.incoming",
"data": {
"call_id": 987654322,
"origin_domain": "https://example.com",
"publishable_key_prefix": "pk_live_a1b2"
}
}| 欄位 | 類型 | 說明 |
|---|---|---|
call_id | 整數 | 通話 ID |
origin_domain | 字串 | 承載小工具的頁面來源,按瀏覽器所傳送的值提供。非瀏覽器用戶端可傳送任何值,因此不應將其視為請求來源的證明 |
publishable_key_prefix | 字串 | 開啟工作階段的公開金鑰開首字元 |
language、primary_language | 字串 | 當小工具工作階段要求覆寫語言時提供 |
voice | 字串 | 當小工具工作階段要求覆寫語音時提供 |
website_context | 字串 | 當小工具傳遞每個工作階段的頁面內容時提供 |
覆寫欄位(language、voice、website_context 以及任何瀏覽器
variables)只會在公開金鑰於其瀏覽器覆寫設定中允許時傳送。若工作階段請求包含該金鑰不允許的欄位,系統會在呼叫此 webhook 前拒絕該請求。
回應結構
傳回描述此通話智能體設定的 JSON 物件。
prompt 及 voice 為必填欄位;其他欄位均為選填。
{
"prompt": "You are a helpful booking assistant for Acme Restaurant.",
"voice": "john",
"product": "spark",
"background_track": null,
"tools": []
}| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
prompt | string | 是 | 驅動智能體的系統提示詞 |
voice | string | 是 | 來自 GET /v1/voices 的語音 ID,例如 john。voice_name 可作為別名使用。未知語音未能通過驗證,並會拒絕通話 |
product | string | 否 | 傳送 bolt。預設為 spark;此較舊的值仍可與 storm-base、storm-base-with-ack、storm-extra 及 storm-extra-with-ack 一同使用 |
thinking_level | string | 否 | minimal、base(預設)或 extra。如使用較舊的 storm-* 產品值,storm-extra* 會強制使用 extra,其他 storm-* 則強制使用 base |
audio_context_mode | string | 否 | full(預設)或 reduced |
watchdog_enabled | boolean | 否 | 為此通話啟用監督。預設為 false |
additional_audio_context | boolean | null | 否 | 加入來電者最近數輪音訊,而非僅最近一輪,以較小的延遲及成本開銷提升修正能力,以及收集拼寫或數字較多資料的準確度。來電工作階段預設啟用,撥出電話預設停用;null 會保留預設設定 |
storm_feedback_mode | string | 否 | none、acknowledgement(預設)或 tick:當 audio_tier 為 plus 或 max,而系統正在處理較慢的回覆時,來電者會聽到的聲音 |
language | string | 否 | primary_language 的簡寫。亦可與 agent_id 一同使用;此時代表通話開始時使用的語言,並以智能體為該語言設定的語音說出。請參閱為每通通話設定語言 |
primary_language | string | 否 | 經標準化的語言代碼(預設為 en)。無法解析的代碼會拒絕通話 |
has_additional_languages | boolean | 否 | 預設為 false |
additional_languages | array of string | 否 | 智能體可切換至的額外語言 |
native_voice_switching | boolean | 否 | 預設為 false。通話切換至另一種語言時,會改用該語言的母語語音(按性別配對),而非保留已設定的語音 |
language_switching | string | null | 否 | ask_first(預設)或 follow_caller;null 與 ask_first 相同。多語言智能體如何處理對方說出其另一種語言。對方要求使用該語言或以該語言說出完整句子時,ask_first 會立即切換;如只說了簡短內容,例如「sí」,則會詢問是否繼續使用該語言。follow_caller 會切換至對方所說的任何已設定語言,即使只說了一個字詞亦然。僅在設定 additional_languages 時適用 |
audio_tier | string | null | 否 | 僅適用於 product: "bolt"。聆聽:智能體聽取來電者的仔細程度。standard(預設;"" 與 null 含義相同)適合大部分通話(處理 PHI 的通話只會使用受 BAA 涵蓋的供應商)。lite 最便宜,但較容易聽錯。plus 會更仔細聆聽較困難的回合,約需多 1–2 秒。max 適用於最困難的音訊及罕見語言;每次回覆需時 3–4 秒,通話會使用 pro 智能(會忽略 intelligence)。max 並非普遍可用:如某個組織未獲啟用,通話會使用 plus 及你指定的 intelligence(包含此值的撥出通話請求會以 400 拒絕)。較舊的值 lean(Lite)、hearing(Plus)及 deep_hearing(Max)仍然接受。其他產品會忽略此設定 |
endpointing | string | null | 否 | faster(200 ms)、fast(300 ms)、normal(500 ms,預設)或 patient(800 ms);null 與 normal 相同。Bolt v2 智能體在來電者停止說話後,等待多久才要求模型回覆。較短的等待可更快回覆,但會發出更多可能被來電者後續說話作廢的請求,因而增加模型成本。其他產品會忽略此設定 |
eagerness | string | null | 否 | 已棄用:截至 2026 年 10 月 19 日前 endpointing 的名稱,仍會讀取。設定 endpointing 時會忽略此欄位 |
intelligence | string | null | 否 | core 或 pro(預設);null 與 pro 相同。Bolt v2 管線上的 bolt 智能體遵從指示的可靠程度。core 首字延遲約為 700 ms,最便宜但可靠性稍低(處理為 PHI 的通話約為 900 ms,可靠性亦較低);pro 約為 900 ms;原本只會呼叫工具的 Core 回覆會交由 Pro 處理。較舊的值 lite(Core)及 standard(Pro)仍然接受,而已淘汰的 plus 及 max 會在 pro 上執行。當 audio_tier 為 max 時會忽略此設定。其他產品會忽略此設定 |
faster_replies | boolean | null | 否 | 速度提升。預設為 true。Bolt v2 管線上的 bolt 智能體會以略高成本更早開始回覆。false 會停用此功能。其他產品會忽略此設定 |
background_track | string | null | 否 | 環境音訊 ID 或 null |
acknowledgement_prompt_mode | string | 否 | auto(預設)或 manual(較舊的 -with-ack 產品值) |
acknowledgement_prompt | string | 否 | 當 acknowledgement_prompt_mode="manual" 時使用 |
silence_interval_seconds | integer | null | 否 | 5–120。來電者靜默多久後進行一次跟進確認,單位為秒 |
silence_max_checkins | integer | null | 否 | 1–10 |
silence_checkins_enabled | boolean | 否 | 預設為 true |
silence_final_action | string | 否 | 最後一次跟進確認後:hang_up(預設),或 transfer 至 silence_transfer_destination |
silence_transfer_destination | string | 否 | 此設定中 transfer_destinations 項目的名稱;使用 transfer 時必須設定。沒有 transfer_destinations 時無法轉接,智能體會掛線 |
silence_final_message | string | 否 | ≤ 300 個字元,按原文讀出;""(預設)會使用預設訊息 |
connect_tone_enabled | boolean | 否 | 預設為 false |
pronunciation_dicts | boolean | null | 否 | 預設為 false;null 與 false 相同。設為 true 時,通話的 Cartesia 語音會在適用情況下,使用 ThunderPhone 為該通話語言提供的發音字典。適用於電話及小工具通話。僅適用於 ThunderPhone 自有的 Cartesia 語音,不適用於你自己的 Cartesia API 金鑰所使用的語音。與 agent_id 一同使用時不適用,會改為套用已儲存智能體的設定 |
words | array | null | 否 | 智能體讀出特定字詞的方式,項目與智能體的 words 相同,但不包括 support。沒有 language 的項目會使用此設定的語言。null 及 [] 均表示沒有項目。與 agent_id 一同使用時不適用,會改為套用已儲存智能體的字詞設定 |
voicemail_action | string | 否 | prompt(預設)、hangup 或 message |
voicemail_message | string | 否 | 當 voicemail_action="message" 時使用 |
agent_name | string | 否 | 顯示於控制台及小工具的名稱 |
org_name | string | 否 | 智能體角色使用的組織顯示名稱 |
tools | array | 否 | 內嵌函式工具綱要(請參閱函式工具) |
transfer_destinations | array of object | null | 否 | 此通話最多可轉接至 50 個 {name, number} 項目,並會按智能體的轉接號碼規則驗證。智能體會按名稱轉接,且只能轉接至這些項目;[] 表示不允許轉接。省略此欄位或傳送 null,可讓智能體轉接至其自行選擇的號碼 |
timezone | string | 否 | 此通話使用的 IANA 時區,例如 America/Chicago。智能體會按此時區說出日期及時間,其優先次序高於智能體本身的時區。亦可與 agent_id 一同使用。非 IANA 時區的值會被忽略。請參閱為每通通話設定時區 |
context | string | null | 否 | 此通話的自由格式文字,例如你的系統收集的備註,最多 20,000 個字元。會以分隔區塊形式加入提示詞後,且不會作為範本呈現。亦可與 agent_id 一同使用。非字串或超過長度限制的值會拒絕通話。請參閱通話變數及內容 |
call_id | integer | 否 | 可選的請求通話 ID 回傳值;會被忽略 |
由於必須提供 prompt 和 voice,傳回 {} 或任何未能通過驗證的回應都會拒絕通話:電話通話會按逾時與重試所述結束,而小工具工作階段請求則會以 422 失敗。這同樣適用於回訪來電者:你的 webhook 傳回的任何 JSON 物件均視為其答案,而 {} 就是拒絕通話的方式。
智能體通話設定 webhook
智能體可擁有專屬的通話設定 webhook:其設定中的 通話設定 webhook
欄位,或 API 中的 call_setup_webhook_url。
將智能體指派至一個號碼後,在該號碼接聽的每個來電之前,ThunderPhone
會向 webhook 取得該通話的變數及上下文。該號碼會保留其智能體,因此電話
號碼頁面及智能體頁面會顯示由哪個智能體接聽。
這與智能體的其他設定相同:以草稿形式暫存、在部署時發佈,並保留於版本
歷史記錄中。已
釘選至較舊版本
的號碼會請求該版本的 URL。請求會使用智能體本身的
call_setup_webhook_signing_secret(而非組織的 webhook
密鑰)簽署,並採用與上文相同的
X-ThunderPhone-Signature 標頭、逾時設定、重試及冪等性金鑰。此密鑰僅可
寫入:設定一個由端點驗證的密鑰(在智能體設定中,或使用
PATCH /v1/agents/{id});任何讀取操作均不會傳回此密鑰,而
call_setup_webhook_signing_secret_set 會指出是否已設定密鑰。
請求為上方的 telephony.incoming 載荷,加上正在填入設定的智能體:
{
"type": "telephony.incoming",
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567",
"variables": null,
"agent": {
"id": 12,
"name": "Front desk",
"version": 7,
"version_pinned": false
}
}
}| 欄位 | 類型 | 說明 |
|---|---|---|
agent.id | integer | 指派至該號碼的智能體 |
agent.name | string | 其名稱 |
agent.version | integer | null | 將會接聽的版本編號:號碼釘選的版本,否則為智能體最新發佈的版本(如沒有版本則為 null) |
agent.version_pinned | boolean | 該號碼是否釘選至該版本 |
以通話所需資料回應。 以下任何一項均會按該號碼的版本填入 已指派智能體的資料:
{"variables": {...}}、{"context": "..."},或兩者同時提供- 相同內容,並將
"agent_id"設為已指派智能體的 id {}:智能體會在未填入任何資料的情況下接聽
亦可使用 timezone 及 language,如同在
agent_id 旁使用一樣。變數會填入智能體的
{{placeholders}};上下文會加於提示詞之後。
或自行決定通話設定。 使用另一個智能體的 agent_id,或提供包含
prompt 的完整設定,會由該設定接聽這一通電話,而非已指派的智能體
(及其釘選版本)。通話詳情會在
call_setup_webhook 中標示各個情況:
assigned_agent、other_agent 或 inline_config。無法使用的回應(未知的
agent_id、與 variables 並列的其他金鑰、未能通過驗證的設定)會如同
號碼的 webhook 一樣結束通話。
webhook 必須回應的情況。 當智能體的設定使用沒有預設值的
{{variable}} 時,智能體便需要其 webhook:包括其提示詞或可重用指示、
步驟指示或對白、確認提示詞、留言訊息、同意聲明,或使用
{{variable}} 的轉駁號碼。智能體的 call_setup_webhook_variables
會列出這些變數。
- 需要 webhook: webhook 逾時、無法連線,或回傳錯誤或非 JSON 物件
的內容時,即使通話已帶有其中一個變數的值,通話亦不會開始。通話會按照
逾時及重試所述方式結束及記錄(
end_reason為inbound_config_webhook_failed,不會計費)。 - 不需要任何資料(沒有變數,或每個變數均有如
{{first_name|there}}的預設值):webhook 仍會執行,但如執行失敗, 智能體會在沒有其資料的情況下接聽,通話詳情會顯示webhook_failed及失敗原因。
單靠通話內容不會令 webhook 成為必要:智能體設定中沒有任何項目表示需要內容。如通話必須取得你的 webhook 回覆後才可開始,請使用沒有預設值的變數。
指派及部署。 需要其 webhook 的智能體無法指派至沒有 webhook 的號碼:系統會拒絕指派,並顯示相關變數名稱的訊息。號碼版本變更時亦會執行相同檢查,包括已固定版本的號碼切換回 Latest。當智能體以已發佈的設定接聽號碼時,如部署新增此類沒有 webhook 的變數(或移除 webhook),同樣會被拒絕。你始終可以儲存草稿,而智能體的 warnings 會一直包含 call_setup_webhook_needed,直至問題修正。
智能體的 webhook 只會在其獲指派號碼的撥入電話中執行。撥出電話、網頁小工具工作階段、SIP 地址、模擬及控制台測試對話不會呼叫它;這些情況會如以往般從請求取得變數。
使用已儲存的範例進行測試。 如要測試你的智能體在指定回應下的表現(例如回訪來電者、找不到記錄或西班牙語使用者),可將該回應儲存為智能體的範例:輸入或從過往通話複製其 variables、context,以及可選的 language。啟動控制台測試對話、撥打你電話的測試通話,或針對智能體進行模擬時,選取該範例;通話會如同你的 webhook 已回傳該回應般執行。所有智能體版本均共用範例。編輯範例不會改變其較早版本:如智能體的變更需要範例未設定的變數,請將其加入範例;較舊的智能體版本仍會使用原有版本的範例。撥打電話號碼的模擬則會改為執行你的實際 webhook。
沒有獲指派智能體的號碼,會繼續完全按照上述方式使用號碼或組織的 webhook。
回電
用戶經常會回撥曾致電給他們的號碼,例如你的智能體留下語音留言後。當來電者所使用的號碼在過去 30 天內曾接到同一號碼的來電時,ThunderPhone 會找出最近一次相關的撥出通話(曾令對方電話響鈴的通話),並以三種方式使用:
-
請求中的
returning_call。 上述阻塞式請求及端點通知均會包含此資料,讓你的處理程式可為來電者進行路由:{ "type": "telephony.incoming", "data": { "call_id": 987654321, "from_number": "+14155550199", "to_number": "+15551234567", "returning_call": { "call_id": 987650001, "agent_id": 13, "started_at": "2026-10-21T19:05:12.402Z", "outcome": "voicemail" } } }欄位 類型 說明 call_idinteger 較早前的撥出通話 agent_idinteger | null 撥出該通話的智能體;如通話使用行內設定撥出,或其智能體已被刪除,則為 nullstarted_atstring 開始時間(ISO 8601、UTC) outcomestring no_answer(響鈴至逾時、忙線或被拒接)、voicemail(語音信箱接聽,或無人與智能體交談)、conversation(有人與智能體交談)或answered(已接聽;但尚未得知由誰接聽) -
智能體的背景資料。 無論由哪個智能體接聽,其提示詞末尾都會附上簡短註記:較早前的通話何時撥出、由哪個智能體撥出,以及其結果。智能體會被指示不得讀出該註記;而且由於來電顯示可被偽造,除先前曾致電該號碼外,不得披露任何有關該通話的資料。
-
備用智能體。 當該號碼沒有入站智能體,且因沒有 webhook URL 或你的 webhook 未有回應而未收到設定(逾時、無法連線,或兩次嘗試均回應
5xx、408或429),通話不會結束,而會轉交至撥出較早前通話的智能體,前提是該智能體仍存在於你的組織中。它會以該智能體已部署的設定運作。你的 webhook 所提供的任何回應仍會決定結果:另一個4xx、不是 JSON 物件的主體、{},或未能通過驗證的設定,均會如以往般結束通話。該號碼上的入站智能體一律會接聽。
分享較早前通話的詳細資料。 來電顯示可被偽造,因此預設不會將較早前通話內容中的任何資料傳送至新通話。組織管理員可在組織 → 一般 → 回電下啟用 分享較早前通話的詳細資料(或設定 callback_context_details_enabled)。啟用後,智能體的註記亦會引用較早前通話的摘要,而路由至撥出較早前通話的智能體之通話,會使用該通話的 variables(例如聯絡人姓名)。只有在這些詳細資料可安全地與任何從該號碼致電的人分享時,才應啟用此功能。即使已啟用,可能包含受保護健康資訊的通話,亦不會將其摘要或變數傳送至未被指定為處理 PHI 的通話。
通話詳情中。 與較早前通話相符的來電,會在 GET /v1/calls/{call_id} 中包含一個 callback 物件:
上述的 returning_call、routed_as_callback(後備方案是否接聽該通話),以及 config_webhook_failure(當你的 webhook 未有回應而後備方案接聽通話時,為 {kind, attempts, http_status, host};否則為 null),因此即使通話已獲接聽,webhook 故障仍會清楚顯示。
回應大小限制
處理常式範例
import hashlib
import hmac
import json
import os
from fastapi import FastAPI, HTTPException, Request
app = FastAPI()
WEBHOOK_SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
def verify(body: bytes, signature: str) -> bool:
expected = hmac.new(WEBHOOK_SECRET.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature or "")
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
body = await request.body()
if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
raise HTTPException(status_code=401)
event = json.loads(body)
if event["type"] == "telephony.incoming":
caller = event["data"]["from_number"]
prompt = (
"Greet the caller as a San Francisco local…"
if caller.startswith("+1415")
else "You are a friendly customer support agent…"
)
return {
"prompt": prompt,
"voice": "john",
"product": "spark",
}
if event["type"] == "web.incoming":
return {
"prompt": "You are the website's helpful voice assistant…",
"voice": "john",
"product": "spark",
}
return {}import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
function verify(body, signature) {
const expected = crypto
.createHmac("sha256", SECRET)
.update(body)
.digest("hex");
return signature &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
app.post(
"/thunderphone-webhook",
express.raw({ type: "application/json" }),
(req, res) => {
if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
return res.sendStatus(401);
}
const event = JSON.parse(req.body.toString("utf8"));
if (event.type === "telephony.incoming" || event.type === "web.incoming") {
const caller = event.data.from_number || "web";
const prompt = caller.startsWith("+1415")
? "Greet the caller as a San Francisco local…"
: "You are a friendly customer support agent…";
return res.json({
prompt,
voice: "john",
product: "spark",
});
}
res.json({});
},
);包含函數工具的回應
附加工具,讓 AI 可在對話期間呼叫你的 API:
{
"prompt": "You are a booking assistant. Use the available tools to help customers schedule appointments.",
"voice": "john",
"product": "spark",
"tools": [
{
"type": "function",
"function": {
"name": "search_appointments",
"description": "Find available appointment slots",
"parameters": {
"type": "object",
"properties": {
"date": { "type": "string", "description": "YYYY-MM-DD" },
"service": { "type": "string" }
},
"required": ["date"]
}
},
"endpoint": {
"url": "https://api.example.com/appointments/search",
"method": "POST",
"headers": {
"X-Api-Key": "your-key"
}
}
}
]
}設定速查表
傳送 product: "bolt",並透過以下欄位調整通話。較舊的
product 值(spark 及 storm-* 值)仍然支援。
| 欄位 | 值 | 取捨 |
|---|---|---|
intelligence | core、pro(預設) | Core 成本較低,亦會較早開始回覆;Pro 能更可靠地遵循較長的提示 |
audio_tier | lite、standard(預設)、plus、max | 較高級別的辨識效果更佳,成本亦較高;Plus 在部分輪次會增加 1–2 秒,每次 Max 回覆需時 3–4 秒(Max 尚未全面提供) |
endpointing | faster、fast、normal(預設)、patient | 較短的等候時間可更早回覆,但成本較高 |
faster_replies | true(預設)、false | 速度提升:回覆會稍為更早,成本亦會稍高 |