連接 VoIP 供應商

連接你現正使用的供應商（透過 API 金鑰連接 Twilio 或 Telnyx；透過 SIP 連接 SignalWire、Vonage、Plivo 或任何 SIP 中繼），或透過引導設定開設新的 Telnyx 帳戶。

正式流量應透過你擁有、並由自己 VoIP 供應商提供嘅號碼運行。控制台嘅 連接 → VoIP 頁面 （/dashboard/voip-connections）可連接你嘅供應商帳戶；連接後，你可以匯入支援撥入及撥出 通話嘅號碼。

按一下 新增連接，然後選擇以下其中一種方式：連接你目前使用的供應商，或 設定新的 Telnyx 帳戶。

連接你正在使用的供應商#

選擇你的號碼所屬供應商：

如使用 Twilio 或 Telnyx，貼上憑證後按一下 連接並測試。ThunderPhone 會驗證憑證，並 為你設定供應商端。 如使用 Telnyx，ThunderPhone 會在你的 Telnyx 帳戶中新增一個由其管理的 SIP 連線 （名稱為 thunderphone-production-<org>-outbound-<id>），並透過該連線撥出 電話，因此 Telnyx 會向你收取這些通話費用。它會使用你的號碼所屬 Telnyx 連線的撥出語音設定檔，因此該設定檔允許的目的地國家及開支上限均會適用。如該 連線沒有撥出語音設定檔，而你的帳戶剛好有一個已啟用的設定檔，ThunderPhone 便會使用該設定檔。如要使用其他設定檔，請在 Telnyx 控制台將其指派至該連線， 然後再次儲存 ThunderPhone 連線。如帳戶沒有已啟用的設定檔， 或有多個已啟用的設定檔，請在 Telnyx 控制台將其中一個指派至該連線，然後再次 儲存 ThunderPhone 連線。在此之前，撥出電話會因 outbound_trunk_unavailable 而失敗；來電則會繼續正常運作。

當 Telnyx 拒絕撥出電話時（例如 SIP 403 禁止），該拒絕來自你自己的 Telnyx 帳戶。常見原因包括沒有可用餘額、主叫號碼不屬於該 Telnyx 帳戶， 或撥出語音設定檔不允許目的地 國家。

SignalWire、Vonage 及 Plivo 的 SIP 設定#

這三個供應商都會開啟手動 SIP 表格，其中 頂部列出該供應商的設定步驟、供應商自家設定指南的連結，以及範例 SIP 網域：

• SignalWire：建立用於撥出電話的 SIP 憑證，輸入 SIP 網域、使用者名稱及密碼，並為每個號碼設定一個 SWML 指令碼， 將來電連接至 ThunderPhone SIP 端點。
• Vonage：在 SIP Trunking 控制台建立具有 撥出憑證的 SIP 中繼，輸入其網域（例如 your-trunk.sip-us.vonage.com）及憑證，將 ThunderPhone SIP 端點加入為該中繼的入站 SIP URI，並將 你的號碼連結至該中繼。
• Plivo：建立具有憑證的撥出中繼，並輸入其 終止 SIP 網域（<trunk-id>.zt.plivo.com）、使用者名稱及 密碼；建立一個入站中繼，其主要 URI 為 ThunderPhone SIP 端點，後接 ;transport=tcp；然後將每個 號碼的應用程式類型設為該中繼。

結果是一個手動 SIP 連線（API 中為 provider: "manual"），其 測試及驗證方式與手動輸入的連線完全相同。連線卡會顯示供應商名稱，例如 SignalWire · SIP。

設定新的 Telnyx 帳戶#

尚未有供應商？引導流程會帶你開設 Telnyx 帳戶並將其連接：

1. 建立帳戶

   按一下 開啟 Telnyx 註冊頁面，建立帳戶，然後勾選 「我已建立帳戶」。

2. 取得 API 金鑰

   按一下 開啟 API 金鑰頁面，產生金鑰，然後貼上至 API 金鑰（v2）。你亦可為連接命名。

3. 連接及測試

   按一下 連接及測試 —— ThunderPhone 會驗證憑證， 並在儲存前於 Telnyx 端配置所需項目。

ThunderPhone 在 Telnyx 中設定的項目#

除非你輸入自己的 Connection ID，否則兩種 Telnyx 路徑（引導設定及貼上 API 金鑰）都會在你的 Telnyx 帳戶中建立相同項目：一個名為 thunderphone-<your organization id> 的 SIP 連線。這是一個 FQDN 連線， 其 FQDN 記錄指向 ThunderPhone 的 SIP 端點，而你匯入的每個號碼都會指派至此連線。Telnyx 會透過 SIP 將這些號碼的來電直接傳送至 ThunderPhone。

• 其 webhook 欄位刻意留空。不涉及 webhook、Call Control 應用程式、TeXML 應用程式或已註冊的 SIP 電話。
• 請勿將已匯入的號碼移至其他連線或應用程式，亦不要對其註冊裝置。
• 如你在連接時輸入自己的 Connection ID，ThunderPhone 會改用該連線，且絕不會變更它；該連線必須是指向 ThunderPhone SIP 端點的 FQDN 連線。

在 2026 年 8 月 30 日前，ThunderPhone 建立的 thunderphone-… 連線為 憑證連線，無法接收來電。 如你的連線仍顯示為憑證連線，請聯絡支援團隊，我們會為你轉換。

手動 SIP 設定#

SignalWire、Vonage 及 Plivo 圖塊會開啟此表單，而在 其他供應商 下選擇 我會自行輸入所有設定 亦會開啟此表單。任何 SIP 中繼都可使用，包括 DIDWW 或你自行運行的 PBX。 輸入連線名稱、SIP 網域 / URI、 選填的使用者名稱及密碼、連接埠和傳輸方式；進階 設定 可加入媒體加密（SRTP）。表單亦會顯示你的 SIP 中繼必須將來電傳送至的 SIP 位址：sip.thunderphone.com， UDP 或 TCP 使用連接埠 5060，TLS 則使用 5061。透過 TLS 時，SIP 訊號會一直保持加密，直達 ThunderPhone 處理通話所在的 LiveKit Cloud； 音訊絕不會經過 sip.thunderphone.com，因此 SRTP 可如常運作。請以 E.164 格式的已撥號碼為每通電話定址， 並在請求行及 To 標頭中使用相同號碼，包括 +：例如 sip:+14155550142@sip.thunderphone.com。+ 可讓 ThunderPhone 在正確的區域處理通話（請參閱 IP 允許清單下的說明）。 早前以 <your-project>.sip.livekit.cloud 位址設定的中繼，在 允許的來源 IP 留空時會繼續運作；你無需更改它們。ThunderPhone 會將這些設定轉換為 LiveKit Cloud 上一對專用的 SIP 中繼：從連線號碼發出的 去電會使用你的憑證傳送至你的 SIP 網域；而撥打這些號碼的來電， 則會接受來自任何位址的通話，除非你填寫選填的 允許的來源 IP 欄位。 只有在你的電訊商公布固定訊號 IP 時才應填寫：錯誤或不完整的清單會令 ThunderPhone 拒絕電訊商的來電。 以下兩個按鈕可處理主要工作：

• 產生 AI 設定指南——為你所需的中繼端設定編寫供應商專屬指示。
• 測試並儲存連線——檢查 SIP 端點是否解析至公開位址，並在 TCP／TLS 情況下檢查所選連接埠是否接受連線（UDP 主機只會進行 DNS 檢查），然後 儲存。由於連線尚未有任何號碼，目前仍無法撥打電話；真正的驗證會在匯入 時進行（如下）。

日後編輯連線時，系統會先就你修改的 設定重新執行相同檢查，然後才儲存任何內容，接著重新建立中繼，並在背景以簡短測試通話重新驗證連線上的每個號碼——號碼會顯示為 佈建中，直至測試 通話成功為止。只更改 已連線 連線的 允許的來源 IP 則不同：這絕不影響去電，因此 ThunderPhone 會立即更新來電中繼上的清單，而號碼會維持 啟用中。其來電測試會重設為 未測試； 請再次執行測試，或透過你的電訊商撥打實際通話，以確認新清單允許通話進入。當測試通話會根據清單遭拒絕時，測試便會失敗。系統絕不會再次顯示已儲存的密碼；如要保留密碼，請將密碼欄留空；如使用 IP 驗證的中繼，請勾選「移除已儲存的密碼」。

IP 允許清單及中繼驗證#

部分電訊服務供應商（DIDWW、Telnyx 採用 IP 驗證的連線，以及大部分位於防火牆後的 PBX）只接受來自你允許清單內地址的 SIP 流量，或按來源 IP 驗證撥出通話。ThunderPhone 使用兩組地址。

SIP 邊緣節點。 你傳送至 sip.thunderphone.com 的入站通話會經過 ThunderPhone 的 SIP 邊緣節點，該節點只承載 SIP 信令。首個 INVITE 會傳送至 sip.thunderphone.com；其餘通話信令（ACK、掛斷、轉接）則在你的電訊服務供應商與接聽通話的邊緣伺服器 sip-1 或 sip-2 之間傳送。如你的防火牆會過濾 SIP 信令，請在 UDP 和 TCP 連接埠 5060，以及 TLS 連接埠 5061，允許以下全部三個地址：

LiveKit Cloud。 每個通話的音訊（RTP）及撥出通話的 SIP 信令，均在你的電訊服務供應商與 LiveKit Cloud 之間傳送，絕不會經過 SIP 邊緣節點。請為 SIP 信令及媒體允許以下所有範圍：

LiveKit 將這些範圍套用至 Realtime、SIP 訊號與媒體，以及 Webhooks，並涵蓋其加拿大、歐盟、印度、日本及美國區域處理的通話。固定端點的區域名稱為：canada、eu、india、japan、us。

以下是中繼本身的一些實用原則：

• ThunderPhone 不會註冊。 ThunderPhone 絕不會向你的電訊服務供應商傳送 SIP REGISTER，因此請將中繼線設定為使用 IP 及／或認證資料（用戶名稱 + 密碼）驗證，而非註冊。
• 撥出通話應使用認證資料。 在電訊服務供應商端啟用用戶名稱／密碼驗證，並在手動 SIP 表單中輸入相同值。請將 IP 允許清單視為第二層保護，而非唯一保護措施——撥往涵蓋地區以外目的地的通話，可能由其他地址發起。
• 入站方向則相反。 表單中的可選 允許的來源 IP 欄位，讓你輸入你的電訊服務供應商的信令地址，讓 ThunderPhone 只接受來自該等地址的通話。請輸入 IP 位址或 CIDR 範圍；主機名稱永遠不會相符。除非你的電訊服務供應商發佈固定清單，否則請留空。ThunderPhone 會在每個入站通話中，按其 SIP 邊緣節點所見的地址檢查清單，因此設定清單後，請將通話傳送至 sip.thunderphone.com。來自不在清單內地址的通話，或直接傳送至 <your-project>.sip.livekit.cloud 地址的通話，均會被拒絕：通話會失敗，或接通後立即結束。

LiveKit 於 區域、區域端點及靜態 IP 發布這些範圍；ThunderPhone 每星期會檢查該頁面，並在內容變更時更新本指南。

連接後#

從 Phone Numbers → Add number → Connect VoIP provider 匯入號碼（或直接透過連線匯入）。每個匯入的號碼均會在啟用前完成驗證。對於手動 SIP 連線，驗證程序會由你的號碼，經由你的 SIP 中繼，撥打至 ThunderPhone 號碼進行一次短暫（數秒）的測試通話——以實際方式測試使用者名稱、密碼、傳輸協定，以及你的電訊供應商的撥出路由設定。你的電訊供應商會按一般通話方式為此通話收費。

如電訊供應商拒絕該通話，號碼會維持於 Provisioning 狀態，而電話號碼頁面會顯示電訊供應商的回覆（例如「rejected ThunderPhone's credentials (SIP 401)」）；請修正連線後再次驗證。如電訊供應商接受中繼，但其路由方案不涵蓋 ThunderPhone 的測試號碼（DIDWW 回覆「Destination number blacklisted by routing plan」），號碼會顯示為 Verified · carrier accepted：該號碼可供使用，但未有測試撥打至其他目的地的通話。該通話證明你的中繼可以該號碼撥出通話；這並不代表你擁有該號碼，亦不會測試撥入至該號碼的通話；下方的可選撥入測試才會進行此項測試。已驗證的號碼支援撥入及撥出——讓你可使用 撥出活動及以程式方式進行的 撥出通話。

來電測試#

驗證號碼會開啟一個對話框，亦可測試來電。測試會致電你的號碼，確認通話能否到達 ThunderPhone，然後在不啟動你的智能體下掛斷：

• 設有自訂外撥 SIP trunk 的號碼（手動 SIP 號碼，以及 ThunderPhone 已在你的 Twilio 帳戶設定外撥通話後的 Twilio 號碼）會先致電自身：ThunderPhone 會透過該 trunk，以該號碼撥打該號碼。對話框會在撥號前通知你。通話會經你的電訊商撥出，如你的入站路由設定正確，便會直接返回 ThunderPhone。當通話以該號碼本身的來電顯示返回時，這一次通話即可同時證明你的電訊商接受 ThunderPhone 以該號碼撥出的通話，以及撥往該號碼的通話可到達 ThunderPhone，適用於任何國家。部分電訊商會拒絕或無法接通由號碼致電自身的通話；這並不反映你的路由設定，因此 ThunderPhone 會改為使用其自有號碼撥打。如你的號碼轉駁至其他地方，該電話可能會響兩次：第一次顯示該號碼本身的來電顯示，第二次則顯示 ThunderPhone 的測試號碼。
• 其他號碼（以及上述後備方案）會由 ThunderPhone 的其中一個自有號碼撥打。目前 ThunderPhone 只能撥打美國及加拿大號碼；對於其他號碼，測試會顯示無法執行，若自撥通話遭拒絕，亦會顯示你的電訊商回覆。

如你的電訊商在途中更改來電顯示，ThunderPhone 無法辨識該通話，因此你的智能體可能會短暫接聽。來電測試為選用功能。你可略過測試，號碼仍可正常運作；電話號碼頁面會顯示 未測試來電，你亦可稍後使用 測試 或該號碼的 測試來電 選單項目執行測試。完成匯入後，電話號碼頁面亦會要求你測試新號碼的來電。在你於對話框確認前，不會撥出任何通話。

如你的供應商將號碼轉駁至其他地方，該號碼指向的目標每次通話可能會響最多 8 秒，之後 ThunderPhone 才會掛斷。如有其他項目先接聽（例如先接聽再轉駁的 Twilio 應用程式或電話選單），測試會等待轉駁通話到達 ThunderPhone：自撥通話最多等待 8 秒，而由 ThunderPhone 號碼撥出的通話最多等待 15 秒。結果會保留在該號碼上（來電 通過或失敗），直至你變更連線或重新匯入號碼，才會重設為 未測試。變更連線會在背景重新驗證外撥通話，但絕不會在未經你同意下撥打你的號碼。

疑難排解撥入通話#

連線的 測試 按鈕會檢查憑證，而驗證則會檢查撥出功能。若要檢查撥入通話，請執行上述的來電測試， 或使用電話撥打該號碼，並在 通話記錄 中查看該通話。 瀏覽器 通話 測試及智能體對智能體模擬不會經過你的電訊服務供應商，因此無法顯示撥入功能是否正常。以電話號碼為目標的模擬（SIP 迴環） 會透過你的電訊服務供應商撥打該號碼，因此已接聽的模擬會測試撥入路由。

• 你聽到自己流動電訊服務供應商的訊息（例如「歡迎使用 Verizon」或「你所撥打的號碼暫未提供服務」）：通話在到達 ThunderPhone 前已失敗。請確認該號碼在你的服務供應商帳戶中仍然有效，並已指派至 ThunderPhone 連線或中繼。
• 忙線訊號或通話響至自動掛斷：服務供應商已接受通話，但未能轉接。使用 Telnyx 時，請在 Telnyx 管理入口檢查該號碼的 連線：應為上文所述的 thunderphone-… FQDN 連線，或指向 ThunderPhone SIP 端點的自訂 FQDN 連線。使用 Twilio 時，該號碼應連接至 ThunderPhone SIP 中繼，而非 Voice webhook 或 TwiML 應用程式。
• 你的電訊服務供應商記錄顯示 404 No trunk found（手動 SIP）：通話已到達 ThunderPhone，但未符合任何中繼。請確認該號碼已匯入此連線，且中繼指向 sip.thunderphone.com。如中繼指向 <your-project>.sip.livekit.cloud 位址，允許的來源 IP 位址 必須留空：設定清單後，只會接受傳送至 sip.thunderphone.com 的通話。
• 來自 sip.thunderphone.com 的 404 Not Found（手動 SIP）：通話並非定址至電話號碼，或要求行與 To 標頭指定不同號碼。請如上所述，在兩者中填入已撥號碼。
• 來自 sip.thunderphone.com 的 403 Forbidden：要求行指定了另一個主機。請將通話定址至 sip.thunderphone.com，例如 sip:+14155550142@sip.thunderphone.com。
• 通話到達 ThunderPhone，但由錯誤的智能體接聽，或無人接聽：請在 電話號碼 檢查該號碼的撥入智能體。

應用程式內的智能助理可為你檢查號碼：向它查詢該號碼的通話為何失敗。對於 Telnyx 連線，智能助理亦可為機構管理員以唯讀方式查詢 Telnyx 將該號碼指派至哪個連線。

後續步驟#