跳到主要內容
Vobiz 整合

將 Vobiz SIP 中繼連接到 Wixzel Voice

若要在 Vobiz 號碼上執行 AI 語音代理,請將您的 Vobiz SIP 中繼連接到 Wixzel Voice:將中繼回傳的 platform_ip 加入 IP ACL,讓外撥通話被接受,並將來電送到 它的 origination_uri,讓來電能夠抵達。Vobiz 會繼續以您的費率向您收取線路費用;Wixzel Voice 則從預付餘額中按秒收取語音引擎的費用。

最後更新於

發布於

Vobiz 是電信業者;Wixzel Voice 是在其上執行代理的語音 AI API。兩者透過標準 SIP 協同運作。Vobiz 是其所有者的商標,Wixzel Voice 與 Vobiz 沒有關聯,也未獲得 Vobiz 的背書。

Vobiz
Wixzel Voice
您的代理

開始之前需要準備什麼?

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

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

Vobiz 會為每條中繼自動產生一個 <trunkId>.sip.vobiz.ai 格式的 SIP 網域。請將它當作中繼的 host,而不是只填 IP。

cURL
curl https://api.voice.wixzel.com/v1/sip-trunks \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vobiz",
    "host": "<trunkId>.sip.vobiz.ai",
    "transport": "udp"
  }'

如果 Vobiz 以憑證而非 IP 進行驗證,請在 body 中加入 username 和 password。密碼會加密儲存,API 之後也不會再回傳。回應中包含 platform_ip 和 origination_uri:下一步需要這兩個值。

要在 Vobiz 設定什麼?

設定Vobiz 的名稱值
允許來自 Wixzel Voice 的通話IP ACL187.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 逐步說明中有這些請求,Vobiz 的完整設定步驟則逐一說明主控台中的每個欄位。

在 Vobiz 上會出什麼問題?

  • 在 Vobiz 上,「origination」這個字指的是另一個方向。不要只因為名稱相同,就把 Wixzel Voice 的 origination_uri 貼到 Vobiz 的欄位中;請先了解該欄位的作用。
  • Vobiz 要求號碼前面有 +,因此請將 send_plus 保持預設值 true。

為什麼透過 Vobiz 的通話沒有接通?

被 Vobiz 拒絕的通話會帶有 status: "failed"、failure_code(電信業者回傳的 Q.850 原因碼),以及說明該怎麼處理的 failure_reason,而且不會產生任何費用。 所有失敗代碼、所有拒絕原因,以及如何為中繼除錯都在電信業者頁面上。

透過 Vobiz 的 AI 通話費用是多少?

Vobiz 以您的費率向您收取線路費用;Wixzel Voice 只收取語音引擎的費用,依實際用量按秒計費,從 gemini-live 的每接通分鐘 $0.0491,到 deepgram-agent 的 $0.1851。 每個引擎的價格。

常見問題

Vobiz 中繼要使用什麼主機?

Vobiz 為中繼產生的 SIP 網域,格式為 <trunkId>.sip.vobiz.ai。請將它當作 Wixzel Voice 中繼的 host,而不是只填 IP。

Wixzel Voice 的 origination_uri 要填在 Vobiz 的 origination URI 欄位嗎?

請先閱讀該欄位再決定。在 Vobiz 上,「origination URI」是離開您中繼之通話的路由目的地,與 Twilio 的 Origination SIP URI 方向相反,且 Vobiz 允許設定多個,可依優先順序容錯移轉和加權負載平衡。在貼上位址之前,請先了解每個 Vobiz 欄位的作用。

其他電信業者

建立您的第一個語音代理