SalesforceからZendeskへのデータ同期の設定

Suiteすべて

Zendesk for Salesforceインテグレーションは、SalesforceからZendesk Supportへの一方向のデータ同期を行います。この記事では、2種類のデータ同期を設定する方法について説明します。

Salesforceの取引先からZendeskの組織へ：Salesforceの取引先が作成または変更されると自動的にSupportのZendeskの組織が作成および更新されます。
Salesforceの取引先責任者からZendeskユーザーまたはリードへ：Salesforceで取引先責任者またはリードが作成または変更されると、SupportのZendeskユーザーが自動的に作成および更新されます。

この記事では、次のトピックについて説明します。

データ同期プロセスについて
- Salesforceの取引先からZendeskの組織への同期
- Salesforceの取引先責任者またはリードからZendeskユーザーへの同期
データ同期の設定
同期フィルタリングについて
照合条件について
フィールドのマッピングについて
- Salesforceの取引先からZendeskの組織へのフィールドのマッピング
- Salesforceの取引先責任者またはリードからZendeskユーザーへのフィールドのマッピング
データ同期の設定の確認

Salesforceインテグレーション関連のリソース

データ同期プロセスについて

マップピングされたフィールドで既存のSalesforceレコードが更新されるか、新しいレコードが作成されると、データ同期がトリガされます。マップピングされていないフィールドが更新されてもフィールドの同期はトリガされません。

Salesforceのレコードが作成または変更されると、同期プロセスによって、Support内で新規レコードの作成また既存レコードの更新が試みられます。この処理では、定義された条件に基づいてフィールド値の比較が行われます。

Supportで既存のレコードと一致するか、新しいレコードが作成されると、SalesforceのレコードとSupportのレコードがリンクされます。つまり、Salesforceでその後レコードが更新されても、照合条件が使用されることはありませんが、その代わり、リンクされたSupportのレコードが更新されます。

一致する結果が複数見つかった場合、同期処理ではどのレコードを更新する必要があるかを判断できません。これはバックグラウンドで行われる処理であるため、同期中の間はどのレコードも更新せず、同期エラーのイベントをログに記録します。

Salesforce APIを使用してマッピングされたフィールドに対してレコードが作成または更新されると、Zendeskへの同期が開始されます。

データの同期は一方向であるため、Zendesk側で加えた変更はSalesforceには反映されません。

Salesforceの取引先からZendeskの組織への同期

Salesforceの取引先からZendeskの組織への同期は1対1の同期であり、デフォルトでは取引先名と組織名でレコードを照合しますが、すべてのSalesforce実装がこのルールに従っているわけではありません。したがって、取引先名が重複している場合は、一意の別の取引先フィールドに対して変更を加えることができます。一意の取引先フィールドがない場合、この機能は適切に動作しない可能性があります。

このデータ同期には以下のような制限があります。

データの同期はSalesforceストリーミングAPIのガバナー制限を消費します。たとえば、同期するデータが大量にある場合、これはガバナーの制限を超え、データが同期されなくなる可能性があります。

Salesforceの取引先責任者またはリードからZendeskユーザーへの同期

Salesforceの取引先責任者またはリードからZendeskのユーザーへの同期は、一意のメールアドレスに基づいて1対1で行われますが、すべてのSalesforce実装がこれらのルールに従っているわけではないため、この機能がニーズに適しているかどうかを検討してください。

このデータ同期には以下のような制限があります。

セキュリティ上の理由から、Zendeskユーザーがエージェントまたは管理者である場合、Salesforceの取引先責任者とZendeskユーザーとの同期は行われません。
データの同期はSalesforceストリーミングAPIのガバナー制限を消費します。たとえば、同期するデータが大量にある場合、これはガバナー制限を超え、データが同期されなくなる可能性があります。

メモ：同じメールアドレスを持つ複数のSalesforceの取引先責任者がいて、それぞれが異なる取引先に属している場合、Zendeskのユーザーと同期するには、Supportの複数の組織機能を使用します。詳細については、「Salesforceインテグレーションでの複数組織のメンバーシップの使用」を参照してください。

データ同期の設定

データ同期を設定するには、SalesforceおよびZendesk管理センターでいくつかのタスクを実行する必要があります。

インテグレーションでデータ同期を設定するには

Zendesk for Salesforceインテグレーションを設定します。
Salesforce APIの設定と同期の権限を設定します。
管理センターで、Salesforceの取引先からZendeskの組織へおよびSalesforceの取引先責任者またはリードからZendeskユーザーへの同期を設定します。

Salesforce APIの設定と権限の設定

データ同期を設定する前に、データ同期が正常に行われるよう、一部のSalesforce APIの設定と権限を有効にする必要があります。次の手順の情報は、Salesforce Lightningエディション用に記述されています。

Salesforce APIを有効にするには

Salesforceの「Setup」ページで、「Administration」>「Users」>「Profiles」を選択します。
「System Administrator」または認証されたユーザーのプロフィールを選択します。
「System Permissions」をクリックし、「API enabled」チェックボックスを選択します。

ストリーミングAPIチャネルのアクセス権限を設定するには

Salesforceの「Setup」ページで、「Administration」>「Users」>「Profile」を選択します。
インテグレーションを設定する管理者のユーザープロフィールを選択します。
「Object Settings」>「Streaming Channels」をクリックし、「Object Permissions」で「Read」チェックボックスを選択します。

トピックのプッシュのアクセス権限を設定するには

Salesforceの「Setup」ページの左側のサイドバーで、「Administration」>「Users」>「Profile」を選択します。
インテグレーションを設定する管理者のユーザープロフィールを選択します。
「Object Settings」>「Push Topic」の順にクリックして、「Edit」をクリックします。
「Object Permissions」で、「Read」チェックボックスを選択し、「Save」をクリックします。

ストリーミングAPIを有効にするには

Salesforceの「Setup」ページの左側のサイドバーで、「Platform tools」>「User Interface」>「User Interface」を選択します。
「Setup」で、「Enable Streaming API」チェックボックスを選択します。

Salesforceの取引先からZendeskの組織への同期設定

次の手順では、Salesforceの取引先が作成または変更されたときに、SupportにZendeskの組織が自動的に作成および更新されるように同期を設定する方法について説明します。

重要：これは上級者向けの機能です。データをSalesforceからZendeskに同期した後、元に戻すことはできません。まずテストしてからこの機能を使用することを強くお勧めします。

Salesforceの取引先からZendeskの組織への同期を設定するには

管理センターで、サイドバーにあるアプリおよびインテグレーションアイコン（）をクリックし、「インテグレーション」>「インテグレーション」を選択します。
「Salesforce」で「設定」をクリックします。
「データの同期」サイドタブをクリックし、「取引先と組織の同期」で「設定」をクリックします。
「同期を有効にする」チェックボックスを選択し、取引先と取引先フィールドのZendeskへの同期を設定します。
「同期のフィルタリング」で、条件付きフィルターを設定して、Salesforceのどの取引先をZendeskに同期するかを定義します。詳細については、「同期フィルタリングについて」を参照してください。
「照合条件」で、Salesforceの取引先をZendeskの組織に対応させるための照合条件を設定します。詳細については、「照合条件について」を参照してください。
「フィールドのマッピング」で、Zendeskの組織フィールドに同期データを表示させるSalesforceの取引先フィールドをマッピングします。詳細については、「フィールドマッピングについて」を参照してください。
「同期された組織のマッピング」では、Zendeskの組織をSalesforceの取引先にマッピングすることを選択できます。任意の標準またはカスタムのSalesforce取引先項目を選択できます。この一方向同期は、Salesforceの取引先にリンクされたZendeskユーザーを表示するのに便利です。
メモ：同期に成功すると、Salesforceインテグレーションによって同期された組織マッピングフィールドにZendesk IDが書き込まれます。このフィールドに既存のデータがある場合は上書きされます。
外部IDをZendeskの組織外部IDフィールドに入力する場合は、「Zendeskの外部ID」のチェックボックスをオンにします。デフォルトでは、これはSalesforceの取引先IDにマッピングされます。
メモ：既存の外部ID値は上書きされ、元に戻すことはできません。これは、このフィールドに依存する他のアプリケーションに影響を与える可能性があります。この変更は、「保存」をクリックした場合にのみ適用されます。
「保存」をクリックして設定を保存します。保存された設定の確認が表示されます。

Salesforceの取引先責任者またはリードからZendeskユーザーへの同期設定

次の手順では、Salesforceの取引先責任者またはリードが作成または変更されたときに、SupportにZendeskのユーザーが自動的に作成および更新されるように同期を設定する方法について説明します。

メモ：ユーザーの同期時に、Zendeskのユーザーレコードを対応する組織に自動的にマップするには、「取引先責任者/リードのユーザーへの同期」と「取引先と組織の同期」の両方を有効にする必要があります。

Salesforceの取引先責任者またはリードからZendeskのユーザーへの同期を設定するには

管理センターで、サイドバーにあるアプリおよびインテグレーションアイコン（）をクリックし、「インテグレーション」>「インテグレーション」を選択します。
「Salesforce」で「設定」をクリックします。
「データの同期」サイドタブをクリックし、「取引先責任者/リードのユーザーへの同期」で「設定」をクリックします。
「同期を有効にする」チェックボックスを選択し、取引先責任者またはリードと関連する項目をZendeskに同期させるように設定します。
「同期タイプ」で、Salesforceの取引先責任者またはリードに基づいてZendeskユーザーを作成するかどうかを選択します。選択できるのは1つだけです。
「同期のフィルタリング」で、条件付きフィルターを設定して、Zendeskに同期させるSalesforceの取引先またはリードの取引先責任者を選択します。詳細については、「同期フィルタリングについて」を参照してください。
「照合条件」で、Salesforceの取引先責任者またはリードとZendeskのユーザーとを照合させる条件を設定します。詳細については、「照合条件について」を参照してください。
「フィールドのマッピング」で、Zendeskのユーザーフィールドに同期データを表示させるSalesforceの取引先責任者またはリードの項目をマッピングします。詳細については、「フィールドマッピングについて」を参照してください。
「取引先/リードのマッピング」では、ZendeskのユーザーをSalesforceの取引先責任者またはリードにマッピングすることを選択できます。任意の標準またはカスタムのSalesforce取引先責任者/リード項目を選択します。この一方向同期は、Salesforceの取引先責任者またはリードにリンクされたZendeskユーザーを表示するのに便利です。
メモ：マッピングされた項目を変更を加えた場合、変更後の同期にのみ適用されます。以前の同期は、IDを新しい項目に同期するために更新されることはありません。
外部IDをZendeskの組織外部IDフィールドに入力する場合は、「Zendeskの外部ID」のチェックボックスをオンにします。デフォルトでは、これはSalesforceの取引先IDにマッピングされます。
メモ：既存の外部ID値は上書きされ、元に戻すことはできません。これは、このフィールドに依存する他のアプリケーションに影響を与える可能性があります。この変更は、「保存」をクリックした場合にのみ適用されます。
「一般的なオプション」で、「登録確認メールを送信する」チェックボックスを選択して、Supportの新規ユーザーに登録確認メールを送信するが送信されるようにします。詳細については、「エンドユーザーアカウントのメールのカスタマイズ」を参照してください。
「保存」をクリックして設定を保存します。保存された設定の確認が表示されます。

同期フィルタリングについて

「データ同期」>「同期のフィルタリング」セクションでは、フィルターを適用して、Zendeskの組織に同期させるSalesforceの取引先、またはZendeskのユーザーに同期させるSalesforceの取引先責任者またはリードを選択できます。条件文を作成して同期を制御できます。フィルターが設定されていない場合は、すべての取引先が同期の対象となります。

同期フィルター条件を作成するには、フィールド、演算子、および値を指定します。

以下のすべての条件を満たす：Salesforceレコードを同期に含めるには、このセクションに追加されたすべての条件を満たす必要があります。
以下のいずれかの条件を満たす：Salesforceレコードを同期に含めるには、このセクションに追加された条件を1つ以上満たす必要があります。

同期のフィルタリングには次のルールがあります。

すべての値は大文字と小文字が区別される
条件内で複数の値をカンマで区切ることができる（スペース不要）
同期フィルターでSalesforceの選択リスト項目を使用する場合、値は選択リストオプションのAPI名であることが必要
Salesforceの「Account Record Type」項目はサポートされていない
チェックボックス型のフィールドを条件として使用する場合は、「true」または「false」の値を入力する

次のSalesforceの項目は、フィールドのフィルタリングではサポートされません。

数式項目
ルックアップ項目
ロングテキストエリア項目

照合条件について

「データの同期」>「照合条件」セクションでは、Salesforceの取引先をZendeskの組織に、またはSalesforceの取引先責任者またはリードをZendeskユーザーに対応させるための条件が設定されています。Salesforceのレコードが作成または変更されると、同期プロセスによってSupport内に新しい組織またはユーザーを作成するか、または既存の組織またはユーザーのレコードを更新するかどうかが確認されます。この確認では、「照合条件」に設定された値が比較されます。条件の一致が見つかると、フィールドのマッピング設定に従って対応するフィールドが更新されます。

Zendeskのフィールドのドロップダウンオプションは、Salesforceのフィールドのドロップダウンで選択したフィールドのタイプに応じて変わります。標準フィールドとカスタムフィールドの対応がサポートされています。

メモ：

現在、照合条件は1つしかサポートされていません。将来的には、複数の照合条件を追加できるようになります。
一致する結果が複数見つかった場合、どのレコードを更新する必要があるかを判断できないため、同期は成功しません。この場合、進行中の同期ではレコードを更新せず、失敗した同期イベントを記録します。

フィールドのマッピングについて

フィールドのマッピングセクションでは、SalesforceのフィールドをZendeskのフィールドにマッピングできます。Salesforceの取引先、取引先責任者、リードの各フィールドは、Zendeskの標準フィールドまたはカスタムフィールドにマッピングする必要があります。マッピングされたフィールドは同期中に更新されます。

マッピングする際に、複数選択リストのSalesforceフィールドを選択すると、「Mapped values」リンクが表示されます。このリンクをクリックすると、複数のSalesforceフィールドをZendeskフィールドにマッピングするためのウィンドウが開きます。

この場合、複数のSalesforceフィールドをZendeskの1つのフィールドにマッピングすることは避けてください。複数のSalesforceフィールドを1つの同じZendeskフィールドにマッピングした場合、同期されるのは最後にマッピングされたフィールドのみになります。

次のSalesforceフィールドは、フィールドのマッピングではサポートされません。

ロングテキストエリア項目
ルックアップフィールド。ルックアップフィールドの値は関連するSalesforceオブジェクトに保存されているため、SalesforceのルックアップフィールドをZendeskにマッピングすることはできません
レコードタイプID

Salesforceの取引先からZendeskの組織へのフィールドのマッピング

「データの同期」>「取引先と組織の同期」の「フィールドのマッピング」セクションでは、Zendeskの組織フィールドに同期データを表示させるSalesforceの取引先フィールドをマッピングします。これにより、Zendeskの組織名として同期されるSalesforceの取引先レコードのフィールドが決定されます。デフォルトでは、Salesforceの取引先名がZendeskの組織名にマッピングされます。

Zendeskのフィールドのドロップダウンオプションは、Salesforceのフィールドのドロップダウンで選択したフィールドのデータ型に応じて変わります。次の表に、ZendeskフィールドにマッピングできるSalesforceフィールドのデータ型を示します。

Salesforceフィールドのデータ型	本文	ドロップダウン	小数	チェックボックス	日付	数値
ID	✓
文字列	✓
電話番号	✓
選択リスト	✓	✓
通貨	✓		✓
ブール値	✓			✓
チェックボックス				✓
日時	✓				✓
数値	✓					✓
Double	✓		✓
日付	✓				✓
マルチセレクト選択リスト	✓
メール	✓

Salesforceの取引先責任者またはリードからZendeskユーザーへのフィールドのマッピング

「データの同期」>「取引先と組織の同期」の「フィールドのマッピング」セクションでは、Zendeskの組織フィールドに同期データを表示させるSalesforceの取引先責任者またはリードのフィールドをマッピングします。これにより、Zendeskのユーザーとして同期されるSalesforceの取引先責任者またはリードのレコードのフィールドが決定されます。デフォルトで、フィールドのマッピングはメールからメールへに設定されます。

Salesforceフィールドのデータ型	本文	ドロップダウン	小数	チェックボックス	日付	数値
ID	✓
文字列	✓
電話番号	✓
選択リスト	✓	✓
通貨	✓		✓
ブール値	✓			✓
チェックボックス				✓
日時	✓				✓
数値	✓					✓
Double	✓		✓
日付	✓				✓
マルチセレクト選択リスト	✓
メール	✓

データ同期の設定の確認

次のチェックリストを使用して、データの同期が正しく設定されていることを確認してください。

インテグレーションを設定する際に、Salesforce APIの設定要件を満たしていることを確認してください。
1つのZendeskアカウントに1つのSalesforceアカウントしか接続していないことを確認します。
同期フィルター：数式フィールドやルックアップフィールドなど、サポートされていないSaleforceフィールドを使用していないことを確認します。
同期フィルター：同期フィルターの値で正しい構文を使用していることを確認します。これらは大文字と小文字を区別し、Salesforceのフィールド値と完全に一致する必要があります。フィルタリングにSalesforceの選択リストフィールドを使用する場合、値はAPI名です。
フィールドマッピングの同期：フィールドのマッピングに名前から名前へが含まれていることを確認します。Zendeskの組織は名前なしでは作成できないため、これは必須です。
同期をテストするときに、ZendeskにマッピングされているSalesforceフィールドを更新しましたか？同期は、マッピングされたフィールドが更新されたときにのみ開始されます。