Retell AI との接続ガイド

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

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

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

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

取り込んだ番号の Termination URI（発信先の URI）に、お客様専用のドメインを入れます。この設定により、Retell AI からの発信がクラコールの SBC を通ります。Retell AI には、Retell AI 専用の発信先（終端）の SIP URI はありません。

Retell AI の Console で、次の順に進めます。

1. Phone Numbers（電話番号の画面）で + を押し、Connect to your number via SIP trunking（電話番号の取り込み）を選びます。
2. 電話番号の欄に、ご利用の電話番号を +81 から始まる E.164 形式で入れます（例：+81312345678）。
3. Termination URI に、お客様専用のドメイン（xyz.customer.clocall.jp）を入れます。公式の例（someuri.pstn.twilio.com）と同じく、ホスト名だけを入れます。
4. Outbound Transport（発信のトランスポート）を選びます。標準では TCP または UDP です（初期値は TCP で、Retell AI も TCP を推奨しています）。TLS は暗号化の有料オプションをお申し込みの場合だけ使います。
5. SIP Trunk User Name・SIP Trunk Password は、入れません。公式では、プロバイダーがユーザー名・パスワード認証を使う場合に両方を入れるとあり、API の必須項目は電話番号と Termination URI だけです。クラコールは、ユーザー名・パスワードによる認証は使いません。認証は、お客様専用のドメインと発信者番号（caller ID）で行います。発信者番号は SIP の From ヘッダーに入れてください。P-Asserted-Identity には対応していません。

Retell AI の API で取り込む場合の例です（API キーは環境変数から読みます）。着信・発信のエージェントも、ここで一緒に結びつけられます（手順4）。

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

# termination_uri にお客様専用のドメインを入れると、発信がクラコール経由になります
curl -X POST "https://api.retellai.com/import-phone-number" \
  -H "Authorization: Bearer $RETELL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+81312345678",
    "termination_uri": "xyz.customer.clocall.jp",
    "transport": "TCP",
    "codecs": ["PCMU"],
    "inbound_agents": [{"agent_id": "<inbound_agent_id>", "weight": 1}],
    "outbound_agents": [{"agent_id": "<outbound_agent_id>", "weight": 1}]
  }'

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

• $RETELL_API_KEY：Retell AI の API キーを入れた環境変数です（コマンドに直接書かないでください）。
• phone_number：ご利用の電話番号です。例の番号（+81312345678）は例です。
• termination_uri：お客様専用のドメインです（例のドメインは例です。手順1でお渡しするドメインに置き換えてください）。
• transport："TCP"・"UDP"・"TLS" のどれかです（標準は TCP または UDP、TLS は有料オプションのみ）。
• codecs：PCMU だけにします（クラコールの音声の形式です）。
• inbound_agents・outbound_agents：着信を受けるエージェントと、発信に使うエージェントです（<inbound_agent_id>・<outbound_agent_id> は置き換えます）。複数並べるときは、weight の合計を 1 にします。使わない向きは省きます。

宛先の電話番号（destination number）は、+81 から始まる E.164 形式で渡してください（例：+81355550000。例の番号です）。発信は、取り込んだ番号から行います（API の from_number は「Your Retell-managed or imported number.」です）。

接続テストをする

同じ取り込み画面の Test SIP Connection（接続テスト）を押します。Retell AI が Termination URI（お客様専用のドメイン）へ SIP OPTIONS を送り、2xx の応答があれば SIP connection successful と表示されます。

電話は鳴らず、フォームは保存されません。テストを使うには Termination URI の入力が必要で、電話番号を入れる前にも試せます。テストは入力中の値で行われ、Termination URI に transport の指定があれば、そちらが Outbound Transport より優先されます。確認できたら Save を押して取り込みます。接続テストが成功しても、通話そのものの確認にはなりません（手順6で確認します）。

番号にエージェントを結びつける

番号は、エージェントを結びつけて初めて、着信を受けたり発信したりできます。着信用の Inbound Agent と、発信用の Outbound Agent は別々に選べます。

使わない向きは、エージェントを選ばないでおきます。Inbound Agent を結びつけると、その番号で着信を受けられます。API では、手順2のとおり inbound_agents（着信用）・outbound_agents（発信用）で指定します。

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

着信は、Retell AI の SIP サーバー sip.retellai.com（sip:sip.retellai.com）に届けます。トランスポートは URI の最後に付けて指定します。

• TCP：sip:sip.retellai.com;transport=tcp（Retell AI の推奨）
• UDP：sip:sip.retellai.com;transport=udp

音声の形式は G.711 μ-law（PCMU）です。Retell AI は PCMU・PCMA・G.722 に対応しています。Retell AI の通話転送のうち、Cold transfer の SIP REFER 方式は、クラコール経由では使えません（SIP INVITE 方式は既定です）。

Retell AI の公式ドキュメントには、着信側の許可リスト（クラコールの SBC の IP アドレスを許可する設定）を設定する項目の説明がありません。

つながることを確認する

• 着信：クラコールの電話番号へ携帯電話などからかけ、結びつけた Inbound Agent が電話に出ることを確認します。
• 発信：Retell AI から携帯電話などの日本の番号へかけ、電話が鳴ること、相手に発信者番号（+81 から始まる E.164 形式）が表示されることを確認します。
• 両方の向きで、相手の声が聞こえることを確認します。