跳到主要內容
Plivo 整合

將 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 的背書。

Plivo
Wixzel Voice
您的代理

開始之前需要準備什麼?

  • 具備 Zentrunk 的 Plivo 帳號,以及中繼的主機和憑證。
  • 一個您在 Plivo 擁有的電話號碼,並已附加到該中繼。Wixzel Voice 不販售號碼,也不提供號碼移轉。 如果您從主控台連接 Plivo 帳號,也可以從「電話號碼」頁面在該帳號上購買號碼。Plivo 會以其價格計費。
  • 一把 Wixzel Voice API 金鑰和一些預付點數。最低儲值金額為 $5;沒有免費方案。
  • Wixzel Voice 預設每個帳號可同時進行 5 通通話,可依需求提高;網頁和應用程式工作階段也計入同一個上限。

如何在 Wixzel Voice 中建立 Plivo 中繼?

Plivo 為外撥中繼顯示的 termination 位址。設定指南沒有列出 Plivo 的主機,請從主控台複製。

cURL
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 List187.126.120.231
將來電送到 Wixzel VoicePrimary URI187.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 上外撥通話正常,來電卻從不響鈴?

Plivo Zentrunk 的外撥和來電中繼是不同的物件。外撥通話只需要外撥中繼;來電還需要一個來電中繼,其 Primary URI 設為您 Wixzel Voice 中繼回傳之 origination_uri 中的主機和連接埠(目前為 187.126.120.231:5090),且每個號碼都需要設定 inbound_agent_id。

可以用 Plivo Credentials List 取代 IP ACL 嗎?

可以。將 Credentials List 的使用者名稱和密碼填入 Wixzel Voice 中繼的 username 和 password 欄位,Plivo 就會以摘要驗證取代來源位址驗證。密碼會加密儲存,API 也不會再回傳它。

其他電信業者

建立您的第一個語音代理