將 Telnyx SIP 中繼連接到 Wixzel Voice
若要在 Telnyx 號碼上執行 AI 語音代理，請將 Telnyx SIP Connections 連接到 Wixzel Voice：將中繼回傳的 platform_ip 加入 authorised addresses on an IP-authenticated SIP Connection，讓外撥通話被接受，並將來電送到 它的 origination_uri，讓來電能夠抵達。Telnyx 會繼續以您的費率向您收取線路費用；Wixzel Voice 則從預付餘額中按秒收取語音引擎的費用。
最後更新於
發布於
Telnyx 是電信業者；Wixzel Voice 是在其上執行代理的語音 AI API。兩者透過標準 SIP 協同運作。Telnyx 是其所有者的商標，Wixzel Voice 與 Telnyx 沒有關聯，也未獲得 Telnyx 的背書。
Wixzel Voice開始之前需要準備什麼？
- 具備 SIP Connections 的 Telnyx 帳號，以及中繼的主機和憑證。
- 一個您在 Telnyx 擁有的電話號碼，並已附加到該中繼。Wixzel Voice 不販售號碼，也不提供號碼移轉。 如果您從主控台連接 Telnyx 帳號，也可以從「電話號碼」頁面在該帳號上購買號碼。Telnyx 會以其價格計費。
- 一把 Wixzel Voice API 金鑰和一些預付點數。最低儲值金額為 $5；沒有免費方案。
- Wixzel Voice 預設每個帳號可同時進行 5 通通話，可依需求提高；網頁和應用程式工作階段也計入同一個上限。
如何在 Wixzel Voice 中建立 Telnyx 中繼？
Mission Control 為您的連線顯示的 SIP 位址。設定指南沒有列出 Telnyx 的主機，請從主控台複製，而不是從這裡。
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Telnyx",
"host": "<the SIP host Telnyx shows for the connection>",
"transport": "udp"
}'如果 Telnyx 以憑證而非 IP 進行驗證，請在 body 中加入 username 和 password。密碼會加密儲存，API 之後也不會再回傳。回應中包含 platform_ip 和 origination_uri：下一步需要這兩個值。
要在 Telnyx 設定什麼？
| 設定 | Telnyx 的名稱 | 值 |
|---|---|---|
| 允許來自 Wixzel Voice 的通話 | authorised addresses on an IP-authenticated SIP Connection | 187.126.120.231 |
| 將來電送到 Wixzel Voice | 來電的目的地；設定步驟中會指出是哪個欄位 | sip:187.126.120.231:5090 |
兩個值都以當下為準：請從 GET /v1/sip-trunks 讀取 platform_ip 和 origination_uri，不要從頁面上複製。接著用 POST /v1/phone-numbers 將每個號碼註冊到中繼，並設定 inbound_agent_id，讓代理接聽。 AI 電話通話 API 逐步說明中有這些請求，Telnyx 的完整設定步驟則逐一說明主控台中的每個欄位。
在 Telnyx 上會出什麼問題？
- 傳輸協定不一致時，看起來就像電信業者不理您。請讓連線和中繼使用相同的傳輸協定；兩者預設都是 UDP。
- Telnyx 要求號碼前面有
+，因此請將send_plus保持預設值true。
為什麼透過 Telnyx 的通話沒有接通？
在 Telnyx 上最常見的失敗代碼：
| failure_code | 電信業者回報 | 意思 | 處理方式 |
|---|---|---|---|
| 102 | 408 | 電信業者未及時回應。 | 確認中繼的 host 和 port，以及電信業者是否接受來自 platform_ip 的 SIP。如果電信業者顯示通話已收到但從未接聽，請將 send_plus 設為 false。 |
被 Telnyx 拒絕的通話會帶有 status: "failed"、failure_code（電信業者回傳的 Q.850 原因碼），以及說明該怎麼處理的 failure_reason，而且不會產生任何費用。 所有失敗代碼、所有拒絕原因，以及如何為中繼除錯都在電信業者頁面上。
透過 Telnyx 的 AI 通話費用是多少？
Telnyx 以您的費率向您收取線路費用；Wixzel Voice 只收取語音引擎的費用，依實際用量按秒計費，從 gemini-live 的每接通分鐘 $0.0491，到 deepgram-agent 的 $0.1851。 每個引擎的價格。
常見問題
哪種 Telnyx 連線類型可以搭配 Wixzel Voice？
platform_ip 加入為授權位址。為什麼變更傳輸協定後，我的 Telnyx 通話就無法接通？
transport 是 tcp 或 tls，就必須將 Telnyx 連線上的 SIP Transport Protocol 改為相同，否則兩端無法溝通。其他電信業者
Elastic SIP Trunking。將平台 IP 加入 Termination IP ACL 允許清單，並為來電設定 Origination SIP URI。
Zentrunk。一個在 IP ACL 中加入平台 IP 的外撥中繼，以及一個 Primary URI 指向平台的獨立來電中繼。
Programmable SIP。在 SIP Dashboard 中將平台 IP 加入中繼的 ACL，並將來電送到 origination URI。
不支援 SIP REGISTER，因此必須使用固定 IP。將平台 IP 加入 location，分別設定 Termination 和 Origination，或使用 network bridge 憑證。
Virtual SIP Trunking (vSIP)，適用於印度號碼，透過 TCP。將平台 IP 以 ACL 對應到中繼，並將 Destination URI 指向平台的 TCP 連接埠以接收來電。
以每條中繼專屬的 SIP 網域作為主機，將平台 IP 加入中繼的 IP ACL，而「origination URI」的意思與 Twilio 上相反。
Saudi Arabia, ordered through Mobily Business sales and delivered over a private link. No one-step connect: your own SBC on the link relays calls, with G.711 A-law and a one-hour call cap.
各家的做法都相同：將平台 IP 加入允許清單、將來電目的地設為 origination URI，並讓號碼格式和傳輸協定一致。
中繼的兩個部分如何運作、所有失敗代碼，以及每份電信業者指南，都在同一頁。