LiveKit との接続ガイド

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

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

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

着信の設定：クラコールの SBC から受けるトランクを作る（inbound trunk）

LiveKit の inbound trunk（着信用）は、クラコールの SBC からの着信を LiveKit が受ける入口です。次の内容のファイルを作り、lk コマンドで登録します。

inbound-trunk.json

{
  "trunk": {
    "name": "clocall inbound",
    "numbers": ["+81312345678"],
    "allowed_addresses": ["203.0.113.10", "203.0.113.11", "203.0.113.20"]
  }
}

ターミナル

# クラコールの SBC からの着信を受ける inbound trunk を登録します
lk sip inbound create inbound-trunk.json

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

• numbers（必須）：ご利用のクラコールの電話番号です。+81 から始まる E.164 形式で入れます。このトランクは、この一覧の番号への着信だけを受けます（例の +81312345678 は例の番号です）。
• allowed_addresses：手順1の SBC の IP アドレスを、すべて入れることをおすすめします（IP アドレスまたは CIDR のリストです。例の 203.0.113.10 などは例の値です）。この項目を使うには、お客様のプロジェクトで有効にしてもらう必要があります。LiveKit のサポートへお問い合わせください。
• クラコールは、ユーザー名・パスワードによる認証は使いません。このため、着信の認証には allowed_addresses を使うのがおすすめです。
• 音声の形式は G.711 μ-law（PCMU）です。LiveKit の SIP の API で指定できるコーデック名には PCMU が含まれています。
• 作ったトランクの ID は、lk sip inbound list か、LiveKit Cloud の画面の Inbound で確認できます（次の手順で使います）。

着信をルーム・エージェントにつなぐ（dispatch rule）

inbound trunk だけでは、着信は LiveKit に入るだけで、どこにもつながりません。dispatch rule で、かけてきた電話ごとにどのルームにつなぐか、どのエージェントを呼ぶかを決めます。次の内容のファイルを作り、登録します。

dispatch-rule.json

{
  "dispatch_rule": {
    "rule": {
      "dispatch_rule_individual": {
        "room_prefix": "call-"
      }
    },
    "name": "clocall dispatch rule",
    "trunk_ids": ["<inbound-trunk-id>"],
    "room_config": {
      "agents": [{
        "agent_name": "inbound-agent"
      }]
    }
  }
}

ターミナル

lk sip dispatch create dispatch-rule.json

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

• dispatch_rule_individual：電話ごとに別のルームを作ります（ルームの名前は room_prefix で始まります）。全員を1つのルームにつなぐ場合は、"dispatch_rule_direct": {"room_name": "open-room"} の形にします。
• trunk_ids：手順2で作った、クラコール用の inbound trunk の ID に置き換えます。省くと、すべての着信トランクに当てはまります。
• agent_name：呼び出すエージェントの名前です。エージェントを使わず、ルームだけ作る場合は、room_config の部分は不要です。

発信の設定：クラコール向けの outbound trunk を作り、それを指定してかける

LiveKit の outbound trunk（発信用）は、LiveKit からクラコールへ電話をかける出口です。address にお客様専用のドメインを入れることで、発信がクラコールの SBC を通ります。次の内容のファイルを作り、登録します。

outbound-trunk.json

{
  "trunk": {
    "name": "clocall outbound",
    "address": "xyz.customer.clocall.jp",
    "destination_country": "jp",
    "numbers": ["+81312345678"],
    "transport": "SIP_TRANSPORT_UDP"
  }
}

ターミナル

# クラコール（お客様専用のドメイン）へ発信する outbound trunk を登録します
lk sip outbound create outbound-trunk.json

• address（必須）：お客様専用のドメインを、ホスト名だけで書きます（sip: は付けません）。xyz.customer.clocall.jp は例です。手順1でお渡しするドメインに置き換えてください。
• destination_country（必須）：2文字の国コードです。日本は jp です。
• numbers（必須）：発信者番号（caller ID）として使うお客様のクラコールの電話番号を、+81 から始まる E.164 形式で入れます（例の +81312345678 は例の番号です）。発信者番号は SIP の From ヘッダーに入ります。P-Asserted-Identity には対応していません。
• transport：通信方式です。標準では SIP_TRANSPORT_UDP または SIP_TRANSPORT_TCP にします（SIP_TRANSPORT_AUTO は自動判定です）。
• LiveKit の公式ドキュメントの発信トランクの例には、--auth-user・--auth-pass を付けるコマンドがあります。これは、ユーザー名・パスワードを使う他社の回線向けです。クラコールはユーザー名・パスワードによる認証は使わないので、付けないでください。認証は、お客様専用のドメインと発信者番号で行います。
• 作ったトランクの ID（outbound trunk の ID）は、次の発信で使います。

発信するときは、sip_trunk_id に上の outbound trunk の ID を指定します。これを指定することで、発信がクラコール経由になります。

sip-participant.json

{
  "sip_trunk_id": "<outbound-trunk-id>",
  "sip_number": "+81312345678",
  "sip_call_to": "+81355550000",
  "room_name": "my-sip-room",
  "wait_until_answered": true
}

ターミナル

# sip_trunk_id にクラコール向けの outbound trunk を指定して発信します
lk sip participant create sip-participant.json

• sip_trunk_id：上で作った、クラコール向けの outbound trunk の ID に置き換えます。
• sip_number：発信者番号（caller ID）です。お客様のクラコールの番号を、outbound trunk の numbers に入れたものと同じ +81 から始まる E.164 形式で入れます。省くとトランクに登録した番号が使われますが、どの番号で発信するかがわかるよう指定をおすすめします。
• sip_call_to：かける相手の電話番号です。+81 から始まる E.164 形式で入れます（例の +81355550000 は例の番号です）。
• room_name：電話をつなぐルームの名前です。
• wait_until_answered：true にすると、相手が電話に出るまでコマンドが待ちます。

つながることを確認する

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