BandwidthのSIPトランクをWixzel Voiceに接続する
Bandwidthの番号でAI音声エージェントを動かすには、BandwidthのSIPトランクをWixzel Voiceに接続します。発信が受け付けられるようにトランクが返すplatform_ipをVoice IP addresses / DNS hosts on a locationに追加し、着信が届くようにOriginationをトランクのorigination_uriに設定します。回線の料金は引き続きBandwidthからお客様の料金で請求され、Wixzel Voiceは音声エンジンの料金を前払い残高から秒単位で課金します。
最終更新日：
公開日
Bandwidthは通信事業者で、Wixzel Voiceはその上でエージェントを動かす音声AI APIです。両者は標準のSIPで連携します。Bandwidthはその所有者の商標であり、Wixzel VoiceはBandwidthと提携しておらず、Bandwidthから推奨を受けているものでもありません。
Wixzel Voice始める前に何が必要ですか？
- Bandwidthのアカウントと、トランクのホストと認証情報。
- Bandwidthで所有し、そのトランクに紐付けた電話番号。Wixzel Voiceは電話番号の販売もポーティングも行いません。
- Wixzel VoiceのAPIキーと前払いのクレジット。最低チャージ額は$5で、無料プランはありません。
- Wixzel Voiceの同時通話数はデフォルトで1アカウントあたり5件で、リクエストに応じて引き上げます。Webやアプリのセッションも同じ上限に含まれます。
Wixzel VoiceでBandwidthのトランクを作成するには？
Bandwidthがロケーションに割り当てるTerminationのアドレスです。設定ガイドにはBandwidthのホストを記載していないため、Bandwidth Appからコピーしてください。
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Bandwidth",
"host": "<the SIP host Bandwidth gives you>",
"transport": "udp"
}'BandwidthがIPではなく認証情報で認証する場合は、リクエストボディにusernameとpasswordを追加します。パスワードは保存時に暗号化され、以降APIから返されることはありません。レスポンスには、次の手順で必要な2つの値platform_ipとorigination_uriが含まれます。
Bandwidth側では何を設定しますか？
| 設定 | Bandwidthでの名称 | 値 |
|---|---|---|
| Wixzel Voiceからの通話を許可する | Voice IP addresses / DNS hosts on a location | 187.126.120.231 |
| 着信をWixzel Voiceに送る | Origination | sip:187.126.120.231:5090 |
どちらの値も現時点のものです。ページからコピーするのではなく、GET /v1/sip-trunksからplatform_ipとorigination_uriを読み取ってください。その後、POST /v1/phone-numbersで各番号をトランクに登録し、inbound_agent_idを指定してエージェントが応答するようにします。 これらのリクエストはAI電話通話APIのウォークスルーに、コンソールの各フィールドについてはBandwidthの詳しい設定手順に記載しています。
Bandwidthでは何がうまくいかないのですか？
- BandwidthはSIP REGISTERに対応していないため、固定IPは必須です。トランクを動かす方法は、IP認証か、上記のnetwork bridgeの認証情報だけです。
- Bandwidthは複数のプロキシからシグナリングします。最初の1つだけでなく、リージョンに記載されているすべてのアドレスを許可してください。そうしないと、2つ目のプロキシから届いた通話が断続的に拒否され、明確な失敗よりはるかに原因を特定しにくくなります。
Bandwidth経由の通話がつながらなかったのはなぜですか？
Bandwidthが拒否した通話はstatus: "failed"となり、failure_code（通信事業者からのQ.850原因コード）と、対処方法を示すfailure_reasonが付きます。費用はかかりません。 すべての失敗コード、すべての拒否理由、トランクのデバッグ方法は通信事業者のページにあります。
Bandwidth経由のAI通話にはいくらかかりますか？
回線の料金はBandwidthからお客様の料金で請求されます。Wixzel Voiceが課金するのは音声エンジンだけで、実際の使用量に応じて秒単位で、gemini-liveの接続1分あたり$0.0491からdeepgram-agentの$0.1851までです。 すべてのエンジンの料金。
よくある質問
BandwidthはWixzel VoiceでSIP登録に対応していますか？
platform_ipを、ロケーションのVoice IP addressesに追加してください。代わりの方法は、BandwidthのSIP Authentication（network bridge）を使い、トランクにユーザー名とパスワードを設定し、auth_realmにBandwidthから提供されたレルムを設定することです。Bandwidthで一部の通話だけが拒否されるのはなぜですか？
その他の通信事業者
Elastic SIP Trunking。TerminationのIP ACLにプラットフォームのIPを登録し、着信用にOrigination SIP URIを設定します。
IP認証のSIP Connection。プラットフォームのIPを許可アドレスとして追加し、着信リージョンを選び、トランスポートを合わせます。
Zentrunk。IP ACLにプラットフォームのIPを登録した発信用トランクと、Primary URIをプラットフォームに向けた別の着信用トランクを用意します。
Programmable SIP。SIP DashboardでトランクのACLにプラットフォームのIPを追加し、着信をOrigination URIに送ります。
インドの電話番号向けの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ページにまとめています。
最初の音声エージェントを構築