Genesys Cloud Inbound Connector

Genesys Cloud Inbound Connectorについて

Genesys Cloudインバウンドコネクターを使用して、Genesys CloudアカウントからXM Discoverにチャットデータをロードできます。

Genesys Cloudで必要なセットアップ

XM DiscoverをGenesys Cloudに接続するには、Genesysアカウントに関する以下の情報が必要です：

• クライアント・キー
• クライアントシークレット
• ユーザー名とパスワード
• 組織の環境URL

さらに、Genesys Cloud内にOAuthクライアントを作成する必要があります。クライアントの作成手順については、Genesys のドキュメントを参照してください。セットアップの際、以下の詳細を必ずご記入ください：

• 補助金の種類：コードを選択認証
• 正規のリダイレクトURL： URLhttps://data.clarabridge.net/connectors?token_type=genesys。
• スコープanalytics:readonly」と「conversions:readonly」を選択します。

Genesys Cloudインバウンドジョブの設定

1. [ジョブ] ページで、[新規ジョブ] をクリックします。
   
2. Genesys Cloudを選択します。
   
3. ジョブを特定できるように、ジョブに名前を付けます。
   
4. データをロードするプロジェクトを選択します。
5. 目的がわかるように、ジョブに説明を付けます。
6. [次へ] をクリックします。
7. 使用するGenesysアカウントを選択するか、「新規追加」を選択して新しいアカウントを追加します。
   
8. 新規アカウントを追加する場合は、以下の情報を入力する：
   • 接続名： 接続を識別できるように名前を付けます。
   • ジェネシス・クラウド・クライアント・キー Genesysコンシューマー・キー
   • ジェネシス・クラウド・クライアントの秘密： あなたのジェネシス・コンシューマーの秘密。
   • Genesysクラウド環境： 組織のGenesys環境URL。
     Qtip:Genesys CloudのAWSリージョン リストでリージョンを探し、”https://login. “以降のURL部分をコピーしてください。
9. Authorizeをクリックします。
10. 認証情報の有効期限を設定したい場合は、以下のオプションを設定する：
    
    • 期限切れ通知を送信する：クレデンシャルの有効期限を設定するには、このオプションを選択します。
    • 有効期限までの日数：有効期限切れ通知を有効にする場合、有効期限切れの何日前に通知を希望するかを入力します。1 日から 100 日の間の値を入力することができます。
    • 有効期限: 認証情報の有効期限が切れる日付を設定します。ボックスをクリックしてカレンダを開き、日付を選択します。
11. [次へ] をクリックします。
12. Genesysからアップロードするデータの種類を選択します。
    
13. [次へ] をクリックします。
14. 必要に応じて、データマッピングを調整します。XM Discoverのマッピングフィールドの詳細については、「データマッピング」サポートページを参照してください。データマッピングのセクションには、このコネクタに固有のフィールドに関する情報があり、会話フィールドのマッピングのセクションには、会話データのフィールドをマッピングする方法が記載されています。
    

    Qtip: Genesysでデータソースが削除された場合、コネクタは以下のフィールドの不足データに対して空白の値を返します：

    • エージェントID
    • エージェント名
    • エージェント部門
    • latestAgentId
    • latestAgentDivisionId
    • 最新のエージェント部門
    • 最新エージェント
    • 変換キュー
    • 最新キュー
15. [次へ] をクリックします。
16. 必要に応じて、データ代替ルールおよび編集ルールを追加して、機密データを非表示にしたり、顧客フィードバックおよびインタラクションの特定の単語およびフレーズを自動的に置換したりすることができます。データ置換と再編集のサポートページをご覧ください。
    
    Qtip:サンプルデータのダウンロードをクリックすると、サンプルデータを含むエクセルファイルがコンピュータにダウンロードされます。
17. [次へ] をクリックします。
18. 必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
    
19. また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
    ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
20. [次へ] をクリックします。
21. 通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
    
22. [次へ] をクリックします。
23. 重複伝票の処理方法を選択します。詳細については、重複処理を参照してください。
    
24. ジョブをスケジュールに従って定期的に実行する場合は、増分実行のスケジュールを選択します。ジョブを 1 回だけ実行する場合は、ワンタイムプル設定を選択します。詳細については、ジョブスケジュールを参照してください。
25. [次へ] をクリックします。
26. 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
    
27. [完了] をクリックしてジョブを保存します。

データマッピング

デフォルトフィールド

このセクションでは、Genesys Cloud受信ジョブのデフォルト・フィールドに関する情報を提供します。

• ナチュラルID：文書の一意な識別子。重複を正しく処理するには、伝票ごとに一意の ID を設定することを強くお奨めします。[Natural ID] では、データから任意のテキストフィールドまたは数値フィールドを選択できます。または、ユーザ定義項目を追加して ID を自動的に生成することもできます。
• 伝票日付: 文書に関連付けられている主要な日付フィールド。この日付は、XM Discoverのレポート、トレンド、アラートなどで使用されます。以下のオプションのいずれかを選択できます：
  • conversationStart（デフォルト）：チャットアクティビティの開始日時。
  • conversationEnd：チャットが終了した日時。
  • データソースに他の日付フィールドが含まれている場合は、そのいずれかを選択できます。
  • 特定の伝票日付を設定することもできます。
• feedback_provider: 特定のプロバイダから取得したデータを識別します。Genesys Cloudドキュメントの場合、この属性の値は “Genesys “に設定され、変更することはできません。
• ソース：特定のソースから取得したデータを特定する。これは、サーベイやモバイルマーケティングキャンペーンの名称など、データの発生源を示すあらゆるものにできます。デフォルトでは、この属性の値は “Genesys “に設定されている。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
• feedback_type: データをそのタイプに基づいて識別します。これは、プロジェクトにさまざまなタイプのデータ（アンケートやソーシャルメディアフィードバックなど）が含まれる場合にレポートに役立ちます。デフォルトでは、この属性の値は “Messaging Platform “に設定されています。カスタム変換を使用して、カスタム値の設定、式の定義、または別のフィールドへのマッピングを行います。
• job_name: アップロードに使用されたジョブの名前に基づいてデータを識別します。設定時に各ページの上部に表示されるジョブ名フィールドを使用して、設定時にこの属性の値を変更することができます。
• loadDate：ドキュメントがXM Discoverにアップロードされた日時を示します。この項目は自動的に設定され、変更することはできません。

追加ソース・フィールド

デフォルト・フィールドに加えて、Genesys コネクタ内にはさらに多くのソース・フィールドがあります。

• agentDivisions：会話に関与するすべてのエージェントの部署。
• agentIds：会話に関与するすべてのエージェントの一意な識別子。
• エージェント名：会話に関与するすべてのエージェントの名前。
• chatDuration：会話の継続時間。
• conversationQueues：会話のすべてのキュー。
• customerSessions：カスタマージャーニーの一次識別子。
• HowEnded：会話の終わり方。
• latestAgent：会話に最後に参加したエージェントの名前。
• latestAgentDivision：最後に会話に参加したエージェントの部署名。
• latestAgentDivisionId：最後に会話に参加したエージェントの部署を示す一意の識別子。
• latestAgentId：会話に最後に関与したエージェントの一意な識別子。
• latestQueue：会話の最後のキューの名前。

カスタムフィールド

カスタムの顧客属性は、接頭辞custom_fieldsを使用してデータマッピングに追加することができます。カスタム属性は、Genesysインスタンス構成に依存します。Genesysでこれらの属性を表示する手順については、Genesysのドキュメントを参照してください。