GainsightのTimelineのアクティビティをSalesforceと同期する方法

詳細な情報を追加して、この記事をUpdateしました！
 

SalesforceのTask/Todoオブジェクトと同期する方法

1. 管理＞タイムライン＞ACTIVITY SYNC に移動
    
2. General Settingsの設定を行う
   • Sync To：Task/Todoに連携するときは、「Salesforce Tasks」ラジオボタンを選択
   • Salesforce Status：アクティビティを同期した時の「状況」の値。連携したアクティビティは固定値で渡されるので、どの値の状況でデータを連携するか決定します。アクティビティごとの値の変更はできません。
   • Salesforce Priority：アクティビティを同期した時の「優先度」の値。連携したアクティビティは固定値で渡されるので、どの値の優先度でデータを連携するか決定します。アクティビティごとの値の変更はできません。
   • Sync Frequency ：連携頻度を選択します。リアルタイム同期ではSalesforceのAPIの制限に注意する必要があります。スケジュールを選択すると、4時間ごとに自動的に連携されます。
   • Sync attachments to salesforce：添付ファイルを同期したい場合はONにします。

3. Field Mappingの設定を行う
   Gainsightのタイムラインアクティビティのフィールドと、SalesforceのTask/Todoのフィールドのデフォルトマッピングは変更することができません。
   フィールドマッピングの設定と、Gainsightのアクティビティ内項目とSalesforceのTask / Todo の各項目のマッピングイメージは以下のようになります。

優先度と状況は、General Settingsで決めた固定の値が入ります。

添付ファイルの連携を有効にした場合は、該当のTodoの関連部分の添付ファイルに入ります。

4. 管理＞タイムライン＞ GENERAL AETTINGS に移動
   ActivityTypeのうち、Salesforceに連携したいアクティビティの「Sync to Salesforce」にチェックを入れたアクティビティのみが、Salesforceに連携されます。
   チェックをつけたら、リアルタイムか4時間おきに、追加したアクティビティが連携されます。

SalesforceのEvent/行動オブジェクトと同期する方法

1. 管理＞タイムライン＞ACTIVITY SYNC に移動
    
2. General Settingsの設定を行う
   • Sync To：Event/行動に連携するときは、「Salesforce Events」ラジオボタンを選択
   • Sync Frequency ：連携頻度を選択します。リアルタイム同期ではSalesforceのAPIの制限に注意する必要があります。スケジュールを選択すると、4時間ごとに自動的に連携されます。
   • Sync attachments to salesforce：添付ファイルを同期したい場合はONにします。

3. Field Mappingの設定を行う
   Gainsightのタイムラインアクティビティのフィールドと、SalesforceのEvent/行動のフィールドのデフォルトマッピングは変更することができません。
   フィールドマッピングの設定と、Gainsightのアクティビティ内項目とSalesforceのEvent/行動 の各項目のマッピングイメージは以下のようになります。
   ここでは、Event/行動オブジェクトの「終了」日時が必須フィールドのため、FieldMappingにカスタムフィールドを追加して、「アクティビティ日付」が「終了」フィールドに入るように設定します。

5. 管理＞タイムライン＞ GENERAL AETTINGS に移動
   ActivityTypeのうち、Salesforceに連携したいアクティビティの「Sync to Salesforce」にチェックを入れたアクティビティのみが、Salesforceに連携されます。
   チェックをつけたら、リアルタイムか4時間おきに、追加したアクティビティが連携されます。

正しく連携されたかGainsightから確認する方法
Gainsightのレポートビルダーを使って確認することができます。
 

1. 成功したかどうかを確認する場合
   管理＞分析＞レポートビルダー　から、新規レポートを作成します。
   • オブジェクト：アクティビティタイムライン
   • 表示フィールド：Task/ToDo連携の場合「SalesforceタスクID」、Event/行動連携の場合「SalesforceイベントID」を選択。
   • その他、「件名」「アクティビティ日付」「タイプ名」 など、表示したいフィールドを選択し、必要に応じてフィルターをかけてレポートを実行

成功している場合、SalesforceタスクIDか、SalesforceイベントIDの値が取得できている。

2. 失敗のエラーメッセージを確認する場合
   管理＞分析＞レポートビルダー　から、新規レポートを作成します。
   • オブジェクト：Gainsightエラーログ
   • 表示フィールド：「例外タイプ」「メッセージ」「エンティティID」
   • その他、「作成日」「エンティティタイプ」「名前」など、表示したいフィールドを選択し、必要に応じてフィルターをかけてレポートを実行

失敗時のエラーメッセージが「メッセージ」に表示されるので、その内容をもとにエラーを推測する。エラーの詳細はレポートをダウンロードして確認する。
例：[{"statusCode":"REQUIRED_FIELD_MISSING","message":"Required fields are missing: [DurationInMinutes]","fields":["DurationInMinutes"]}]

Configure Timeline Activity Sync

補足として、GainsightからSalesforceへのTimeine ActivitySyncを行うためには、Salesforce環境に

GainsightCustomerSuccessのパッケージインストールが必要です。