TwilioのBYO SMSを設定する

前提条件
  • Genesys Cloud CX 1 Digital Add-on II、Genesys Cloud CX 2、Genesys Cloud CX 2 Digital、Genesys Cloud CX 3、または Genesys Cloud CX 3 Digital ライセンス。

 以下の権限

  • Integrations > Integration > Add
  • Integrations > Integration > Delete
  • Integrations > Integration > Edit
  • Integrations > Integration > View
  • SMS>電話番号 >すべて 

SMSサービスでTwilioと既にお取引がある場合は、BYO(Bring Your Own)SMS機能を使って、既存のTwilioアカウントをGenesys Cloudに統合することができます。 その後、Genesys Cloud SMSのすべての機能を使用して、顧客とSMSメッセージを送受信できます。

 メモ:   ジェネシス・クラウドの間接的なお客様の場合、TwilioのBYO SMSを設定するには、パートナー組織と直接作業する必要があります。

BYO SMS の価格については、Genesys Cloud fair use policy をご覧ください。

Genesys CloudのインバウンドWebhookでSMS番号をプロビジョニングする

Twilio SMS番号をBYO SMS Twilioインテグレーションに追加する前に、Genesysクラウド受信Webhookを使用するためにSMS番号をプロビジョニングする必要があります。  そのためには、それぞれのSMS番号に、お住まいの地域に適したGenesys Cloud Webhook URLをプロビジョニングします。 詳細については、Twilio Docs のWebhooks の記事を参照してください。

10DLC番号のWebhookを設定する

登録済みのUS 10DLC番号を使用している場合、Twilioがそれらの番号をメッセージングサービスに配置することに気づくかもしれません。 この場合、Genesys は、Messaging Service の Webhook 設定でDefer to sender's webhook オプションを選択し、Genesys Cloud の受信 Webhook を使用するように SMS 番号をプロビジョニングすることを推奨します。

地域固有のGenesys Cloud Webhook URLS

米国東部(N. ヴァージニア州

https://byosms.mypurecloud.com/vendors/v1/twilio/a906d2848ad146028e8805a8bbaa24d3/mo 

米国東部 (オハイオ)

https://byosms.use2.us-gov-pure.cloud/vendors/v1/twilio/60b5013a2511482999b30b6db5ec67d8/mo 

米国西部(オレゴン)

https://byosms.usw2.pure.cloud/vendors/v1/twilio/b1adfe3a944c428bbc65d953bb8629b2/mo

カナダ(Canada Central)

https://byosms.cac1.pure.cloud/vendors/v1/twilio/1190471d172842c283dc5376a92df73d/mo

南米(サンパウロ)

https://byosms.sae1.pure.cloud/vendors/v1/twilio/44e8a8cd75f849b18ab6fc8bbad9a057/mo

ヨーロッパ(フランクフルト)

https://byosms.mypurecloud.de/vendors/v1/twilio/3d904439dc3f4eceb2e574b43c8f5ac5/mo

ヨーロッパ(アイルランド)

https://byosms.mypurecloud.ie/vendors/v1/twilio/a123cbc6467b48ccbdccc3e03fd30f4d/mo

ヨーロッパ(ロンドン)

https://byosms.euw2.pure.cloud/vendors/v1/twilio/f5c59e8b3a1345739ebd4564a340e526/mo

ヨーロッパ(チューリッヒ)

https://byosms.euc2.pure.cloud/vendors/v1/twilio/FhcOBGsMEALrQfWsxH1LQy39tzI3F3qk/mo  

中東(UAE)

https://byosms.mec1.pure.cloud/vendors/v1/twilio/N1aXOj92NXNBA21KqdkZfA3kFjdmAM2B/mo

アジア・パシフィック(大阪)

https://byosms.apne3.pure.cloud/vendors/v1/twilio/yXaIsznST36qG0qy7UAP4mWlsHDHh0E0/mo

アジア太平洋 (ソウル)

https://byosms.apne2.pure.cloud/vendors/v1/twilio/2e58f741f7a547b49c15c64dfb305361/mo

アジア太平洋 (シドニー)

https://byosms.mypurecloud.com.au/vendors/v1/twilio/97b4889e04514098a34715f0c216bf7b/mo

アジア太平洋 (東京)

https://byosms.mypurecloud.jp/vendors/v1/twilio/b7c9a0818bc343379513f713247b56ce/mo

アジア太平洋 (ムンバイ)

https://byosms.aps1.pure.cloud/vendors/v1/twilio/b462e102a5414620bc6f002bc561595d/mo

警告:
  • インポートを試みる前にTwilio番号にWebhook URLが設定されていない場合、Genesys Cloudはインポートリクエストを拒否します。
  • Genesys CloudのBYO SMSは、TwilioのセカンダリーAuthTokensオプションをサポートしていません。

GenesysクラウドのBYO SMSは、セカンダリAuthTokensオプションをサポートしていません。Twilioは、受信SMS/MMSメッセージで提供されたプライマリAuthtokenを暗黙的に使用するからです。 残念ながら、この暗黙の使用は、Genesys Cloud が AuthToken を検証しようとしたときに失敗を引き起こします。 別の方法として、Genesysは、BYO SMS統合にTwilioサブアカウントを使用することをお勧めします。 詳細については、TwilioのGetting Started with Twilio Accounts and Subaccounts の記事を参照してください。

BYO Twilio SMSインテグレーションをセットアップする

BYO Twilio SMSインテグレーションをセットアップするには、以下のステップを実行します:

  1. 管理をクリックします。
  2. 統合統合をクリックします。
  3. [統合] をクリックします。
  4. Bring Your Own Twilio SMS Account Configuration タイルを探します。
  1. Genesys AppFoundry にアクセスします。
  2. BYO Twilio SMSインテグレーションを検索してください。
  3. BYO Twilio SMSインテグレーションをGenesys Cloud組織に追加するには、手順に従ってください。

  1. クリック インストール. Bring Your Own Twilio SMS Account Configuration 画面が表示されます。
  2. (オプション)詳細 タブで、統合の名前をカスタマイズし、メモを追加します。
     メモ:   Genesysは、使用しているTwilioアカウントを識別するために、名前とメモを使用することを推奨します。
  3. 構成タブをクリックします。
  4. クリック 資格情報 タブ。
  5. クリック 構成. [資格情報の構成] ダイアログボックスが表示されます。
  6. Account SID ボックスに、TwilioアカウントのSIDを入力します。 
  7. Authorized Token ボックスに、Twilio アカウントの Authorized Token を入力します。
     メモ:   Genesys CloudはTwilioの認証情報を暗号化し、安全な環境に保存します。 詳細については、Genesys Cloud はクレデンシャルをどのように扱うのか を参照してください。
  8.   [OK] をクリックします。
  9. 保存するをクリックします。
  10. StatusActive に設定する。

SMS番号目録に番号を追加する

BYO Twilio SMSインテグレーションをセットアップしたら、SMS番号インベントリに番号を追加する準備ができました。 一度に追加できる数字は1つだけです。

 メモ:   SMS番号目録にあなたの番号を追加しても、これらの番号の管理には影響しません。 基本的には、Genesys Cloudがこれらの番号をSMSに使用することを許可します。 番号はTwilioアカウントに残り、Twilioでの音声対話に使用することができます。

SMS番号を追加するには、以下の手順を実行します:

  1. 管理をクリックします。
  2. メッセージ下のSMS 番号インベントリをご覧ください。
  3. SMS Number Inventoryページが表示されたら、Add numbers をクリックします。
  4. クリック インポート。Import Numberダイアログが表示されます。
  5. 統合 リストから、番号をインポートする統合を選択します。
  6. Type リストから、インポートする番号のタイプを選択します。
    • ローカルモバイルフリーダイヤル を選択した場合:
      • Sender ID 」のボックスに、E164形式で数字を入力します。
    • ショートコード を選択した場合:
      • Country リストから、国を選択します。
      • Sender ID ボックスに数字を入力します。
  7. をクリックします。
  8. Type リストからShortcode を選択すると、Required interaction ダイアログが表示され、3つのタブそれぞれに情報を入力する必要があります。
    • Help
      • Keywords ボックスに、使用したいヘルプキーワードを入力します。
      • メッセージ ボックスに、ヘルプリクエストに応答して顧客に送信するメッセージを入力します。
    • オプトアウト タブ:
      • キーワード ボックスに、使用したいオプトアウト・キーワードを入力します。
      • メッセージ ボックスに、オプトアウト要求に応じて顧客に送信するメッセージを入力します。
    • Re Opt-in タブで:
      • キーワード ボックスに、使用したいオプトイン・キーワードを入力します。
      • メッセージ ボックスに、オプトイン要求に応じて顧客に送信するメッセージを入力します。
  9. インポートの確認 をクリックする。 Genesys CloudはSMS番号データを取得し、SMS番号インベントリページに戻ります。 番号のインポートが成功したことを知らせるトーストがページ上部に表示される。

詳細については、SMSロングコード番号の在庫管理 を参照してください。

Genesys CloudのTwilio SMSインテグレーションを停止することは一時的なものです。 統合を無効にすると、この統合のためにインポートされたすべての番号は、SMS番号インベントリで無効になります。 しかし、受信メッセージはTwilioからGenesys Cloudに転送される間、ドロップされる。 つまり、あなたが設定したキューにはルーティングされない。

連携を停止している間、TwilioからGenesys Cloudに受信メッセージと配信レポートを送信したくない場合は、番号のWebhookをGenesys Cloud Webhook URL以外に変更してください。

メモ: 
  • Genesys CloudでTwilio SMSインテグレーションを停止しても、Twilioアカウントの番号は停止されません。
  • 後でTwilio SMS統合を再開する場合は、Webhook URLをGenesys CloudのWebhook URLに戻します。

Twilio コンソールの詳細については、Twilio のWebhooks の記事を参照してください。 統合を非アクティブにする方法の詳細については、Edit, deactivate, or delete an integration を参照してください。

警告:  Twilio SMSインテグレーションを削除すると、アクティブな受信フローやキュー構成に関係なく、インポートされたすべての番号がSMS番号インベントリから削除されます。

Genesys CloudでBYO SMS Twilioインテグレーションを削除した場合、Twilioコンソールですべての番号のInbound Webhook URLを元の設定に戻す必要があります。 Webhook URLを変更しない場合、受信メッセージは引き続きGenesys Cloudにルーティングされ、そこでメッセージはドロップされます。 メッセージは設定したキューにルーティングされない。

 メモ:   Genesys CloudでTwilio SMSインテグレーションを削除しても、Twilioアカウントから番号は削除されません。 ジェネシス・クラウドで数字を使う機能がなくなるだけです。

Twilio コンソールの詳細については、Twilio のWebhooks の記事を参照してください。 統合を削除する方法の詳細については、「Edit, deactivate, or delete an integration 」を参照してください。

既存のTwilioアカウントをGenesys Cloudに統合する際にエラーが表示された場合は、こちらの表で詳細をご確認ください。

 メモ:   SMSメッセージの配信で問題が発生した場合は、Twilioに直接お問い合わせください。

メッセージ 説明
BYO送信者IDの統合をご確認ください。 このメッセージは、リクエストがバックエンドサービスに送信され、インテグレーションに送信者IDがない場合に表示されます。 
送信者IDに必要なコンプライアンスキーワードとメッセージをご記入ください。

このメッセージは、コンプライアンス情報のいずれかが欠落している場合に表示される。 Required interactionダイアログの3つのタブのフィールドをチェックする:

  • ヘルプ
  • オプトアウト
  • 再オプトイン
送信者IDの種類をご確認ください。

このメッセージは、電話番号またはショートコードのいずれかが正しくフォーマットされていない場合に表示されます。

  • 電話番号はE.164形式でなければならない。
  • ショートコードは5文字以上6文字以下でなければならない。
送信者IDの国コードをご確認ください。 このメッセージは、電話番号と国番号が一致しない場合に表示されます。
この電話番号アドレスに対しては、すでにプロビジョニング・アクションが進行中です。 このメッセージは、すでにプロビジョニングされているリクエストを再送信しようとすると表示されます。 提供までに時間がかかる番号もある。
この電話番号アドレスはプロビジョニングに使用できません。 別の電話番号アドレスを選択して、もう一度お試しください。 このメッセージは、電話番号がすでに別の組織でプロビジョニングされている場合に表示されます。
この電話番号は、ベンダーでは見つけることができません。 このメッセージは、電話番号がTwilioサブアカウントに存在しない場合に表示されます。