本文へスキップ
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の価格でVobizから請求されます。
  • Wixzel VoiceのAPIキーと前払いのクレジット。最低チャージ額は$5で、無料プランはありません。
  • Wixzel Voiceの同時通話数はデフォルトで1アカウントあたり5件で、リクエストに応じて引き上げます。Webやアプリのセッションも同じ上限に含まれます。

Wixzel VoiceでVobizのトランクを作成するには?

Vobizはトランクごとに<trunkId>.sip.vobiz.aiの形式でSIPドメインを自動生成します。IPアドレスではなく、それをトランクのhostに使ってください。

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ではなく認証情報で認証する場合は、リクエストボディにusernameとpasswordを追加します。パスワードは保存時に暗号化され、以降APIから返されることはありません。レスポンスには、次の手順で必要な2つの値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の接続1分あたり$0.0491からdeepgram-agentの$0.1851までです。 すべてのエンジンの料金。

よくある質問

Vobizのトランクにはどのホストを使いますか?

Vobizがトランク用に生成する<trunkId>.sip.vobiz.aiの形式のSIPドメインです。IPアドレスではなく、それをWixzel Voiceのトランクのhostに使ってください。

Wixzel Voiceのorigination_uriは、Vobizのorigination URIフィールドに入れますか?

フィールドの説明を読まずに入れないでください。Vobizの「origination URI」は、トランクから出ていく通話のルーティング先で、TwilioのOrigination SIP URIとは逆の方向です。Vobizでは、優先度に基づくフェイルオーバーと重み付けによる負荷分散で複数設定できます。アドレスを貼り付ける前に、Vobizの各フィールドの役割を確認してください。

その他の通信事業者

Twilio

Elastic SIP Trunking。TerminationのIP ACLにプラットフォームのIPを登録し、着信用にOrigination SIP URIを設定します。

Telnyx

IP認証のSIP Connection。プラットフォームのIPを許可アドレスとして追加し、着信リージョンを選び、トランスポートを合わせます。

Plivo

Zentrunk。IP ACLにプラットフォームのIPを登録した発信用トランクと、Primary URIをプラットフォームに向けた別の着信用トランクを用意します。

Vonage

Programmable SIP。SIP DashboardでトランクのACLにプラットフォームのIPを追加し、着信をOrigination URIに送ります。

Bandwidth

SIP REGISTERに対応していないため、固定IPが必要です。ロケーションにプラットフォームのIPを追加し、TerminationとOriginationを別々に設定するか、network bridgeの認証情報を使います。

Exotel

インドの電話番号向けのVirtual SIP Trunking(vSIP)で、TCPを使います。プラットフォームのIPをACLとしてトランクに紐付け、着信用にDestination URIをプラットフォームのTCPポートに向けます。

Mobily

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.

あらゆるSIPプロバイダー

手順はどこでも同じです。プラットフォームのIPを許可リストに登録し、着信の宛先をOrigination URIに設定し、番号の形式とトランスポートを合わせます。

SIPトランクの持ち込み

トランクの2つの設定の仕組み、すべての失敗コード、すべての通信事業者ガイドを1ページにまとめています。

最初の音声エージェントを構築