Bandwidth SIPトランキング
Bandwidth SIPトランキング
Bandwidth SIPトランクをElevenLabs Agentsに接続します。
このガイドを読む前に、ElevenLabsがSIPトランクをどのようにサポートしているかを理解するため、SIPトランキング ガイドを読むことをおすすめします。
概要
このガイドでは、Bandwidth SIPトランクをElevenLabs Agentsに直接接続する方法を説明します。このインテグレーションにより、既存のBandwidth電話番号とインフラストラクチャを使用しながら、着信・発信の両方でElevenLabsの高度な音声AI機能を活用できます。
BandwidthでのSIPトランキングの仕組み
SIPトランキングは、Bandwidthの電話インフラストラクチャとElevenLabsプラットフォームの間に直接接続を確立します:
- 着信通話:Bandwidthからの通話は、発信元URIを使用してElevenLabsプラットフォームにルーティングされます。これはVoice Configuration Package(VCP)を使用してBandwidth Appで設定します。
- 発信通話:ElevenLabsから開始された通話は、realm FQDNまたは終端SBCアドレスを使用してBandwidth SIPトランクにルーティングされ、エージェントから発信できます。
- 認証:Bandwidthは、Unified Communications(UC)トランク向けにSIPベースの認証を提供します。SIP認証情報(network bridge)によるダイジェスト認証を利用します。この方式は、ElevenLabsからの発信を可能にし、安全な通信を確保するために不可欠です。
- シグナリングとメディア:初期の通話設定(シグナリング)にはUDP/TLSを使用します。通話が確立されると、実際のオーディオデータ(RTPストリーム)はUDP経由で送信されます。
要件
Bandwidth SIPトランクのインテグレーションを設定する前に、以下を確認してください:
- 有効なElevenLabsアカウント
- SIPトランキングが有効なBandwidth Universal Platformアカウント(sip-authが有効)
- Bandwidthアカウントで購入またはポーティングした電話番号が少なくとも1つ
- Bandwidth App内のアカウントへの管理者アクセス
着信通話を設定する(BandwidthからElevenLabs)
Bandwidthの発信元設定を構成し、着信通話をElevenLabsにルーティングします。
Voice Configuration Packageを作成する
- Service Managementタブに移動し、Voice Configurationを選択します。
- Create Newをクリックして、新しいVoice Configuration Packageの作成を開始します。
- 一意のPackage Nameを入力します。
- Add Routeをクリックします。
- Route to Domain Nameを選択します。
- 指定のフィールドにElevenLabsから提供されたFQDNを入力します。通常は
sip.rtc.elevenlabs.ioです。ElevenLabsアカウントが分離されたデータレジデンシーリージョンを使用している場合、または静的SIPインフラストラクチャを使用している場合は、対応するSIPエンドポイントを使用してください。利用可能なリージョンについては、データレジデンシーを参照してください。 - Saveをクリックして、Voice Configuration Packageの作成を完了します。
詳細については、Bandwidth VCP ドキュメントを参照してください。
発信通話を設定する(ElevenLabsからBandwidth)
発信通話では、ElevenLabsがBandwidthで認証を行う必要があります。推奨される方法は、realmと認証情報を使用したSIPダイジェスト認証です。
realmを作成する
- Bandwidth Appで、Accountを選択し、SIP Credentialsをクリックします。
- Manage Realmsまでスクロールし、Addをクリックします。
- realm名と任意の説明を入力し、Addをクリックします。
Bandwidthは{realmname}.{hash}.auth.bandwidth.com形式のrealm FQDNを作成します。このFQDNをメモしてください。ElevenLabsで発信アドレスとして使用します。
SIP Credentialsタブが表示されない場合は、Bandwidth Account Managerに連絡するか、 Bandwidth Supportにチケットを作成して、アカウントのSIP認証を有効にしてください。
ElevenLabsでセットアップを完了する
Bandwidth Appでこれらの設定を構成した後、ElevenLabsで電話番号をインポートします:
SIPトランクの電話番号をインポートする
SIPトランキングガイドに従って、Bandwidthの電話番号をインポートします。以下の設定を使用してください:
- トランスポートタイプ:UDP(Bandwidthトランクで暗号化されたシグナリングを使用する場合はTLS)
- メディア暗号化:Bandwidthトランクの設定に合わせる
- 発信アドレス:realm FQDN(例:
myrealm-a1b2c3.auth.bandwidth.com) - SIPトランクのユーザー名とパスワード:Bandwidth Appで作成した認証情報
Bandwidth SIPトランクを設定した後、SIPトランキング ガイドに従って、ElevenLabsでの設定を完了してください。
トラブルシューティング
着信通話が接続できない
- Bandwidth VCPの発信元設定で、ルートの宛先として
sip.rtc.elevenlabs.ioが入力されていることを確認します。 - 電話番号が正しい発信元設定でVCPに割り当てられていることを確認します。
- ElevenLabsの電話番号形式が、Bandwidthが送信するE.164形式(先頭に
+付き)と一致していることを確認します。 - ファイアウォールで、設定されたトランスポートプロトコルとポートのSIPシグナリングトラフィック(UDPは5060、TLSは5061)が許可され、RTPポートがブロックされていないことを確認します。
発信通話で407または認証エラーが発生する
- ElevenLabsのSIPトランクのユーザー名、パスワード、realmが、Bandwidth Appで作成した認証情報と一致していることを確認します。
- Addressフィールドには、
sip:プレフィックスなしでrealm FQDNのホスト名のみが含まれていることを確認します。 - ElevenLabsの発信設定にあるトランスポートタイプが、Bandwidthトランクの設定(UDPまたはTLS)と一致していることを確認します。
片方向音声または音声がない
- メディアトラフィック用のRTPポートが開いており、ファイアウォールでブロックされていないことを確認します。
- G711ulawコーデックの互換性を確認します。BandwidthとElevenLabsはどちらもG711をサポートしています。
よくある質問
Bandwidthにはどのシグナリングトランスポートとポートが必要ですか?
BandwidthとElevenLabsは、SIPシグナリングにポート5060のUDPを使用します。Bandwidthトランクが暗号化トランスポート用に設定されている場合は、代わりにポート5061のTLSを使用してください。
どの電話番号形式を使用すべきですか?
先頭に+を付けたE.164形式を使用してください(例:+19192971100)。Bandwidthはこの形式で番号を送受信します。
互換性のあるオーディオコーデックはどれですか?
ElevenLabsはG711とG722をサポートしています。BandwidthはG711ulawとG729aをサポートしています。両プラットフォーム間の互換性には、G711ulawが推奨コーデックです。