ElevenLabs との接続ガイド

クラコール ⇄ お客様

お申し込みと、接続に使う情報のやりとり

お申し込み後に、クラコールから接続に使う情報をお渡しします。お客様からは、ElevenLabs 側の情報をお知らせください。

お問い合わせの本文に「BYOC 接続」とお書きのうえ、お送りください。BYOC では、着信・発信とも、INVITE の宛先（Request-URI）・To・From の電話番号を +81 から始まる E.164 形式にしてください（例：03-1234-5678 → +81312345678）。

お客様（ElevenLabs）

電話番号を取り込み、発信先にクラコールを登録する

取り込んだ番号の発信設定の Address（発信先のホスト名）に、お客様専用のドメインを入れます。この設定により、ElevenLabs からの発信がクラコールの SBC を通ります。

ElevenLabs Agents のダッシュボードで、次の順に進めます。

1. Phone Numbers（電話番号の画面）で Import number を押し、From SIP Trunk を選びます。
2. Label（管理用の名前）と Phone Number を入れます。電話番号は +81 から始まる E.164 形式で、先頭の + も入れます（例：+81312345678）。ElevenLabs は、着信の宛先の番号と取り込んだ番号とで + の有無をそろえるよう求めています。クラコールは + 付きで送ります。
3. 着信の設定（inbound）：Media Encryption は Disabled にします（暗号化の有料オプションをお申し込みの場合は通信の暗号化を参照）。Allowed Source IP Addresses に、クラコールの SBC の IP アドレスを入れます（TCP・TLS のときだけ効く設定です）。Remote Domains と Authentication は空のままにします。
4. 発信の設定（outbound）：Address にお客様専用のドメイン（xyz.customer.clocall.jp）を入れます。sip: を付けず、ホスト名だけを入れます。Transport Type は TCP、Media Encryption は Disabled、Enabled Codecs は PCMU だけにします。
5. 発信の Authentication（SIP Trunk Username・SIP Trunk Password）は、入れません。クラコールは、ユーザー名・パスワードによる認証は使いません。認証は、お客様専用のドメインと発信者番号（caller ID）で行います。発信者番号は SIP の From ヘッダーに入れてください。P-Asserted-Identity には対応していません。
6. Import を押して取り込みます。

ElevenLabs の公式ドキュメントには、発信の認証を空にすると IP アドレスによる認証（ACL）になり、通信事業者側で ElevenLabs の IP アドレスを許可する必要があると書かれています。クラコールはドメインと発信者番号で認証するため、ElevenLabs の IP アドレスをお知らせいただく必要はありません。

ElevenLabs の API で取り込む場合の例です（API キーは環境変数から読みます）。media_encryption は、指定しないと allowed（暗号化を許可）になるため、標準では disabled を指定します。

ターミナル（curl）：電話番号を取り込み、発信先をクラコールにする

# outbound_trunk_config の address にお客様専用のドメインを入れると、発信がクラコール経由になります
curl -X POST "https://api.elevenlabs.io/v1/convai/phone-numbers" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "sip_trunk",
    "label": "clocall",
    "phone_number": "+81312345678",
    "agent_id": "<agent_id>",
    "inbound_trunk_config": {
      "allowed_addresses": ["<クラコールの SBC の IP アドレス>"],
      "media_encryption": "disabled"
    },
    "outbound_trunk_config": {
      "address": "xyz.customer.clocall.jp",
      "transport": "tcp",
      "media_encryption": "disabled",
      "enabled_codecs": ["PCMU/8000"]
    }
  }'

例の中の値は、次のように置き換えてください。

• $ELEVENLABS_API_KEY：ElevenLabs の API キーを入れた環境変数です（コマンドに直接書かないでください）。
• phone_number：ご利用の電話番号です。例の番号（+81312345678）は例です。
• agent_id：電話に出る・発信するエージェントです（<agent_id> は置き換えます。手順4で後から割り当てる場合は省きます）。
• allowed_addresses：クラコールの SBC の IP アドレスです（手順1でお渡しする東京・大阪のアドレスを、すべて並べます）。
• address：お客様専用のドメインです（例のドメインは例です。手順1でお渡しするドメインに置き換えてください）。
• transport："tcp" にします（指定しないと auto になります。"tls" は有料オプションのみ）。
• enabled_codecs：PCMU/8000 だけにします（クラコールの音声の形式です）。

お客様（ElevenLabs）

発信のしかたを確認する

ElevenLabs からの発信は、取り込んだ番号から行います。宛先の電話番号（to_number）は、+81 から始まる E.164 形式で渡してください（例：+81355550000。例の番号です）。

API で1件ずつ発信する場合は、SIP トランクの発信 API を使います。

ターミナル（curl）：取り込んだ番号から発信する

curl -X POST "https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "<agent_id>",
    "agent_phone_number_id": "<phone_number_id>",
    "to_number": "+81355550000"
  }'

• agent_phone_number_id：手順2で取り込んだ番号の ID です（取り込みの応答の phone_number_id）。
• to_number：宛先の電話番号です（例の番号は例です）。

お客様（ElevenLabs）

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

取り込んだ番号にエージェントを割り当てると、その番号への着信にエージェントが出ます。

Phone Numbers で取り込んだ番号を選び、Assign Agent を押して、電話に出るエージェントを選びます。API では、手順2の agent_id で指定できます。

通話の転送（Transfer to number）を使う場合、SIP REFER 方式はクラコール経由では使えません。Blind 方式は Twilio 連携の番号だけの機能です。

既定の Conference 方式は、ElevenLabs の公式ドキュメントで SIP トランクの番号にも対応するとされています。転送先へは新しく電話をかけます。

お客様 → クラコール

着信の設定：クラコールの SBC から ElevenLabs へ届ける

着信は、ElevenLabs の SIP サーバー sip.rtc.elevenlabs.io に届けます。宛先には、取り込んだ番号（+ 付き）が入ります。

• TCP：sip:[email protected]:5060;transport=tcp（標準）

音声の形式は G.711 μ-law（PCMU）です。ElevenLabs は PCMU・PCMA・G.722 に対応しています。ElevenLabs は UDP を試験的な扱いとしているため、クラコールからの着信も TCP で届けます。

クラコール ⇄ お客様

つながることを確認する

• 着信：クラコールの電話番号へ携帯電話などからかけ、割り当てたエージェントが電話に出ることを確認します。
• 発信：ElevenLabs から携帯電話などの日本の番号へかけ、電話が鳴ること、相手に発信者番号（+81 から始まる E.164 形式）が表示されることを確認します。
• 両方の向きで、相手の声が聞こえることを確認します。