Bandwidth SIPトランキング

Bandwidth SIPトランクをElevenLabs Agentsに接続します。

このガイドを読む前に、ElevenLabsがSIPトランクをどのようにサポートしているかを理解するため、SIPトランキング ガイドを読むことをおすすめします。

概要

このガイドでは、Bandwidth SIPトランクをElevenLabs Agentsに直接接続する方法を説明します。このインテグレーションにより、既存のBandwidth電話番号とインフラストラクチャを使用しながら、着信・発信の両方でElevenLabsの高度な音声AI機能を活用できます。

BandwidthでのSIPトランキングの仕組み

SIPトランキングは、Bandwidthの電話インフラストラクチャとElevenLabsプラットフォームの間に直接接続を確立します:

  1. 着信通話:Bandwidthからの通話は、発信元URIを使用してElevenLabsプラットフォームにルーティングされます。これはVoice Configuration Package(VCP)を使用してBandwidth Appで設定します。
  2. 発信通話:ElevenLabsから開始された通話は、realm FQDNまたは終端SBCアドレスを使用してBandwidth SIPトランクにルーティングされ、エージェントから発信できます。
  3. 認証:Bandwidthは、Unified Communications(UC)トランク向けにSIPベースの認証を提供します。SIP認証情報(network bridge)によるダイジェスト認証を利用します。この方式は、ElevenLabsからの発信を可能にし、安全な通信を確保するために不可欠です。
  4. シグナリングとメディア:初期の通話設定(シグナリング)にはUDP/TLSを使用します。通話が確立されると、実際のオーディオデータ(RTPストリーム)はUDP経由で送信されます。

要件

Bandwidth SIPトランクのインテグレーションを設定する前に、以下を確認してください:

  1. 有効なElevenLabsアカウント
  2. SIPトランキングが有効なBandwidth Universal Platformアカウント(sip-authが有効)
  3. Bandwidthアカウントで購入またはポーティングした電話番号が少なくとも1つ
  4. Bandwidth App内のアカウントへの管理者アクセス

着信通話を設定する(BandwidthからElevenLabs)

Bandwidthの発信元設定を構成し、着信通話をElevenLabsにルーティングします。

1

Bandwidth Appにサインインする

Bandwidth Appにログインします。

2

Voice Configuration Packageを作成する

  1. Service Managementタブに移動し、Voice Configurationを選択します。
  2. Create Newをクリックして、新しいVoice Configuration Packageの作成を開始します。
  3. 一意のPackage Nameを入力します。
  4. Add Routeをクリックします。
  5. Route to Domain Nameを選択します。
  6. 指定のフィールドにElevenLabsから提供されたFQDNを入力します。通常はsip.rtc.elevenlabs.ioです。ElevenLabsアカウントが分離されたデータレジデンシーリージョンを使用している場合、または静的SIPインフラストラクチャを使用している場合は、対応するSIPエンドポイントを使用してください。利用可能なリージョンについては、データレジデンシーを参照してください。
  7. Saveをクリックして、Voice Configuration Packageの作成を完了します。

詳細については、Bandwidth VCP ドキュメントを参照してください。

3

E.164形式を確認する

Bandwidthは着信通話をE.164形式で送信します。ElevenLabsで電話番号をインポートする際は、先頭に+を付けた同じ形式を使用してください(例:+15551234567)。

発信通話を設定する(ElevenLabsからBandwidth)

発信通話では、ElevenLabsがBandwidthで認証を行う必要があります。推奨される方法は、realmと認証情報を使用したSIPダイジェスト認証です。

1

realmを作成する

  1. Bandwidth Appで、Accountを選択し、SIP Credentialsをクリックします。
  2. Manage Realmsまでスクロールし、Addをクリックします。
  3. realm名と任意の説明を入力し、Addをクリックします。

Bandwidthは{realmname}.{hash}.auth.bandwidth.com形式のrealm FQDNを作成します。このFQDNをメモしてください。ElevenLabsで発信アドレスとして使用します。

SIP Credentialsタブが表示されない場合は、Bandwidth Account Managerに連絡するか、 Bandwidth Supportにチケットを作成して、アカウントのSIP認証を有効にしてください。

2

SIP認証情報を作成する

  1. SIP Credentialsセクションで、Addをクリックします。
  2. UsernameとPasswordを入力します。
  3. 前のステップで作成したrealmを選択します。
  4. Add SIP Credentialsをクリックします。

ユーザー名とパスワードは安全に保管してください。ElevenLabsのSIPトランク設定で入力します。

3

realm FQDNを確認する

発信終端アドレスは、作成後に表示されるrealm FQDNです(例:myrealm-a1b2c3.auth.bandwidth.com)。ElevenLabsで発信設定を構成する際、Addressフィールドにこのホスト名を入力します。

realmに関連付けられたSBC IPアドレスを確認するには、SRVルックアップを実行します:

nslookup -type=SRV _sip._{udp/tls}.{realm_FQDN}

Bandwidthは冗長性のためにペアとなるSBC IPを提供します。発信トラフィックのため、両方に到達可能である必要があります。

ElevenLabsでセットアップを完了する

Bandwidth Appでこれらの設定を構成した後、ElevenLabsで電話番号をインポートします:

1

SIPトランクの電話番号をインポートする

SIPトランキングガイドに従って、Bandwidthの電話番号をインポートします。以下の設定を使用してください:

  • トランスポートタイプ:UDP(Bandwidthトランクで暗号化されたシグナリングを使用する場合はTLS)
  • メディア暗号化:Bandwidthトランクの設定に合わせる
  • 発信アドレス:realm FQDN(例:myrealm-a1b2c3.auth.bandwidth.com)
  • SIPトランクのユーザー名とパスワード:Bandwidth Appで作成した認証情報
2

エージェントを割り当てる

インポート後、Phone Numbersダッシュボードで電話番号にエージェントを割り当てます。

Bandwidth SIPトランクを設定した後、SIPトランキング ガイドに従って、ElevenLabsでの設定を完了してください。

トラブルシューティング

  • Bandwidth VCPの発信元設定で、ルートの宛先としてsip.rtc.elevenlabs.ioが入力されていることを確認します。
  • 電話番号が正しい発信元設定でVCPに割り当てられていることを確認します。
  • ElevenLabsの電話番号形式が、Bandwidthが送信するE.164形式(先頭に+付き)と一致していることを確認します。
  • ファイアウォールで、設定されたトランスポートプロトコルとポートのSIPシグナリングトラフィック(UDPは5060、TLSは5061)が許可され、RTPポートがブロックされていないことを確認します。
  • ElevenLabsのSIPトランクのユーザー名、パスワード、realmが、Bandwidth Appで作成した認証情報と一致していることを確認します。
  • Addressフィールドには、sip:プレフィックスなしでrealm FQDNのホスト名のみが含まれていることを確認します。
  • ElevenLabsの発信設定にあるトランスポートタイプが、Bandwidthトランクの設定(UDPまたはTLS)と一致していることを確認します。
  • メディアトラフィック用のRTPポートが開いており、ファイアウォールでブロックされていないことを確認します。
  • G711ulawコーデックの互換性を確認します。BandwidthとElevenLabsはどちらもG711をサポートしています。

よくある質問

BandwidthとElevenLabsは、SIPシグナリングにポート5060のUDPを使用します。Bandwidthトランクが暗号化トランスポート用に設定されている場合は、代わりにポート5061のTLSを使用してください。

先頭に+を付けたE.164形式を使用してください(例:+19192971100)。Bandwidthはこの形式で番号を送受信します。

ElevenLabsはG711とG722をサポートしています。BandwidthはG711ulawとG729aをサポートしています。両プラットフォーム間の互換性には、G711ulawが推奨コーデックです。

便利なリンク