セールスフォース・インバウンド・コネクター

Salesforce Inbound Connectorについて

Salesforceインバウンドコネクターを使用して、SalesforceアカウントからXM Discoverに運用レポートデータをロードできます。

Salesforceで必要な設定

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

• お客様のSalesforceコンシューマキー（クライアントID）
• セールスフォース・コンシューマー・シークレット（顧客秘密）
• Salesforceのユーザー名とパスワード
• Salesforce組織の環境URL
• フィードバックやチャットのやり取りを取得するための検証 Salesforce Object Query Language (SOQL) クエリ
  Qtip:SOQL を使用すると、組織の Salesforce データから特定の情報を検索できます。SOQL は、広く使用されている構造化クエリ言語 (SQL) の「SELECT」文に似ていますが、Salesforce データ専用に設計されています。SOQL の紹介については、こちらの Salesforce ヘルプページを参照してください。

さらに、Salesforceアカウントで以下を実行する必要があります：

1. 接続しているアプリで、OAuth設定を有効にするを選択します。詳しくはSalesforceのヘルプページをご覧ください。
2. コールバックURLを次のように設定する：https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. 以下のOAuthスコープを選択してください：
   • カスタムアクセシビリティ (custom_permissions)
   • 一意のユーザー識別子（openid）へのアクセシビリティ
   • フルアクセス(フル)
   • API（エーピーアイ）によるユーザーデータの管理
   • いつでもリクエストを実行（refresh_token、offline_access）
   • PKCEが有効になっていないことを確認する
4. 同じコネクテッドマップで、Manage OAuth Access Policiesを選択します。詳しくはSalesforceのヘルプページをご覧ください。
5. 以下のオプションを選択してください：
   • 許可されるユーザー：すべてのユーザーが自己承認することができる。
   • リフレッシュ・トークンのポリシー：リフレッシュ・トークンは取り消されるまで検証されます。

Salesforce インバウンドジョブの設定

1. 求人情報ページで、 新規求人をクリックします。
   
2. Salesforce を選択します。
   
3. ジョブを特定できるように、ジョブに名前を付けます。
   
4. データをロードするプロジェクトを選択します。
5. 目的がわかるように、ジョブに説明を付けます。
6. [次へ] をクリックします。
7. 使用する Salesforce アカウントを選択するか、[新規追加] を選択して新しいアカウントを追加します。
8. 新しいアカウントを追加する場合は、Salesforce アカウントに関する以下の情報を入力します：
   • 接続名：接続を識別できるように名前を付けます。
   • Salesforce クライアント ID：Salesforce コンシューマーキー。
   • Salesforceクライアントの秘密: お客様のSalesforce利用者の秘密
   • Salesforce 環境：Salesforce組織の環境URL
   • テスト環境：テスト環境に接続する場合は、このオプションを有効にします。
9. [認証] をクリックします。
10. 認証情報の有効期限を設定したい場合は、以下のオプションを設定する：
    
    • 期限切れ通知を送信する：クレデンシャルの有効期限を設定するには、このオプションを選択します。
    • 有効期限までの日数：有効期限切れ通知を有効にする場合、有効期限切れの何日前に通知を希望するかを入力します。1 日から 100 日の間の値を入力することができます。
    • 有効期限: 認証情報の有効期限が切れる日付を設定します。ボックスをクリックしてカレンダを開き、日付を選択します。
11. [次へ] をクリックします。
12. Salesforceからアップロードするフィードバックの種類を選択します：
    
    • Salesforce フィードバック：定期的なフィードバックをアップロードします。
    • Salesforce Chat：Salesforce Chat からエージェント/クライアントとのやり取りをアップロードします。
    • Salesforce SMSテキスト：Salesforce LiveMessageからエージェント/クライアントとのやり取りをアップロードします。
13. Salesforce Chatをアップロードする場合、エージェントとクライアントの識別方法を選択します：
    • 自動検出：エージェント、チャットアシスタント、訪問者を自動的に検出します。
    • 最初の参加者はエージェントです：最初のチャット参加者はエージェントとして割り当てられます。
    • 最初の参加者はクライアントです：2人目のチャット参加者はエージェントとして割り当てられます。
14. 使用するAPIバージョンを選択します。
15. カスタム SOQL ステートメントを入力して、Salesforce から取得するデータを制限します。
    
    Qtip:チャットデータを取得するには、クエリーでLiveChatTranscriptオブジェクトを使用してください。
    注意GROUP BYはサポートされていません。
    例SELECT Id, CreatedDate, Body, ChatDuration FROM LiveChatTranscript.
16. Validate Query］をクリックしてSOQLステートメントを検証します。
17. 検証に成功した場合は、取得するデータの特定に使用する日付フィールドを選択する。
    Qtip:このリストには、SOQLクエリに存在するフィールドのみが含まれています。
18. 次へ」をクリックします。
19. 必要に応じて、データマッピングを調整します。XM Discoverのマッピングフィールドの詳細については、「データマッピング」サポートページを参照してください。デフォルトデータマッピングセクションには、このコネクタに固有のフィールドに関する情報があり、会話フィールドのマッピングセクションには、会話データのデータマッピング方法が記載されています。
    
20. [次へ] をクリックします。
21. 必要に応じて、データ代替ルールおよび編集ルールを追加して、機密データを非表示にしたり、顧客フィードバックおよびインタラクションの特定の単語およびフレーズを自動的に置換したりすることができます。データ置換と再編集のサポートページをご覧ください。
    Qtip:サンプルデータのダウンロードをクリックすると、サンプルデータを含むエクセルファイルがコンピュータにダウンロードされます。
22. [次へ] をクリックします。
23. 必要に応じて、受信データをフィルタリングするコネクタフィルタを追加して、インポートされるデータを制限することができます。
    
24. また、レコード制限の指定ボックスで数を入力して、1 つのジョブでインポートされるレコードの数を制限することもできます。すべてのレコードをインポートする場合は、”すべて” を入力します。
    ヒント：会話データの場合、上限は行ではなく会話に基づいて適用されます。
25. [次へ] をクリックします。
26. 通知を受け取るタイミングを選択します。詳細については、ジョブ通知を参照してください。
    
27. [次へ] をクリックします。
28. 重複伝票の処理方法を選択します。詳細については、重複処理を参照してください。
    
29. ジョブをスケジュールに従って定期的に実行する場合は、増分実行のスケジュールを選択します。ジョブを 1 回だけ実行する場合は、ワンタイムプル設定を選択します。詳細については、ジョブスケジュールを参照してください。
30. [次へ] をクリックします。
31. 設定をレビューします。特定の設定を変更する必要がある場合は、編集ボタンをクリックして、コネクタ設定のそのステップに移動します。
32. [完了] をクリックしてジョブを保存します。

デフォルトデータマッピング

このセクションでは、Salesforce の受信ジョブのデフォルトフィールドについて説明します。

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