ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Using the dashboard

轉接通話

儲存智能體可轉接至的電話號碼,然後以冷轉接為來電者轉駁,或保持在線並透過暖轉接介紹對方。

智能體只會將通話轉駁至其 轉駁號碼:即你儲存於智能體內的名稱及 電話號碼清單。提示詞會按名稱提及每個號碼,並說明何時轉駁,以及應採用冷轉接還是暖轉接。智能體只會看見名稱,絕不會看見號碼。未設定轉駁號碼的智能體 無法轉駁通話。

模式運作方式適用情況
冷轉接來電者會直接轉駁至目的地。智能體不會介紹來電者,亦不會確認是否有人接聽。快速路由比介紹來電者更重要,或該通話所用的號碼無法撥出電話。
暖轉接有人接聽後,來電者便會接通;智能體會在線上介紹來電者,然後離開通話。你亦可讓智能體先詢問或低聲提示。目的地應知道來電者身分及來電原因,或在無人接聽時讓來電者返回智能體。

如果智能體未指定模式,轉接會採用冷接。

設定轉接

在控制台中:

  1. 開啟 語音智能體,選擇該智能體,然後開啟 設定。
  2. 在 轉接號碼 下,為每個目的地新增名稱及電話號碼,例如 帳務 及 +1 415 555 2671。每個智能體最多可設定 50 個轉接號碼。
  3. 在提示詞中,按名稱提及每個目的地,並說明何時使用,以及應使用 cold 或 warm 模式,例如「將帳務問題轉接至帳務」。你無需建立自訂工具。
  4. 如使用暖轉接,選擇 接通前 的處理方式,並可選擇設定 摘要 內容。請參閱 接通前。
  5. 如有需要,將 進階 → 響鈴時間 設定為 5 至 120 秒。
  6. 選擇 發布。

使用 API 時,透過 PATCH /v1/agents/{agent_id} 暫存 transfer_destinations、 提示詞,以及可選的 warm_transfer_style、warm_transfer_briefing 和 ring_duration_seconds,然後執行 POST /v1/agents/{agent_id}/deploy:

{
  "transfer_destinations": [
    {"name": "Billing", "number": "+14155552671"},
    {"name": "Front desk", "number": "+19375551234"}
  ],
  "warm_transfer_style": "introduce",
  "warm_transfer_briefing": "The caller's name and what they need."
}

每次寫入都會取代整個清單,而 [] 會移除所有轉接號碼。欄位規則及驗證錯誤請參閱 智能體 API。

名稱及號碼

  • 名稱:1 至 60 個字元;在同一智能體內不分大小寫必須唯一。這是 提示詞使用的名稱。
  • 號碼:完整電話號碼。未附國家/地區代碼的號碼會視作 美國號碼,所有號碼均以 E.164 格式儲存。系統會拒絕分機號碼及虛構範圍 555-0100 至 555-0199。
  • 變數號碼:以單一 通話變數取代電話號碼,例如 {{rep_phone}}。 通話開始時會從通話變數填入其值。如變數缺失,或其值在該通話中並非有效號碼, 系統會拒絕轉駁至該名稱。
  • SIP 地址:以 sip: 或 sips: 地址取代電話號碼,例如 聯絡中心佇列。請參閱轉駁至 SIP 地址。
  • 返回:完全不設定號碼。智能體會將通話交回其原來的 聯絡中心。請參閱將通話返回至你的聯絡中心。

僅限熱轉接

在電話號碼或變數項目上設定 warm_only: true,即可令所有轉接至該項目的操作均為熱轉接,即使智能體要求冷轉接亦然:

{"name": "Matthew", "number": "+14155552671", "warm_only": true, "answerer": "Matthew Ray"}
  • 如果該人或線路未有接聽熱轉接(無人接聽、佔線、轉駁語音信箱、掛線,或在使用 先詢問 時拒絕接聽或該人不在),智能體不會在同一通電話中再次嘗試該項目,不論是熱轉接或冷轉接。智能體會告知來電者,並提供其他選項,例如記錄留言。
  • 如果熱轉接改為在 ThunderPhone 或電訊商一方失敗(無法撥出,或在任何人作出決定前轉接中斷),智能體可以再次將來電者轉接至該項目,而該次轉接會是冷轉接。
  • 熱轉接需要可撥出電話的號碼(請參閱要求、限制及測試)。如通話無法撥出電話,例如未獲批准撥出電話的號碼、網頁或咪高峰工作階段,或全雙工智能體,轉接至僅限熱轉接項目時會改為冷轉接,而不會被拒絕。同樣地,如熱轉接所用線路無法接通某個號碼,但該通電話本身的電訊商可以接通,該轉接會是冷轉接。如雙方均無法接通該號碼,則會如任何項目一樣被拒絕。
  • 當智能體轉接一名已停止回應的來電者(靜默後的最終操作,silence_final_action: "transfer"),轉接一律為冷轉接,包括僅限熱轉接項目。
  • 此設定不可用於 SIP 地址或回撥,兩者均會直接交接通話,而不會先致電任何人。

可透過 Agents API 設定,或要求 Zeus 協助。控制台目前尚未顯示此設定;除非你更改該項目的名稱或號碼,否則儲存其他變更時會保留此設定。

轉接至 SIP 位址

轉接號碼可以是 SIP 位址,例如 sip:support@pbx.example.com,讓智能體可將來電者轉回你的 聯絡中心或 PBX。此轉接屬於冷轉接:ThunderPhone 會以該位址傳送 SIP REFER,其後由你的系統接手通話。

SIP 位址僅適用於通話來自你自有 SIP 系統的情況:

  • 撥打至 SIP 位址 的通話(每次通話 URI 或 SIP 端點),以及
  • 使用你透過手動 SIP 連線接駁的號碼進行的通話 (你自有的 SIP trunk)。

任何其他通話,包括使用 ThunderPhone 號碼,以及透過 Twilio 或 Telnyx 接駁的號碼進行的通話,均會拒絕轉接至 SIP 位址:智能體會被告知無法轉接至該處, 並會繼續與來電者通話。轉接至 SIP 位址的暖轉接會以冷轉接方式執行。

位址必須完整寫出,不能使用 {{variable}}。位址最多可包含 255 個字元, 必須包含主機名稱,且不能包含空格、引號、逗號或角括號。可以使用 ;transport=tls 等參數。位址本身唯一可攜帶的標頭是 ?User-to-User=, 供會從轉接位址讀取使用者對使用者資訊的平台使用: sip:queue@sbc.example.com?User-to-User=00a1b2;encoding=hex。

轉接時的 SIP 標頭

任何轉接號碼亦可列出 headers,在冷轉接的 REFER 中傳送,例如讓你的聯絡中心 查詢來電者帳戶 ID:

{
  "name": "Support queue",
  "number": "sip:support@pbx.example.com",
  "headers": {
    "X-Account-Id": "{{account_id}}",
    "User-to-User": "{{uui}}"
  }
}
  • 最多 10 個標頭。名稱必須以 X- 開頭,或為 User-to-User。X-TP- 名稱 保留供 ThunderPhone 使用。
  • 值最多 256 位元組,並可使用 通話變數,於通話開始時填入。缺少的變數會保留為空白, 會移除換行符號,而填入後的值超過 256 位元組的標頭不會傳送。
  • 標頭只會於冷轉接的 REFER 中傳送,而且僅在電訊服務供應商將其轉送時才會送達你的系統。 它們不會在暖轉接的新通話中傳送,亦不會在 ThunderPhone 必須自行接通遭拒絕的轉接時傳送。

轉駁地址內的標頭

部分客戶服務中心只會從轉駁地址(即 REFER 的 Refer-To)讀取情境資訊,而不會從獨立標頭讀取。Twilio、Genesys Cloud 及 Talkdesk 均採用此方式,而且大多預期 User-to-User 使用十六進制格式。在 SIP 地址項目中設定兩個選項:

{
  "name": "Escalation",
  "number": "sip:escalation@talkdesk.example.com",
  "headers": {
    "User-to-User": "autopilot_result={{handoff_summary}}",
    "X-Call-ID": "{{handoff_id}}"
  },
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
  • headers_in_uri: true 會將標頭置於地址內傳送,而非放在 REFER 上: sip:escalation@talkdesk.example.com?User-to-User=…&X-Call-ID=…。系統會為 SIP 地址跳脫處理值,因此 ; 會變為 %3B,空格會變為 %20。
  • 整個地址會保留在 254 個字元以內,連同尖括號計算後仍符合 Twilio 的 256 字元限制。User-to-User 會排在最前,其餘標頭則按字母順序排列。過長的 User-to-User 會被截斷以配合限制,而不會被略去,因此應將平台最需要的部分放在開頭。無法與其一併容納的其他標頭會整個略去,但轉駁仍會繼續。
  • uui_encoding: "hex" 會以十六進制格式傳送 User-to-User,並附加 ;encoding=hex。請以純文字填寫值:系統會在轉駁時,於變數及預留位置填入後才進行編碼。若文字會令編碼後的值超過 256 位元組,系統會先將其截斷。這亦適用於將通話轉回你的客戶服務中心。
  • headers_in_uri 不可與直接寫入地址本身的 ?User-to-User= 一併使用;請改為將該值移至 headers。

使用 Agents API(transfer_destinations) 或內嵌通話設定新增 SIP 位址及標頭。

將通話交回聯絡中心

當通話由你的聯絡中心發出時,智能體可以將通話交回,而非進行轉接:它會道別,ThunderPhone 會掛線,而其傳送的 SIP BYE 會包含路由資料,讓你的平台判斷來電者下一步應轉往何處。新增一個設為 "action": "return" 且不設號碼的轉接號碼:

{
  "name": "Contact center",
  "action": "return",
  "headers": {
    "X-RouteType": "queue",
    "X-RouteValue": "{{queue_id}}",
    "User-to-User": "{{uui}}"
  }
}
  • 提示詞會如同其他轉駁號碼一樣提及它,例如「當來電者要求與專人通話時,轉駁至聯絡中心」。
  • BYE 可攜帶 X-RouteType、X-RouteValue、X-RouteReason、X-CustomMetaData(Five9 會讀取的四個欄位)及 User-to-User,每項均為選填。數值須遵循轉駁時的 SIP 標頭規則:最多 256 位元組、可使用通話變數,並會移除換行符。BYE 亦會攜帶 X-TP-Handoff-Id(請參閱將內容傳遞至你的聯絡中心)。如返回操作沒有標頭,則只會結束通話,而你的平台會如處理任何其他結束通話一樣處理該通話。
  • 它適用於與轉駁至 SIP 位址相同的通話:撥打至 SIP 位址的通話,以及使用手動 SIP 連線號碼的通話。其他通話不會向智能體提供此選項,而 Browser Talk 及模擬作業會拒絕此操作。對它進行暖轉駁時,會以一般返回方式執行。
  • 不會撥出任何號碼,亦不會傳送 REFER。通話會以結束原因 returned_to_platform 結束。
  • 標頭會沿用你的 SIP 中繼設定。在此選項推出前已設定的 SIP 位址及手動 SIP 連線,需要由 ThunderPhone 進行一次性更新;在依賴這些標頭前,請先聯絡支援團隊。

你可透過 Agents API(transfer_destinations)或內嵌通話設定新增回傳選項。當你編輯其他轉接號碼時,控制台會保留你已新增的回傳選項及其標頭。

將背景資料傳遞至你的聯絡中心

在可到達你的聯絡中心的通話中(轉駁至 SIP 位址或返回),智能體可說明來電者所需服務,讓接聽通話的人員或流程無須從頭開始。請在該項目的 headers 中使用三個預留位置:

預留位置包含內容
{{handoff_summary}}來電者所需服務,以及智能體已完成的事項,由智能體於轉駁時撰寫。最多 300 個字元。
{{handoff_intent}}智能體選取的簡短標籤,例如 billing_dispute。最多 60 個字元。
{{handoff_id}}此次轉駁的識別碼,供下方查詢使用。
{
  "name": "Support queue",
  "number": "sip:support@pbx.example.com",
  "headers": {
    "X-Summary": "{{handoff_summary}}",
    "X-Intent": "{{handoff_intent|general}}",
    "X-Handoff-Id": "{{handoff_id}}"
  }
}
  • 這些值會在轉駁當刻填入,而非通話開始時。智能體未填寫的值會留空,或使用你所設定的 |default。
  • 系統會移除換行符號;已填入值超過 256 位元組的標頭會截斷至 256 位元組。無論如何,轉駁仍會繼續。
  • 返回一律會在 BYE 中以 X-TP-Handoff-Id 傳送識別碼,無論其標頭如何設定。
  • 對於電話號碼項目,或無法到達你的聯絡中心的通話,它們屬於一般通話變數:除非通話具有同名變數,否則會留空。其他通話不會取得額外欄位,因此其智能體會維持原有運作方式。

如要取得完整背景資料,請使用你機構的 API 金鑰,以及該通話的 id 或你平台本身的通話 id(external_call_id,來自其隨通話傳送的 call-id 標頭),呼叫 GET /v1/calls/handoff。此呼叫會傳回通話的 id 和狀態、摘要和意圖、通話開始時的 SIP 標頭和變數,以及通話結束後的摘要和擷取資料。

通話可接通的號碼

轉接可接通哪些號碼,取決於承載該轉接的線路。由 ThunderPhone 線路承載的轉接只可接通美國號碼,不包括高收費及其他特殊服務號碼。由 你自己的電訊商承載的轉接,則可接通你已儲存的任何號碼。

轉接承載方
入站通話的冷轉接通話接入時所使用的電訊商:ThunderPhone 號碼使用 ThunderPhone 線路;你自己電訊商的號碼則使用你的電訊商。
出站通話的冷轉接撥出該通話時使用的線路。
暖轉接(通往目標的新通話分支)撥打新通話分支時所使用的線路。

你自己電訊商的號碼只會透過其連線本身的外撥中繼撥打出站通話及暖轉接分支:設有外撥中繼的手動 SIP 連線、已設定外撥通話的 Twilio 連線,以及 Telnyx 連線。如沒有該中繼,該號碼完全無法外撥,因此只支援冷轉接。這些通話絕不會改用 ThunderPhone 的線路。

如你的機構沒有使用自己電訊商的號碼,儲存 ThunderPhone 線路無法接通的號碼時會出現錯誤。連接你自己的電訊商後,這些號碼便可儲存,並會標示為只適用於由你的電訊商承載的轉接(API 中為 platform_ok: false)。同一智能體可接聽兩類號碼,因此系統會在每次通話時執行檢查。

連接前

每個智能體均可選擇暖轉接目的地接聽後的處理方式。此設定適用於該智能體進行的所有暖轉接。

設定API 值處理方式來電者等候情況
在通話中介紹(預設)introduce目的地接聽後,來電者會立即接通並聽到對方的接聽語。接聽者講完後,智能體會以一至兩句讓雙方都聽到的說話介紹來電者,然後斷線。不會向任何人提問。只會響鈴。
先詢問ask_first智能體會私下向接聽者簡介情況,並詢問對方是否可以接聽。對方可提問、接受或拒絕。如對方接受,來電者便會接通,智能體會在通話中介紹來電者,然後斷線。響鈴加上私下對話,通常為 15 秒或以上。
耳語提示whisper智能體會私下以一句簡短說話告知接聽者來電者是誰及來電原因。不會提問。其後會接通來電者,智能體會在通話中不作任何說話便斷線。響鈴加上一句私下說話。

除非接聽者需要能夠拒接通話,或應在來電者加入通話前先了解來電者資料,否則請使用 在通話中介紹。先詢問 可讓對方拒絕,但會令來電者等候更久;留言信箱、無人回應或拒絕均會將來電者帶回智能體。耳語提示 可私下提供背景資料而無需提問;如轉駁至留言信箱,來電者會返回智能體。

通話簡介

「通話簡介」設定會決定智能體向接聽者介紹來電者的方式。使用 接通後介紹 時,雙方接通後都會聽到這段介紹。預設內容非常簡短:說明誰來電及來電原因,例如「你好,我有 Alex 在線上,想查詢訂單。Alex,請講。」使用 先詢問 時,這是在接通來電者前向接聽者說的一句私人訊息,並以詢問對方是否可以接聽作結;對方接受後的介紹亦遵循相同概念。使用 耳語 時,這是在接通來電者前向接聽者說的一句私人訊息,例如「Alex 來電查詢延遲的訂單,現在為你接通。」這是陳述句,而非問題。

如要更改內容,請在智能體中撰寫 通話簡介 指示 (warm_transfer_briefing,最多 300 個字元),例如「來電者姓名、帳戶號碼,以及所需協助。」智能體會在生成每段介紹或簡介時遵循這項指示。請只保留重要事實:超過約 40 個字的介紹或 耳語 句子,或超過約 25 個字的 先詢問 簡介,都會被替換為簡短的標準訊息。留空即可使用預設內容。

暖接期間的運作方式

使用 在線介紹(預設):

  1. 智能體會告知來電者即將開始轉接。通話錄音會停止,而 ThunderPhone 會在智能體仍在說話時,立即使用處理該通話的號碼致電目的地。
  2. 目的地響鈴期間,來電者會短暫靜候,期間沒有聲音。此模式不設等候音樂。
  3. 目的地一接聽,來電者已在線上,因此可從問候語的第一個字開始聽到內容。
  4. 接聽者說完並等待回覆時,智能體會以一至兩句雙方均可聽到的說話介紹來電者,例如「你好,Alex 在線上,想查詢一張訂單。Alex,請說。」智能體會根據對方所說的內容,而非停頓時間作出判斷:錄音通知或「請稍候」不代表對方已說完,「有甚麼可以幫到你?」才代表對方已說完。如對方沒有說話,智能體會在約 3 秒後開始介紹。如對方在介紹期間開始說話,智能體會停止,待對方說完後再重複介紹。約 15 秒後,例如遇上較長的電話選單,智能體仍會介紹來電者。如介紹內容缺失或過長,系統會以通話語言說出簡短的標準語句取代。
  5. 智能體會自動掛線,不會再說任何內容。

任何接聽者均會接通。如為語音留言問候語,智能體不會向其說話並會掛線,讓來電者可以留言。如目的地沒有接聽、線路繁忙、無法撥出通話,或接聽者在介紹結束前掛線,ThunderPhone 會結束該通話,來電者會返回智能體。智能體會收到結果並繼續原有對話。它可以記錄留言、建議其他處理方式,或在來電者仍希望轉接時進行冷轉接。

使用先詢問

  1. 智能體會告知來電者正在開始轉接,然後來電者會在轉接目標響鈴期間聽到等候音樂。
  2. 當轉接目標接聽後,智能體會先讓接聽者完成問候,判定方式與上述相同。如已啟用智能體的同意聲明,接聽者會先聽到該聲明。然後智能體會說出簡介,並詢問對方是否可以接聽電話。正在等候的來電者不會聽到這些內容。
  3. 接聽者可以提問,智能體會根據目前為止的對話作答。如對方接受,系統會接通來電者,智能體會用一至兩句讓雙方都聽到的說話介紹來電者,然後退出通話。
  4. 如對方拒絕、沒有回應,或電話轉駁至留言信箱,ThunderPhone 會結束該通電話,並解除來電者的等候狀態。智能體會取得結果,包括接聽者要求轉達的任何訊息,然後繼續與來電者對話。

此方式不會中斷通話錄音。如智能體啟用通話錄音,與接聽者的私人對話及接通後的通話都會被錄音。如智能體未啟用通話錄音,兩者都不會被錄音。

確認接聽者身分

使用 先詢問 時,項目可透過 answerer(最多 60 個字元)指定轉接對象的姓名,令共用線路或代為接聽的同事不會得知來電者的資訊。智能體其後會:

  1. 開始時只會說「你好,請問是 Matthew Ray 嗎?」,不會提及任何關於來電者的資訊。
  2. 對方確認後,提供簡介並如上所述詢問對方能否接聽該通電話。
  3. 如由其他人接聽,智能體仍不會透露來電者的資訊,並會詢問該人是否在場。如對方把電話交給該人,智能體會再次詢問新接聽者。如未能交接,智能體會禮貌地結束通話,來電者則會返回智能體,而智能體會得知該人未能接聽。

語音信箱會按上述方式處理。身分確認問題目前只支援英文。answerer 在使用 在線介紹 及 耳語 時會被忽略,因為兩者均會在接通前不作任何詢問。設定方式與僅限熱轉接相同,可使用 API 或要求 Zeus 協助。

使用耳語

  1. 智能體會告知來電者正在開始轉接,然後來電者會在轉接目標響鈴期間聽到等候音樂。
  2. 當轉接目標接聽後,智能體會等待接聽者完成問候。如已啟用智能體的同意聲明,接聽者會先聽到該聲明。然後智能體會用一句簡短說話告知對方誰正在來電及來電原因,不會詢問對方是否可以接聽電話。正在等候的來電者不會聽到這些內容。
  3. 系統會接通來電者,然後智能體退出通話。通話線路上不會播放任何介紹。
  4. 如電話轉駁至留言信箱,智能體會結束該通電話,並解除來電者的等候狀態。如轉接目標沒有接聽、線路繁忙,或無法撥出電話,來電者亦會返回智能體。智能體會取得結果,然後繼續與來電者對話。

錄音方式與 先詢問 相同:如智能體啟用通話錄音,私人訊息及接通後的通話都會被錄音。

在提示中讓智能體妥善轉駁來電

在智能體提示中加入路由規則,並按照 轉駁號碼 下方顯示的名稱準確命名每個目的地。請勿在提示中寫入電話號碼;智能體會按名稱轉駁。為每條路由指定轉駁模式,並為失敗的暖轉駁提供備用處理方式。

Transfer policy
 
Confirm the caller's name and reason for calling before any transfer.
 
| Caller needs | Destination | Transfer mode |
| --- | --- | --- |
| A new purchase or plan change | Sales | warm |
| Help with an existing order | Order support | warm |
| The main office | Front desk | cold |
 
For a warm transfer:
- Keep the introduction to one or two short sentences: who is calling and
  why.
- Do not plan to speak after the introduction because you will be dropped.
- If the target does not answer or is busy, tell the caller what happened,
  then offer to take a message or try another route. Do not cold-transfer
  unless the caller asks.

語音智能體在呼叫內建動作時會提供以下欄位:

欄位使用時機用途
destination一律使用智能體其中一個轉駁號碼的名稱。
mode選填cold 或 warm;預設為 cold。
screen_message暖轉駁時必填使用 在線介紹 時,這是接通後來電者及接聽者都會聽到的介紹內容。使用 先詢問 時,這是接聽者在決定前聽到的私人簡報。使用 耳語 時,這是來電者接通前接聽者會聽到的私人句子。來電者不會聽到任何私人內容。
introduction暖轉駁時選填使用 先詢問 時,這是接聽者接受後雙方都會聽到的介紹內容。使用 在線介紹 時,僅在 screen_message 留空時使用。使用 耳語 時不提供此欄位,因為通話線上不會播放任何內容。

你毋須定義或附加名為 transfer_call 的自訂工具。此動作的說明會依照智能體的 接通前 及 簡報 設定,因此提示毋須重複這些內容。

轉接被拒絕時

ThunderPhone 會在進行每次轉駁前檢查。若名稱並非智能體的其中一個轉駁號碼、變數號碼在此通通話中沒有有效值、透過 ThunderPhone 線路進行的轉駁會接駁至美國以外的號碼或高收費號碼,或目的地為 SIP 位址或回撥而通話並非來自你自己的 SIP 系統,ThunderPhone 便會拒絕轉駁(請參閱 轉駁至 SIP 位址)。

轉接被拒絕不會結束通話。智能體不會宣告轉接,會收到拒絕原因(名稱不符時亦包括有效名稱清單),並繼續與來電者交談。請在提示中說明應改為採取甚麼行動,例如記錄留言。拒絕會在通話記錄中顯示為工具錯誤。

私語轉駁

「Whisper 轉駁」是業界對暖轉駁的常用名稱:在接駁來電者之前,接駁目的地會先聽取私密背景資料,而無須被問及是否接聽來電。這就是 連接前 下的 Whisper 設定。

這與 POST /v1/calls/{id}/whisper 不同。該端點讓員工或擁有人在進行中的通話期間,向 AI 語音智能體發送私密文字指示,並不會致電或向轉駁目的地提供簡介。

要求、限制及測試

問題答案
轉駁可接通哪些目的地?使用 ThunderPhone 配發的號碼時,只支援美國號碼,包括免費電話;不支援加拿大、其他 +1 國家及高收費號碼。ThunderPhone 會在撥號前拒絕任何其他目的地:來電者會保持在線,智能體會取得原因並繼續對話(參閱轉駁遭拒時)。如要轉駁至其他國家,請連接你自己的電訊商,並透過其匯入的號碼接聽來電。轉駁其後會經由你的電訊商進行,因此電訊商必須接受通話轉駁,並允許撥打該國家。在 Twilio SIP 中繼上,啟用 通話轉駁 及 啟用轉駁至 PSTN 的通話。
哪些號碼支援暖轉駁?可撥出電話的號碼:透過支援撥出電話的 VoIP 連線匯入並已驗證的號碼,或你的機構的撥出電話申請獲批後的 ThunderPhone 配發號碼。其他 ThunderPhone 號碼只支援冷轉駁。如暖轉駁模式不可用,操作會改為冷轉駁。連接 VoIP 供應商。
哪些通話類型支援?一般電話通話可使用冷轉駁。Browser Talk、小工具、模擬及測試通話無法測試暖轉接。已儲存智能體的 Realtime 不包含 transfer_call;使用 call_events 的內嵌 Realtime 可要求冷轉駁。
沒有已儲存智能體的通話如何處理?設有內嵌 config 的撥出通話或 call.incoming 回應,以及內嵌 Realtime 工作階段,均支援相同的 transfer_destinations 清單。設有清單時,通話只會轉駁至其中的名稱。沒有清單時,智能體會保留可接受電話號碼的轉駁操作,而使用 ThunderPhone 號碼的通話仍只可接通美國號碼。
如何測試?在 Browser Talk 或模擬中檢查路由措辭:你可查看智能體選擇哪個名稱,或查看拒絕結果。兩者均會拒絕轉駁至 SIP 地址或轉回通話,因為它們並非來自你的 SIP 系統;該拒絕並不表示項目設定錯誤。然後使用真實電話致電智能體的號碼,測試完整轉接流程。任何 ThunderPhone 或匯入號碼均可用於冷轉駁;暖轉駁則需要已獲批撥出電話申請的 ThunderPhone 號碼,或支援撥出電話的匯入號碼。
目的地會響鈴多久?ring_duration_seconds 接受 5–120 秒。null 在暖轉駁時使用 45 秒,在冷轉駁時使用電訊商的預設值。一般撥出通話預設為 60 秒,且響鈴時間不會少於 14 秒。此設定不會更改來電響鈴時間。
如果我的電訊商拒絕冷轉駁,會怎樣?一般情況下,你的電訊商會將通話轉交至目的地。部分電訊商連線會拒絕轉駁,例如未啟用通話轉駁(SIP REFER)的 Twilio 中繼。當該通話的號碼可撥出電話時,ThunderPhone 會自行接通通話:系統會撥打目的地,來電者會聽到響鈴聲直至對方接聽,而智能體會在未作介紹的情況下退出。轉駁時會停止錄音。如無人接聽,或該號碼無法撥出電話,通話便會結束。遭拒絕轉駁至 SIP 地址時,通話一定會結束。當某個連線首次拒絕轉駁時,你機構的管理員會收到電郵。在控制台連接 Twilio 帳戶時,允許通話轉駁(預設為開啟)會為其 SIP 中繼啟用轉駁。對於已建立的 Twilio 連線,請在 VoIP 連線頁面使用 開啟通話轉駁。其他電訊商可在其自設入口網站中找到相關設定。
真人橋接可持續多久?智能體接通兩人後,最長可維持 4 小時。使用 在線介紹 時,橋接不會錄音:轉駁開始時便會停止錄音。使用 先詢問 及 耳語 時,如智能體會錄製通話,橋接亦會被錄製。
失敗時會怎樣?在暖轉駁中,如目標未有接聽、正忙,或撥出線路失敗,來電者會連同結果返回智能體。提示詞應定義下一步。冷轉駁已結束智能體在通話中的部分,因此冷轉駁失敗會結束通話。
費用如何計算?不設轉駁工具費用。一般通話收費包括智能體退出前的暖轉駁流程。AI 退出暖轉駁後,ThunderPhone 會保持兩人連線,並按每分鐘橋接費率收費;詳情請參閱定價。冷轉駁會在轉接時停止計費。當 ThunderPhone 自行接通遭拒絕的冷轉駁時,已接通的時間會按相同橋接費率收費。使用匯入的 VoIP 號碼時,兩人維持連線期間,你的電訊商可能會繼續就轉駁線路收費。

Webhook 及結束原因

完成資料載荷會在 transfer_number 記錄目標號碼,並使用以下其中一個 結束原因:

end_reason含義
ai_transfer智能體發起了冷轉接。
ai_warm_transfer目的地接聽了暖轉接,雙方已接通,智能體隨即退出。
returned_to_platform智能體將通話轉回你的聯絡中心。未設定 transfer_number。

無人接聽、佔線或失敗的暖轉駁嘗試,不會視為已完成的轉駁。來電者會返回智能體,因此最終的結束原因會反映 原始通話如何結束。

如暖轉駁成功,完成事件及 AI 通話的結束原因會在 AI 退出時記錄,即雙方接通後隨即記錄。 使用 在線介紹 時,錄音會涵蓋轉駁前的通話內容,並於該處結束(recording_stopped_at);兩人之間的對話不會被錄音或轉錄。使用 先詢問 及 耳語 時,錄音(如智能體有錄製通話)會持續至已接通的通話結束。

舊版完成 Webhook

舊版單一 URL Webhook 可透過傳回 {"transfer_ready": false},並在其後更新通話的 轉接就緒狀態,將冷轉接延遲最多五分鐘。Webhook 端點傳送及暖轉接不會 使用此協調機制。

請參閱完成 Webhook,了解完整資料載荷及 舊版行為。

疑難排解

智能體轉接時通話中斷

檢查目的地所屬國家。ThunderPhone 號碼的通話僅支援轉接至美國號碼。電訊營運商可能拒絕轉接至其他國家,導致來電者斷線,而通話仍會以 ai_transfer 結束。如要接通其他國家, 連接你自己的電訊營運商,並透過從該營運商匯入的號碼路由通話。電訊營運商必須接受通話轉接,並允許撥打該國家。在 Twilio SIP 中繼上,啟用 通話轉接 及 啟用轉接至 PSTN 的通話轉接。

智能體執行直接轉接而非預先接通轉接

檢查通話是否使用可撥打外線的號碼:已驗證、已匯入且外撥路由正常運作的 VoIP 號碼,或已獲批准外撥功能的 ThunderPhone 號碼。其他號碼及非電話工作階段的工具選項不會顯示暖轉模式。另請在提示詞的路由表中明確指定模式。如要讓某個目的地一律使用暖轉,請為其設定僅限暖轉。

目標對象一直未接聽

確認你的 VoIP 中繼線路可向目的地撥打外撥電話,並確保其驗證及路由規則為最新。檢查儲存於 轉接號碼 下的號碼。如 45 秒對暖轉接而言太短,請增加 ring_duration_seconds。

目標對象轉駁至留言信箱

使用 在線介紹 時,來電者會接通至任何接聽的一方, 包括語音信箱問候語。智能體會辨識問候語,不會在信箱中說話便掛線,來電者則可留言。使用 先詢問 和 耳語 時,智能體會在偵測到語音信箱後掛線,來電者會返回智能體。如某個目的地經常轉至語音信箱,請在提示中為智能體提供另一條路線。

直接轉接在接通前等待

如你使用舊版單一 URL webhook,請檢查它是否回傳 {"transfer_ready": false}。ThunderPhone 等候期間,來電者會聽到等候音樂。 目的地準備就緒後,更新通話的可轉接狀態。

智能體表示無法轉接

確認智能體設有轉接號碼,且提示使用相同名稱。沒有轉接號碼的智能體完全不會有轉接操作。如轉接經由 ThunderPhone 線路進行(請參閱 通話可接通的號碼),目的地必須是非高收費的美國號碼。使用變數號碼時,確認通話變數包括該號碼的有效電話號碼。

部署因轉接號碼錯誤而失敗

每次部署都會重新檢查已儲存的轉接號碼。若你的組織曾使用自有電訊營運商而儲存非美國號碼,當該組織不再擁有相關號碼時,檢查便會失敗。移除該號碼,或再次連接你自己的電訊營運商。

員工耳語不會啟動轉接

即時通話耳語功能只會向 AI 提供指導。請在智能體提示詞中加入轉接指示, 並讓它呼叫 transfer_call。請參閱 監察即時通話。