將 Vonage SIP 中繼連接到 Wixzel Voice
若要在 Vonage 號碼上執行 AI 語音代理，請將 Vonage Programmable SIP 連接到 Wixzel Voice：將中繼回傳的 platform_ip 加入 ACL (Access Control List)，讓外撥通話被接受，並將來電送到 它的 origination_uri，讓來電能夠抵達。Vonage 會繼續以您的費率向您收取線路費用；Wixzel Voice 則從預付餘額中按秒收取語音引擎的費用。
最後更新於
發布於
Vonage 是電信業者；Wixzel Voice 是在其上執行代理的語音 AI API。兩者透過標準 SIP 協同運作。Vonage 是其所有者的商標，Wixzel Voice 與 Vonage 沒有關聯，也未獲得 Vonage 的背書。
Wixzel Voice開始之前需要準備什麼？
- 具備 Programmable SIP 的 Vonage 帳號，以及中繼的主機和憑證。
- 一個您在 Vonage 擁有的電話號碼，並已附加到該中繼。Wixzel Voice 不販售號碼，也不提供號碼移轉。 如果您從主控台連接 Vonage 帳號，也可以從「電話號碼」頁面在該帳號上購買號碼。Vonage 會以其價格計費。
- 一把 Wixzel Voice API 金鑰和一些預付點數。最低儲值金額為 $5；沒有免費方案。
- Wixzel Voice 預設每個帳號可同時進行 5 通通話，可依需求提高；網頁和應用程式工作階段也計入同一個上限。
如何在 Wixzel Voice 中建立 Vonage 中繼？
Vonage SIP Dashboard 為中繼顯示的 SIP 位址。設定指南沒有列出 Vonage 的主機，請從 Dashboard 複製。
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Vonage",
"host": "<the SIP host of your Vonage trunk>",
"transport": "udp"
}'如果 Vonage 以憑證而非 IP 進行驗證，請在 body 中加入 username 和 password。密碼會加密儲存，API 之後也不會再回傳。回應中包含 platform_ip 和 origination_uri：下一步需要這兩個值。
要在 Vonage 設定什麼？
| 設定 | Vonage 的名稱 | 值 |
|---|---|---|
| 允許來自 Wixzel Voice 的通話 | ACL (Access Control List) | 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 逐步說明中有這些請求，Vonage 的完整設定步驟則逐一說明主控台中的每個欄位。
在 Vonage 上會出什麼問題？
- Vonage 會公布它傳送流量給您時使用的 IP 範圍。Wixzel Voice 這端不需要為它們開放任何東西，但如果您自己的防火牆位於路徑中的其他位置，就要允許那份清單。
- 請選擇 Programmable SIP，而不是 Vonage 另一個名稱帶有 SIP 的產品；只有 Programmable SIP 的運作方式類似彈性中繼。
為什麼透過 Vonage 的通話沒有接通？
被 Vonage 拒絕的通話會帶有 status: "failed"、failure_code（電信業者回傳的 Q.850 原因碼），以及說明該怎麼處理的 failure_reason，而且不會產生任何費用。 所有失敗代碼、所有拒絕原因，以及如何為中繼除錯都在電信業者頁面上。
透過 Vonage 的 AI 通話費用是多少？
Vonage 以您的費率向您收取線路費用；Wixzel Voice 只收取語音引擎的費用，依實際用量按秒計費，從 gemini-live 的每接通分鐘 $0.0491，到 deepgram-agent 的 $0.1851。 每個引擎的價格。
常見問題
使用 Wixzel Voice 需要哪個 Vonage 產品？
我需要在 Wixzel Voice 這端允許 Vonage 的 IP 範圍嗎？
platform_ip，並在 SIP Dashboard 中將它加入中繼的 ACL。其他電信業者
Elastic SIP Trunking。將平台 IP 加入 Termination IP ACL 允許清單，並為來電設定 Origination SIP URI。
以 IP 驗證的 SIP Connection。將平台 IP 加入為授權位址、選擇來電區域，並讓傳輸協定一致。
Zentrunk。一個在 IP ACL 中加入平台 IP 的外撥中繼，以及一個 Primary 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，並讓號碼格式和傳輸協定一致。
中繼的兩個部分如何運作、所有失敗代碼，以及每份電信業者指南，都在同一頁。