Telnyx との接続ガイド

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

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

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

SIP Connection（FQDN）を作り、宛先にクラコールを登録する

Telnyx の Voice > SIP Trunking で SIP Connection を追加し、種類は FQDN を選びます。次に、その接続の宛先（FQDN）として、お客様専用のドメインを登録します。この宛先の登録で、通話がクラコールへ向かいます。

API で作る場合の例です（認証は環境変数から読みます）。

ターミナル（curl）：1. FQDN 接続を作る

curl -X POST "https://api.telnyx.com/v2/fqdn_connections" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_name": "clocall",
    "inbound": {
      "ani_number_format": "+E.164",
      "dnis_number_format": "+e164"
    }
  }'

ターミナル（curl）：2. 宛先にクラコール（お客様専用のドメイン）を登録する

# fqdn にお客様専用のドメインを入れると、この接続の通話はクラコールへ送られます
curl -X POST "https://api.telnyx.com/v2/fqdns" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "1234567890",
    "fqdn": "xyz.customer.clocall.jp",
    "dns_record_type": "a"
  }'

• $TELNYX_API_KEY：Telnyx の API キーを入れた環境変数です（コマンドに直接書かないでください）。
• connection_id：1.の応答に入っている、作った接続の ID です（1234567890 は例です）。
• fqdn：お客様専用のドメインです。xyz.customer.clocall.jp は例です。手順1でお渡しするドメインに置き換えてください。dns_record_type が a で port を指定しないときは 5060 が使われます。
• dnis_number_format（宛先番号の形式）の選択肢は +e164・e164・national・sip_username（既定は e164）、ani_number_format（発信者番号の形式）の選択肢は +E.164・E.164・+E.164-national・E.164-national（既定は E.164-national）です。クラコールとは +81 から始まる E.164 形式でやりとりするため、上のように +e164・+E.164 にします。
• 画面で作る場合は、接続の Authentication and routing で Add FQDN を選び、DNS record type は A、FQDN にはお客様専用のドメインを入れます。port の欄もあります。
• 1.は Telnyx CLI でも作れます（名前だけ）：telnyx fqdn-connections create --api-key "$TELNYX_API_KEY" --connection-name clocall

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

Telnyx の SIP シグナリングの FQDN は sip.telnyx.com です。クラコールは、ここに着信を送ります。ポートは UDP・TCP が 5060 です。

着信したあと、お客様のアプリが電話をどう扱うかは Telnyx 側の設定で決まり、このガイドでは扱いません。音声の形式は G.711 μ-law（PCMU）です。

発信の設定：SIP Connection から、クラコール経由でかける

手順2で SIP Connection に登録したお客様専用のドメインが、Telnyx からクラコールへ送る通話の宛先です（Telnyx のマニュアルでは inbound と呼びます）。クラコールは、ユーザー名・パスワードによる認証は使いません。認証は、お客様専用のドメインと発信者番号（caller ID）で行います。

• 宛先番号は、手順2で dnis_number_format を +e164 にしたとおり、+81 から始まる E.164 形式（例：+81355550000）になります。
• 発信者番号は SIP の From ヘッダーに入れてください（例：+81312345678）。P-Asserted-Identity には対応していません。ani_number_format は手順2のとおり +E.164 です。
• 音声の形式は G.711 μ-law（PCMU）です。Telnyx の音声の形式の一覧（API 項目 codecs）には、既定で G711U が含まれています。G711U を外さないでください。

上の電話番号は例です。お客様の番号（+81312345678）と、かける先の番号（+81355550000）に置き換えてください。

つながることを確認する

• 着信：クラコールの電話番号へ携帯電話などからかけ、お客様のアプリに電話が届くことを確認します。
• 発信：Telnyx から携帯電話などの日本の番号へかけ、電話が鳴ること、相手に発信者番号（+81 から始まる E.164 形式）が表示されることを確認します。
• 両方の向きで、相手の声が聞こえることを確認します。