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メッセージを送受信できます。
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オプションをサポートしていません。
BYO Twilio SMSインテグレーションをセットアップする
BYO Twilio SMSインテグレーションをセットアップするには、以下のステップを実行します:
- 管理をクリックします。
- 統合で統合をクリックします。
- [統合] をクリックします。
- Bring Your Own Twilio SMS Account Configuration タイルを探します。
- Genesys AppFoundry にアクセスします。
- BYO Twilio SMSインテグレーションを検索してください。
- BYO Twilio SMSインテグレーションをGenesys Cloud組織に追加するには、手順に従ってください。
- クリック インストール. Bring Your Own Twilio SMS Account Configuration 画面が表示されます。
- (オプション)詳細 タブで、統合の名前をカスタマイズし、メモを追加します。 メモ: Genesysは、使用しているTwilioアカウントを識別するために、名前とメモを使用することを推奨します。
- 構成タブをクリックします。
- クリック 資格情報 タブ。
- クリック 構成. [資格情報の構成] ダイアログボックスが表示されます。
- Account SID ボックスに、TwilioアカウントのSIDを入力します。
- Authorized Token ボックスに、Twilio アカウントの Authorized Token を入力します。 メモ: Genesys CloudはTwilioの認証情報を暗号化し、安全な環境に保存します。 詳細については、Genesys Cloud はクレデンシャルをどのように扱うのか を参照してください。
- [OK] をクリックします。
- 保存するをクリックします。
- Status をActive に設定する。
SMS番号目録に番号を追加する
BYO Twilio SMSインテグレーションをセットアップしたら、SMS番号インベントリに番号を追加する準備ができました。 一度に追加できる数字は1つだけです。
SMS番号を追加するには、以下の手順を実行します:
- 管理をクリックします。
- メッセージ下のSMS 番号インベントリをご覧ください。
- SMS Number Inventoryページが表示されたら、Add numbers をクリックします。
- クリック インポート。Import Numberダイアログが表示されます。
- 統合 リストから、番号をインポートする統合を選択します。
- Type リストから、インポートする番号のタイプを選択します。
- ローカル 、モバイル 、フリーダイヤル を選択した場合:
- Sender ID 」のボックスに、E164形式で数字を入力します。
- ショートコード を選択した場合:
- Country リストから、国を選択します。
- Sender ID ボックスに数字を入力します。
- ローカル 、モバイル 、フリーダイヤル を選択した場合:
- 次をクリックします。
- Type リストからShortcode を選択すると、Required interaction ダイアログが表示され、3つのタブそれぞれに情報を入力する必要があります。
- Help :
- Keywords ボックスに、使用したいヘルプキーワードを入力します。
- メッセージ ボックスに、ヘルプリクエストに応答して顧客に送信するメッセージを入力します。
- オプトアウト タブ:
- キーワード ボックスに、使用したいオプトアウト・キーワードを入力します。
- メッセージ ボックスに、オプトアウト要求に応じて顧客に送信するメッセージを入力します。
- Re Opt-in タブで:
- キーワード ボックスに、使用したいオプトイン・キーワードを入力します。
- メッセージ ボックスに、オプトイン要求に応じて顧客に送信するメッセージを入力します。
- Help :
- インポートの確認 をクリックする。 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 を参照してください。
Genesys CloudでBYO SMS Twilioインテグレーションを削除した場合、Twilioコンソールですべての番号のInbound Webhook URLを元の設定に戻す必要があります。 Webhook URLを変更しない場合、受信メッセージは引き続きGenesys Cloudにルーティングされ、そこでメッセージはドロップされます。 メッセージは設定したキューにルーティングされない。
Twilio コンソールの詳細については、Twilio のWebhooks の記事を参照してください。 統合を削除する方法の詳細については、「Edit, deactivate, or delete an integration 」を参照してください。
既存のTwilioアカウントをGenesys Cloudに統合する際にエラーが表示された場合は、こちらの表で詳細をご確認ください。
メッセージ | 説明 |
---|---|
BYO送信者IDの統合をご確認ください。 | このメッセージは、リクエストがバックエンドサービスに送信され、インテグレーションに送信者IDがない場合に表示されます。 |
送信者IDに必要なコンプライアンスキーワードとメッセージをご記入ください。 |
このメッセージは、コンプライアンス情報のいずれかが欠落している場合に表示される。 Required interactionダイアログの3つのタブのフィールドをチェックする:
|
送信者IDの種類をご確認ください。 |
このメッセージは、電話番号またはショートコードのいずれかが正しくフォーマットされていない場合に表示されます。
|
送信者IDの国コードをご確認ください。 | このメッセージは、電話番号と国番号が一致しない場合に表示されます。 |
この電話番号アドレスに対しては、すでにプロビジョニング・アクションが進行中です。 | このメッセージは、すでにプロビジョニングされているリクエストを再送信しようとすると表示されます。 提供までに時間がかかる番号もある。 |
この電話番号アドレスはプロビジョニングに使用できません。 別の電話番号アドレスを選択して、もう一度お試しください。 | このメッセージは、電話番号がすでに別の組織でプロビジョニングされている場合に表示されます。 |
この電話番号は、ベンダーでは見つけることができません。 | このメッセージは、電話番号がTwilioサブアカウントに存在しない場合に表示されます。 |