あらゆるSIPプロバイダーのトランクをWixzel Voiceに接続する
任意の通信事業者の番号でAI音声エージェントを動かすには、その通信事業者のSIPトランクをWixzel Voiceに接続します。発信が受け付けられるようにトランクが返すplatform_ipを許可リストに追加し、着信をorigination_uriに送ります。回線の料金は引き続き通信事業者からお客様の料金で請求され、Wixzel Voiceは音声エンジンの料金を前払い残高から秒単位で課金します。
最終更新日：
公開日
Wixzel Voice始める前に何が必要ですか？
- 任意の通信事業者のSIPトランクと、そのホスト。登録（レジストレーション）を使う場合はユーザー名とパスワード。
- お使いの通信事業者で所有し、そのトランクに紐付けた電話番号。Wixzel Voiceは電話番号の販売もポーティングも行いません。
- Wixzel VoiceのAPIキーと前払いのクレジット。最低チャージ額は$5で、無料プランはありません。
- Wixzel Voiceの同時通話数はデフォルトで1アカウントあたり5件で、リクエストに応じて引き上げます。Webやアプリのセッションも同じ上限に含まれます。
Wixzel Voiceでトランクを作成するには？
通信事業者からトランク用に提供されるSIPホストです。
curl https://api.voice.wixzel.com/v1/sip-trunks \
-H "Authorization: Bearer $WIXZEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My carrier",
"host": "sip.carrier.example",
"transport": "udp"
}'お使いの通信事業者がIPではなく認証情報で認証する場合は、リクエストボディにusernameとpasswordを追加します。パスワードは保存時に暗号化され、以降APIから返されることはありません。レスポンスには、次の手順で必要な2つの値platform_ipとorigination_uriが含まれます。
お使いの通信事業者側では何を設定しますか？
| 設定 | お使いの通信事業者での名称 | 値 |
|---|---|---|
| Wixzel Voiceからの通話を許可する | IP ACL、許可リスト、または許可アドレス | 187.126.120.231 |
| 着信をWixzel Voiceに送る | Origination URI、または通信事業者でのその呼び名 | sip:187.126.120.231:5090 |
どちらの値も現時点のものです。ページからコピーするのではなく、GET /v1/sip-trunksからplatform_ipとorigination_uriを読み取ってください。その後、POST /v1/phone-numbersで各番号をトランクに登録し、inbound_agent_idを指定してエージェントが応答するようにします。 これらのリクエストはAI電話通話APIのウォークスルーに、コンソールの各フィールドについては任意のSIPプロバイダーの詳しい設定手順に記載しています。
初めての通信事業者では何がうまくいかないのですか？
- 開いているSIPポートは、公開されてから数時間以内に通話料金詐欺を狙ったスキャンを受けます。通信事業者自身の不正対策は有効のままにしてください。
- 一部の市場では、発信に本人確認が必要です。KYCを完了していないアカウントや、市場で必要な宛先の登録を済ませていないアカウントは、残高があっても、すべての発信がすぐに切断されることがあります。
- 通信事業者の前払い残高は必要ですが、それだけでは足りません。クレジットがあることだけでなく、特定の宛先の範囲がアカウントで有効になっていることを確認してください。
お使いの通信事業者経由の通話がつながらなかったのはなぜですか？
お使いの通信事業者でよく見られる失敗コード：
| failure_code | 通信事業者の応答 | 意味 | 対処方法 |
|---|---|---|---|
| 1 | 404 | 通信事業者がその番号を認識できません。 | 番号の形式を確認してください。通信事業者がテクニカルプレフィックスを必要とする場合は、トランクにdial_prefixを設定します。 |
| 3 | - | 通信事業者にこの宛先へのルートがありません。 | おそらく通信事業者のアカウントでこの宛先が有効になっていません。通信事業者にルートの開放を依頼してください。 |
| 28 | 484 | 通信事業者が番号の形式を拒否しました。 | 通信事業者がテクニカルプレフィックスを必要とする場合は、トランクにdial_prefixを設定します。 |
| 102 | 408 | 通信事業者が時間内に応答しませんでした。 | トランクのhostとport、そして通信事業者がplatform_ipからのSIPを受け付けているかを確認してください。通信事業者側で通話が受信済みだが応答なしと表示される場合は、send_plusをfalseに設定します。 |
お使いの通信事業者が拒否した通話はstatus: "failed"となり、failure_code（通信事業者からのQ.850原因コード）と、対処方法を示すfailure_reasonが付きます。費用はかかりません。 すべての失敗コード、すべての拒否理由、トランクのデバッグ方法は通信事業者のページにあります。
お使いの通信事業者経由のAI通話にはいくらかかりますか？
回線の料金は通信事業者からお客様の料金で請求されます。Wixzel Voiceが課金するのは音声エンジンだけで、実際の使用量に応じて秒単位で、gemini-liveの接続1分あたり$0.0491からdeepgram-agentの$0.1851までです。 すべてのエンジンの料金。
よくある質問
ここにガイドがない通信事業者でもWixzel Voiceは使えますか？
通信事業者が408 Request Timeoutを返します。何を変えればよいですか？
PATCH /v1/sip-trunks/{id}で、トランクのsend_plusをfalseに設定してください。多くのホールセールの通信事業者は、リクエストURIの先頭の+を解析できず、INVITEを受け付けた後にルーティングに失敗してタイムアウトします。dial_prefixを設定した場合も同じ扱いになります。テクニカルプレフィックスは文字どおりに照合されるため、+が外されるからです。その他の通信事業者
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に送ります。
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.
トランクの2つの設定の仕組み、すべての失敗コード、すべての通信事業者ガイドを1ページにまとめています。
最初の音声エージェントを構築