將任何 SIP 供應商的中繼連接到 Wixzel Voice
若要在任何電信業者的號碼上執行 AI 語音代理，請將該電信業者的 SIP 中繼連接到 Wixzel Voice：將中繼回傳的 platform_ip 加入允許清單，讓外撥通話被接受，並將來電送到它的 origination_uri。您的電信業者會繼續以您的費率向您收取線路費用；Wixzel Voice 則從預付餘額中按秒收取語音引擎的費用。
最後更新於
發布於
Wixzel Voice開始之前需要準備什麼？
- 任何電信業者的 SIP 中繼，包括它的主機；如果使用註冊方式，還需要使用者名稱和密碼。
- 一個您在 您的電信業者 擁有的電話號碼，並已附加到該中繼。Wixzel Voice 不販售號碼，也不提供號碼移轉。
- 一把 Wixzel Voice API 金鑰和一些預付點數。最低儲值金額為 $5；沒有免費方案。
- Wixzel Voice 預設每個帳號可同時進行 5 通通話，可依需求提高；網頁和應用程式工作階段也計入同一個上限。
如何在 Wixzel Voice 中建立中繼？
您的電信業者為中繼提供的 SIP 主機。
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My carrier",
"host": "sip.carrier.example",
"transport": "udp"
}'如果 您的電信業者 以憑證而非 IP 進行驗證，請在 body 中加入 username 和 password。密碼會加密儲存，API 之後也不會再回傳。回應中包含 platform_ip 和 origination_uri：下一步需要這兩個值。
要在 您的電信業者 設定什麼？
| 設定 | 您的電信業者 的名稱 | 值 |
|---|---|---|
| 允許來自 Wixzel Voice 的通話 | IP ACL、允許清單或授權位址 | 187.126.120.231 |
| 將來電送到 Wixzel Voice | Origination URI，或電信業者對它的稱呼 | sip:187.126.120.231:5090 |
兩個值都以當下為準：請從 GET /v1/sip-trunks 讀取 platform_ip 和 origination_uri，不要從頁面上複製。接著用 POST /v1/phone-numbers 將每個號碼註冊到中繼，並設定 inbound_agent_id，讓代理接聽。 AI 電話通話 API 逐步說明中有這些請求，任何 SIP 供應商 的完整設定步驟則逐一說明主控台中的每個欄位。
在不熟悉的電信業者上會出什麼問題？
- 開放的 SIP 連接埠一出現，幾小時內就會被掃描以進行話費詐騙。請保持開啟您電信業者自己的防詐騙控管。
- 有些市場的外撥通話需要先通過身分驗證。尚未完成 KYC 的帳號，或市場要求時尚未完成目的地註冊的帳號，即使餘額為正，每通外撥仍可能立即被掛斷。
- 電信業者的預付餘額是必要條件，但不是充分條件。請確認帳號上已開通特定的目的地號段，而不只是確認有點數。
為什麼透過 您的電信業者 的通話沒有接通？
在 您的電信業者 上最常見的失敗代碼：
| failure_code | 電信業者回報 | 意思 | 處理方式 |
|---|---|---|---|
| 1 | 404 | 電信業者無法辨識此號碼。 | 檢查號碼格式。如果電信業者需要技術撥號前綴，請在中繼上設定 dial_prefix。 |
| 3 | - | 電信業者沒有通往此目的地的路由。 | 您的電信業者帳號可能未開通此目的地。請要求電信業者開通該路由。 |
| 28 | 484 | 電信業者拒絕了此號碼格式。 | 如果電信業者需要技術撥號前綴，請在中繼上設定 dial_prefix。 |
| 102 | 408 | 電信業者未及時回應。 | 確認中繼的 host 和 port，以及電信業者是否接受來自 platform_ip 的 SIP。如果電信業者顯示通話已收到但從未接聽，請將 send_plus 設為 false。 |
被 您的電信業者 拒絕的通話會帶有 status: "failed"、failure_code（電信業者回傳的 Q.850 原因碼），以及說明該怎麼處理的 failure_reason，而且不會產生任何費用。 所有失敗代碼、所有拒絕原因，以及如何為中繼除錯都在電信業者頁面上。
透過 您的電信業者 的 AI 通話費用是多少？
您的電信業者以您的費率向您收取線路費用；Wixzel Voice 只收取語音引擎的費用，依實際用量按秒計費，從 gemini-live 的每接通分鐘 $0.0491，到 deepgram-agent 的 $0.1851。 每個引擎的價格。
常見問題
這裡沒有指南的電信業者也能搭配 Wixzel Voice 使用嗎？
我的電信業者回應 408 Request Timeout。我該修改什麼？
PATCH /v1/sip-trunks/{id} 將中繼上的 send_plus 設為 false。許多批發電信業者無法解析 request URI 開頭的 +：它們接受了 INVITE，卻無法路由，最後逾時。設定 dial_prefix 也有相同的效果，因為技術前綴是逐字比對的，+ 會被移除。其他電信業者
Elastic SIP Trunking。將平台 IP 加入 Termination IP ACL 允許清單，並為來電設定 Origination SIP URI。
以 IP 驗證的 SIP Connection。將平台 IP 加入為授權位址、選擇來電區域，並讓傳輸協定一致。
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.
中繼的兩個部分如何運作、所有失敗代碼，以及每份電信業者指南，都在同一頁。