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

