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から推奨を受けているものでもありません。
Wixzel Voice始める前に何が必要ですか？
- Zentrunkを利用できるPlivoのアカウントと、トランクのホストと認証情報。
- Plivoで所有し、そのトランクに紐付けた電話番号。Wixzel Voiceは電話番号の販売もポーティングも行いません。 コンソールからPlivoのアカウントを接続すれば、「電話番号」ページからそのアカウントで番号を購入することもできます。料金はPlivoの価格でPlivoから請求されます。
- Wixzel VoiceのAPIキーと前払いのクレジット。最低チャージ額は$5で、無料プランはありません。
- Wixzel Voiceの同時通話数はデフォルトで1アカウントあたり5件で、リクエストに応じて引き上げます。Webやアプリのセッションも同じ上限に含まれます。
Wixzel VoiceでPlivoのトランクを作成するには？
Plivoが発信用トランクに表示するTerminationのアドレスです。設定ガイドにはPlivoのホストを記載していないため、コンソールからコピーしてください。
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ではなく認証情報で認証する場合は、リクエストボディにusernameとpasswordを追加します。パスワードは保存時に暗号化され、以降APIから返されることはありません。レスポンスには、次の手順で必要な2つの値platform_ipとorigination_uriが含まれます。
Plivo側では何を設定しますか？
| 設定 | Plivoでの名称 | 値 |
|---|---|---|
| Wixzel Voiceからの通話を許可する | IP Access Control List | 187.126.120.231 |
| 着信をWixzel Voiceに送る | Primary URI | 187.126.120.231:5090 |
どちらの値も現時点のものです。ページからコピーするのではなく、GET /v1/sip-trunksからplatform_ipとorigination_uriを読み取ってください。その後、POST /v1/phone-numbersで各番号をトランクに登録し、inbound_agent_idを指定してエージェントが応答するようにします。 これらのリクエストはAI電話通話APIのウォークスルーに、コンソールの各フィールドについてはPlivoの詳しい設定手順に記載しています。
Plivoでは何がうまくいかないのですか？
- Zentrunkでは2つの方向が別々のオブジェクトになっており、両方が必要です。発信用トランクだけを作成するのが、「発信はできるのに着信が鳴らない」のよくある原因です。
Plivo経由の通話がつながらなかったのはなぜですか？
Plivoが拒否した通話はstatus: "failed"となり、failure_code（通信事業者からのQ.850原因コード）と、対処方法を示すfailure_reasonが付きます。費用はかかりません。 すべての失敗コード、すべての拒否理由、トランクのデバッグ方法は通信事業者のページにあります。
Plivo経由のAI通話にはいくらかかりますか？
回線の料金はPlivoからお客様の料金で請求されます。Wixzel Voiceが課金するのは音声エンジンだけで、実際の使用量に応じて秒単位で、gemini-liveの接続1分あたり$0.0491からdeepgram-agentの$0.1851までです。 すべてのエンジンの料金。
よくある質問
Plivoで発信はできるのに着信が鳴らないのはなぜですか？
origination_uriに含まれるホストとポート（現在は187.126.120.231:5090）に設定し、各番号にinbound_agent_idを設定する必要があります。IP ACLの代わりにPlivoのCredentials Listを使えますか？
usernameとpasswordフィールドに設定すると、Plivoは送信元アドレスではなくダイジェストで認証します。パスワードは保存時に暗号化され、APIから再び返されることはありません。その他の通信事業者
Elastic SIP Trunking。TerminationのIP ACLにプラットフォームのIPを登録し、着信用にOrigination SIP URIを設定します。
IP認証のSIP Connection。プラットフォームのIPを許可アドレスとして追加し、着信リージョンを選び、トランスポートを合わせます。
Programmable SIP。SIP DashboardでトランクのACLにプラットフォームのIPを追加し、着信をOrigination 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ページにまとめています。
最初の音声エージェントを構築