Genesys Cloud との接続ガイド

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

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

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

ロケーションとサイトを用意する

Genesys Cloud の BYOC Cloud では、トランクの前に、ロケーション（所在地）とサイト（電話の設定のまとまり）が必要です。すでにある場合は、この手順は飛ばします。

1. ロケーションを作り、サイトで使えるようにします。
2. Menu > Digital and Telephony > Telephony > Sites で Create New を押し、サイト名・ロケーション・タイムゾーンを入れます。Media Model は Cloud を選びます（サイトを作った後は変えられません）。

外部トランクを作り、発信先にクラコールを登録する

クラコールへの外部トランク（External Trunk）を作ります。SIP Servers or Proxies にお客様専用のドメインを入れると、このトランクからの発信がクラコールの SBC を通ります。

Menu > Digital and Telephony > Telephony > Trunks の External Trunks タブで Create New を押し、次のとおり設定します。

1. External Trunk Name に名前を入れ、Type は BYOC Carrier → Generic BYOC Carrier を選びます。Trunk State は In-Service にします。
2. Protocol（トランスポート）は UDP または TCP を選びます（TLS は暗号化の有料オプションをお申し込みの場合だけ）。この設定は Genesys Cloud から送る向きにだけ効くため、クラコールからの着信も同じ方式にそろえます（手順1でお知らせください）。
3. 着信（Inbound）：Inbound SIP Termination Identifier に、リージョン内で重ならない識別子を入れます。画面に表示される Inbound Request-URI Reference の例（例：sip:+81312345678@<識別子>.byoc.apne1.genesys.cloud）を控えて、クラコールへお知らせください。Inbound SIP Termination Header は空のままにします。
4. 発信（Outbound）：Outbound IPs の Enable high capacity outbound platform を選びます（新しい音声基盤を使う設定です）。Outbound SIP Termination FQDN に、お客様専用のドメイン（xyz.customer.clocall.jp）を入れます。
5. SIP Servers or Proxies の Hostname or IP Address にお客様専用のドメインを、Port にポート番号（UDP・TCP は 5060。暗号化の有料オプションで TLS を使う場合は 5061）を入れて Add を押します。
6. Digest Authentication は無効のままにします。クラコールは、ユーザー名・パスワードによる認証は使いません。認証は、お客様専用のドメインと発信者番号（caller ID）で行います。
7. Caller ID の Caller Address に、ご利用の電話番号を +81 から始まる E.164 形式で入れます（例：+81312345678）。発信者番号は SIP の From ヘッダーに入れてください。P-Asserted-Identity には対応していないため、Send asserted identity header は選ばなくてかまいません。発信者番号は、Prioritized caller ID locations の順（新しいトランクの既定は This Trunk、次に Call Source）で決まります。キュー・キャンペーン・サイト・担当者に発信者番号を設定する場合も、クラコールの番号だけを入れてください。
8. SIP Access Control に、クラコールの SBC の IP アドレスをすべて入れて Add を押します（クラコールからの着信を受け付けるためです）。
9. Save External Trunk を押して保存します。

続けて、作ったトランクの詳細設定（外部トランクの設定画面の下側）で、次のとおり設定します（3か所を変え、1か所は既定のまま）。

• Identity の Outbound の Calling と Called にある Address Omit + Prefix を、どちらも 無効 にします。既定は有効で、そのままだと発信者番号と宛先の番号から + が外れ、クラコールが求める +81 の形式になりません。
• Media の Preferred Codec List を audio/PCMU (g711 µ-Law) だけにします（クラコールの音声の形式です）。
• Release Link Transfer（発信の REFER）は、既定の無効のままにします。
• Identity の Outbound にある Apply User Privacy を 無効 にします。既定は有効で、担当者が *67 をかけると発信者番号が sip:[email protected] に置き換わり、発信者番号による認証が通りません。

発信ルートにトランクを結びつける

サイトの発信ルート（Outbound Routes）に、手順3のトランクを結びつけます。Genesys Cloud の公式ドキュメントでは、着信だけで使う場合も、この設定が必要とされています。

Menu > Digital and Telephony > Telephony > Sites でサイトを選び、Outbound Routes タブで発信ルートを開くか New Outbound Route を押します。Classifications で発信の区分を選び、Select an External Trunk で手順3のトランクを選び、State を有効にして保存します。

宛先の電話番号は、+81 から始まる E.164 形式で送られるようにしてください（手順3の Address Omit + Prefix）。

着信の設定：番号を登録し、クラコールの SBC から届ける

ご利用の電話番号を Genesys Cloud に登録し、コールフローや担当者に割り当てます。クラコールは、手順3でお知らせいただいたトランクの FQDN へ着信を届けます。

1. Menu > Digital and Telephony > Telephony > DID Numbers の DID Ranges タブで Create Range を押し、ご利用の電話番号を登録します（1つだけなら、DID Start と DID End に同じ番号を入れます）。
2. 登録した番号を、コールフロー（着信の振り分け）・担当者・電話機に割り当てます。

着信の宛先は、トランクの FQDN です（東京リージョンの例：sip:+81312345678@<識別子>.byoc.apne1.genesys.cloud）。この FQDN は、Genesys Cloud のリージョンの受け口（東京では 52.129.101.228〜52.129.101.230）のどれかになります。

つながることを確認する

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

Genesys Cloud の通話シミュレーター（サイトの Simulate Call タブ）で、宛先の番号がどの発信ルート・トランクに流れるかを、実際にかける前に確かめられます。