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の価格でVonageから請求されます。
- Wixzel VoiceのAPIキーと前払いのクレジット。最低チャージ額は$5で、無料プランはありません。
- Wixzel Voiceの同時通話数はデフォルトで1アカウントあたり5件で、リクエストに応じて引き上げます。Webやアプリのセッションも同じ上限に含まれます。
Wixzel VoiceでVonageのトランクを作成するには？
VonageのSIP Dashboardがトランクに表示するSIPアドレスです。設定ガイドにはVonageのホストを記載していないため、ダッシュボードからコピーしてください。
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ではなく認証情報で認証する場合は、リクエストボディにusernameとpasswordを追加します。パスワードは保存時に暗号化され、以降APIから返されることはありません。レスポンスには、次の手順で必要な2つの値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を選び、名前にSIPが付くもう1つのVonage製品は選ばないでください。エラスティックトランクのように動作するのはProgrammable SIPだけです。
Vonage経由の通話がつながらなかったのはなぜですか？
Vonageが拒否した通話はstatus: "failed"となり、failure_code（通信事業者からのQ.850原因コード）と、対処方法を示すfailure_reasonが付きます。費用はかかりません。 すべての失敗コード、すべての拒否理由、トランクのデバッグ方法は通信事業者のページにあります。
Vonage経由のAI通話にはいくらかかりますか？
回線の料金はVonageからお客様の料金で請求されます。Wixzel Voiceが課金するのは音声エンジンだけで、実際の使用量に応じて秒単位で、gemini-liveの接続1分あたり$0.0491からdeepgram-agentの$0.1851までです。 すべてのエンジンの料金。
よくある質問
Wixzel Voiceに必要なVonageの製品は？
Wixzel Voice側でVonageのIP範囲を許可する必要はありますか？
platform_ipをSIP DashboardでトランクのACLに追加することです。その他の通信事業者
Elastic SIP Trunking。TerminationのIP ACLにプラットフォームのIPを登録し、着信用にOrigination SIP URIを設定します。
IP認証のSIP Connection。プラットフォームのIPを許可アドレスとして追加し、着信リージョンを選び、トランスポートを合わせます。
Zentrunk。IP ACLにプラットフォームのIPを登録した発信用トランクと、Primary URIをプラットフォームに向けた別の着信用トランクを用意します。
SIP REGISTERに対応していないため、固定IPが必要です。ロケーションにプラットフォームのIPを追加し、TerminationとOriginationを別々に設定するか、network bridgeの認証情報を使います。
インドの電話番号向けのVirtual SIP Trunking（vSIP）で、TCPを使います。プラットフォームのIPをACLとしてトランクに紐付け、着信用にDestination URIをプラットフォームのTCPポートに向けます。
トランクごとのSIPドメインをホストに使い、トランクのIP ACLにプラットフォームのIPを登録します。「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に設定し、番号の形式とトランスポートを合わせます。
トランクの2つの設定の仕組み、すべての失敗コード、すべての通信事業者ガイドを1ページにまとめています。
最初の音声エージェントを構築