日本語
  1. Zendeskヘルプ
  2. Support
  3. Supportの使い方
  4. インテグレーションの設定
  5. Salesforceインテグレーション

ZendeskからSalesforceへのチケットの同期設定

Darren Chan
  • 編集済み


Zendesk for Salesforceインテグレーションでは、ZendeskのチケットとSalesforceのケースを同期させることができます。これにより、Salesforceで生成されたZendeskチケットのサポート解析に関するレポートを作成し、Salesforceの他のビジネスワークフローをトリガすることができます。

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

関連記事：

設定に先立つ推奨事項

チケットの同期は高度な機能であり、本番アカウントで設定する前に動作を理解することが重要です。次のタスクを実行することをお勧めします。

  • 本番アカウントで設定する前に、まずSalesforceとZendeskのサンドボックスアカウントでチケットの同期をテストします。
  • データの同期を有効にしていて、SalesforceのサンドボックスとZendeskの本番アカウントでテストしている場合、重複する組織レコードとユーザーレコードがZendeskに作成される可能性があるため、「組織の一致」と「チケットリクエスタの一致」で「一致しない場合に作成する」を有効にしないことをお勧めします。
  • 旧バージョンのインテグレーションを使用している場合、両方のインテグレーションでチケット同期を同時に有効にしないでください。Salesforceにレコードが重複して作成されるおそれがあります。新しいチケット同期を有効にする準備ができたら、まず旧バージョンのインテグレーションの同期機能を無効にしてください。詳細については、「Salesforceの旧インテグレーションから新しいインテグレーションへの移行」を参照してください。

チケットの同期を設定する

チケットの同期を設定するには、Salesforceのケースオブジェクト、Zendeskのトリガ、およびZendesk管理センターに対していくつかのタスクを実行する必要があります。

ZendeskからSalesforceへのチケットの同期を設定するには

  1. Zendesk for Salesforceインテグレーションを設定します。
  2. Salesforceのレコードタイプを作成する
  3. 管理センターにチケット同期パッケージをインストールする
  4. ZendeskのチケットとSalesforceのケースとの同期を設定する
  5. アクティブなSalesforceのトリガをZendesk Supportに設定する。

Salesforceケースのレコードタイプを作成する

レコードタイプは、Salesforceでカスタムビジネスプロセスを実装するために使用されます。レコードタイプの作成は必須ではありません。ただし、Salesforceのケースオブジェクトを別のプロセスで使用する場合は、レコードタイプによってZendeskのチケットが個別に保持されます。

Salesforceのレコードタイプを作成するには

  1. Salesforceで、右上の「Setup」をクリックし、「Object Manager」をクリックします。
  2. 「Object Manager」ページで、「Case」をクリックします。
  3. 左のナビゲーションウィンドウ「Record Types」をクリックし、ページの右上の「New」をクリックします。
  4. Salesforceページの手順に従って、レコードタイプを作成します。「Record Type Label」には「Zendesk Ticket Sync」という名前を付けることをおすすめします。

管理センターにチケット同期パッケージをインストールする

チケット同期パッケージは、ケースオブジェクト内に標準のZendeskチケットフィールドを作成し、それらを標準のケース項目にマッピングします。

チケット同期パッケージでケース項目を作成するには、認証されたユーザーがSalesforceメタデータAPIを変更する権限を持っている必要があります。

チケット同期パッケージをインストールするには

  1. Zendesk管理センターで、左のナビゲーションパネルでインテグレーションアイコン（）をクリックします。
  2. 「Salesforce」の横にある「設定」をクリックします。
  3. 「データの同期」サイドタブをクリックし、「チケットの同期」で「設定」をクリックします。
  4. チケットの同期パッケージで、「インストール」をクリックします。

ZendeskチケットとSalesforceケースとの同期を設定する

前のセクションの手順が完了すると、チケットの同期が有効になり、ZendeskのフィールドをSalesforceのケースにマッピングして同期できるようになります。

ZendeskのチケットをSalesforceのケースに送るよう設定するには

  1. Zendesk管理センターで、左のナビゲーションウィンドウのインテグレーションアイコン（）を選択します。
  2. 「Salesforceインテグレーション」の横にある「設定」をクリックします。
  3. 「データの同期」サイドタブをクリックし、「チケットの同期」で「設定」をクリックします。
  4. 「同期を有効にする」チェックボックスを選択し、ZendeskのチケットをSalesforceケースに送信する設定を指定します。
  5. 「レコードタイプ」で、前の手順で作成した「レコードタイプID」を入力します。Salesforceの取引先でレコードタイプIDを見つけるには、Setupアイコンをクリックし、「Object Manager」>「Case」>「レコードタイプ」をクリックし、目的のレコードタイプをクリックして、URL内にレコードタイプIDを確認できます。
  6. 「カスタムチケットフィールドのマッピング」で、Zendeskチケットフィールドと同期データを表示させるSalesforceのケース項目とをマッピングします。標準のフィールドマッピングと、マッピングをカスタマイズする機能が用意されています。必要なすべてのSalesforceケースフィールドをマッピングする必要があります。必須フィールドがマッピングされていない場合、同期に失敗します。詳細については、「標準フィールドのマッピング」と「カスタムフィールドのマッピング」を参照してください。
  7. 「組織の一致」で、Zendeskの組織をSalesforceの取引先に同期させる方法を設定します。詳細については、「組織の一致を設定する」を参照してください。
  8. 「チケットリクエスタの一致」で、ZendeskチケットリクエスタをSalesforceの取引先責任者またはリードに同期させるように設定します。詳細については、「チケットリクエスタの一致を設定する」を参照してください。
  9. 「保存」をクリックします。
設定を初めて保存すると、以下のSalesforceターゲットとZendeskトリガがSupportに作成されます。
  • ターゲット：（Salesforceインテグレーション）Sync tickets to Salesforce
  • トリガ：（Salesforceインテグレーション）Sync tickets to Salesforce
重要：このターゲットとトリガの名前は変更しないでください。

ターゲットは、チケットが作成または更新されたときに外部アプリケーションに通知するために使用されます。トリガはZendeskで定義されるビジネスルールです。

Zendeskのトリガを設定し有効化する

Zendeskのトリガは、条件とアクションから構成されます。トリガは、Zendeskチケットが作成または更新された直後に実行されます。

デフォルトでは、Salesforceトリガはアクティブになっていません。チケットの同期を実行するには、トリガ条件を確認し、トリガをアクティブにする必要があります。

トリガを設定し、有効化するには

  1. Zendesk Supportで、サイドバーにある管理アイコン（）をクリックし、「ビジネスルール」>「トリガ」を選択します。
  2. （Salesforceインテグレーション）Sync tickets to Salesforceトリガを見つけ、トリガ名をクリックして編集します。
  3. 必要に応じて、トリガの条件を変更します。条件をフィルターとして使用して、Salesforceに送信するチケットを設定します。トリガの名前は変更しないでください。
  4. 「保存」をクリックして、トリガの設定を保存します。
  5. 「トリガ」ページで、「非アクティブ」タブを選択します。
  6. （Salesforceインテグレーション）Sync tickets to Salesforceトリガの横の「その他のオプション」アイコンをクリックし、「アクティブにする」を選択します。

標準フィールドのマッピング

チケット同期パッケージがインストールされると、次の表に示すように、Zendeskはほどんどの標準チケットフィールドを作成してSalesforceのケース項目にマッピングします。

 
Zendeskのチケットフィールド Salesforceのケース項目
タイプ Type
優先度 Priority
ステータス Status
ZendeskのチケットID Zendesk_Support_Ticket_ID__c
件名 Subject
説明 Description
リクエスタID ContactId
リクエスタ名 Zendesk_Support_Ticket_Requester_Name__c
リクエスタのメール Zendesk_Requester_Email__c
組織ID AccountId
組織の名前 Zendesk_Support_Ticket_Organization_Name__c
ブランド名 Zendesk_Support_Ticket_Brand_Name__c
担当者名 Zendesk_Support_Ticket_Assignee_Name__c
担当者グループ Zendesk_Support_Ticket_Group_Name__c
タグ Zendesk_Support_Ticket_Tags__c
URL Zendesk_Support_Ticket_URL__c
チケットフォーム名 Zendesk_Support_Ticket_Form_Name__c
作成日時 Zendesk_Support_Ticket_Created_At__c
更新日時 Zendesk_Support_Ticket_Updated_At__c
解決された日時 Zendesk_Support_Ticket_Solved_At__c
最初に割り当てられた日時 Zendesk_Support_Ticket_Initial_Assigned__c
解決時間（カレンダー時間） Zendesk_Support_Ticket_Resolution_Cal__c
解決時間（営業時間） Zendesk_Support_Ticket_Resolution_Bus__c
メモ：現時点ではチケットコメントはサポートされていません。

カスタムフィールドのマッピング

カスタムフィールドのマッピングにより、以下のZendeskチケットフィールドをSalesforceのケースオブジェクトにマッピングできます。
  • リクエスタ待機時間 (カレンダー時間)
  • リクエスタ待機時間 (営業時間)
  • エージェント待機時間 (カレンダー時間)
  • エージェント待機時間 (営業時間)
  • 待機中時間 (カレンダー時間)
  • 待機中時間 (営業時間)
  • 初回返信時間 (カレンダー時間)
  • 初回返信時間 (営業時間)
これを行うには、まずSalesforceでカスタムのケース項目を作成し、次に管理センターでチケットフィールドをマッピングします。
メモ：Salesforceのマルチセレクトピックリストフィールドはマッピングできません。

ZendeskのチケットフィールドをSalesforceのケースオブジェクトにマッピングするには

  1. Salesforceで、右上の「Setup」をクリックし、「Object Manager」をクリックします。
  2. 「Object Manager」ページで、「Case」をクリックします。
  3. ナビゲーションウィンドウで「Fields & Relationships」セクションをクリックし、「New」をクリックします。
  4. 新しい項目の「Data Type」を選択し、「Nex」をクリックします。ほとんどの場合、「Text」、「Text Area」、「Number」のいずれかを選ぶとよいでしょう。Zendeskのドロップダウンフィールドについては、「Text」項目が適しています。選択した値だけが同期されます。
  5. 「Field Label」に入力します。この「Field Label」は、Zendeskの「カスタムフィールド名」と一致させることをお勧めします。
  6. その他の必須項目の設定を完了したら、「Save」をクリックします。
  7. 手順3～6を繰り返して、追加のカスタム項目を作成します。
  8. 管理センターで、Salesforceインテグレーションに移動し、「チケットの同期」>「設定」>「カスタムチケットフィールドのマッピング」に移動します。以前に作成したカスタムのケース項目がSalesforceの項目に表示されます。
  9. ZendeskフィールドをSalesforceの項目にマッピングし、「保存」をクリックします。

マッピング後、チケットがSalesforceに送信されると、フィールドマッピングに従ってカスタムフィールドのデータが自動的に入力されます。

組織の一致を設定する

チケットの同期を設定する場合、組織の一致条件を設定するためのオプションが2つあります。

  • 「取引先と組織の同期」が無効になっている場合、デフォルトの一致条件とフィールドマッピングを使用します。デフォルトの一致条件は、「組織名から取引先名へ」です。デフォルトでは、Zendeskがチケット情報をSalesforceに送信する際に、チケットの組織のメールアドレスと一致する取引先のメールアドレスがなかった場合に、Salesforce内に新しい取引先が作成されます。
  • 「取引先と組織の同期」が有効になっている場合は、設定されているカスタムの一致条件を使用して、チケットの組織とSalesforceの取引先が照合されます。カスタムの一致条件は、「管理センター」>「インテグレーション」>「Salesforceインテグレーション」>「設定」>「データの同期」>「取引先と組織の同期」で表示できます。

組織の一致のオプション

「組織の一致」セクションには、以下の設定オプションがあります。

  • 「Zendesk Salesforce組織IDのマッピング」では、Zendeskの組織IDをSalesforceの取引先項目にマッピングすることを選択できます。任意の標準およびカスタムのSalesforce取引先項目から選択できます。これは一方向の同期であり、どのSalesforce取引先がZendesk組織にリンクされているかを表示するのに役立ちます。

  • Salesforceのデフォルトの取引先ID：チケットの組織と一致しない場合に新しい取引先を作成することを選択した場合、Zendeskに組織が存在しなければ、Salesforceのデフォルトの取引先として既存の取引先を入力できます。デフォルトの取引先を設定しておくことで、無所属の取引先が作成されないようにできます。

    メモ：Salesforceの「組織」項目は、「リクエスタ」項目の取引先責任者の取引先を継承しません。「組織」項目には、Zendesk内のチケットに格納されている組織情報に基づいた情報のみが表示されます。
  • 「一致しない場合に作成する」チェックボックス：チケットの組織と一致する取引先がSalesforceに見つからないときに新しい取引先を作成する場合は、このチェックボックスを選択します。
    メモ：「取引先と組織の同期」を有効にしていて、SalesforceサンドボックスとZendeskの本番アカウントでテストしている場合は、「一致しない場合に作成する」チェックボックスを有効にしないことをお勧めします。これは、テスト中にZendeskに重複した組織レコードが作成されるのを防ぐためです。

チケットリクエスタの一致を設定する

チケットの同期を設定する場合、チケットのリクエスタの一致条件を設定するためのオプションが2つあります。

  • 「取引先責任者/リードのユーザーへの同期」が無効になっている場合、デフォルトの一致条件とフィールドマッピングを使用します。デフォルトでは、Zendeskがチケット情報をSalesforceに送信する際に、チケットリクエスタのメールアドレスと一致する取引先責任者がなかった場合に、Salesforce内に新しい取引先責任者が作成されます。
  • 「取引先責任者/リードのユーザーへの同期」が有効になっている場合は、設定されているカスタムの一致条件を使用して、チケットのリクエスタとSalesforceの取引先責任者/リードが照合されます。カスタムの一致条件は、「管理センター」>「インテグレーション」>「Salesforce」>「設定」>「データの同期」>「取引先と組織の同期」で表示できます。

チケットリクエスタの一致のオプション

「チケットリクエスタ」のセクションには、以下の設定オプションがあります。

  • 「ZendeskユーザーIDのマッピング」では、チケットリクエスターのユーザーIDを任意の標準またはカスタムのSalesforce取引先責任者/リード項目にマップすることを選択できます。これは一方向の同期で、ZendeskユーザーにリンクされているSalesforce取引先責任者/リードを表示するのに役立ちます。
  • 「ZendeskユーザーIDのマッピング」では、チケットリクエスタのユーザーIDを任意のSalesforce取引先責任者/リード項目にマップすることを選択できます。任意の標準およびカスタムのSalesforce取引先責任者/リード項目から選択できます。これは一方向の同期で、ZendeskユーザーにリンクされているSalesforce取引先責任者/リードを表示するのに役立ちます。
  • 「一致しない場合に作成する」チェックボックス：一致する既存のレコードが見つからない場合は、このチェックボックスをオンにして、チケットのリクエスタと一致するレコードが見つからないときにSalesforceに新しい取引先責任者またはリードを作成します。
    メモ：「取引先責任者/リードのユーザーへの同期」を有効にしていて、この機能をSalesforceサンドボックスとZendesk本番アカウントでテストしている場合は、「一致しない場合に作成する」チェックボックスを有効にしないことをお勧めします。これは、テスト中にZendeskに重複した組織およびユーザーレコードが作成されるのを防ぐためです。
  • Salesforceのデフォルトの取引先責任者IDまたはリードID：一致しないチケットのリクエスタに対して新しい取引先責任者を作成することを選択した場合、Zendeskにユーザーが存在しないときに、Salesforceの取引先責任者/リードIDを入力して、既存の取引先責任者またはリードを新しい取引先のデフォルトの取引先責任者/リードとして入力できます。

「チケットの同期」が正常にインストールされたかどうかを確認する

次の手順は、「チケットの同期」がSalesforceに正常にインストールされたかどうかを確認するのに役立ちます。
  1. 「Salesforce」>「Setup」>「Deployment Status」のに移動します。
  2. パッケージをインストールしたときの展開時間を確認して、展開が「successful」または「failed」であったかどうかを確認します。展開に失敗した場合、Salesforceによってエラーの詳細が提供されます。エラーを確認して解決してください。解決できない場合は、Zendeskのサポートチームに連絡し、エラーのスクリーンショットを提供してください。
  3. 「Salesforce」>「Object Manager」>「Case」>「Fields & Relationships」に移動します。次に示すように、標準の各Zendeskチケットフィールドに対して、Salesforce Caseオブジェクトに追加のケースフィールドが作成されているかどうかを確認します。
  4. 手順2および3が成功したことを確認したら、引き続き「チケットの同期」の設定を行います。

チケットの同期の設定を確認する

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

  • Zendesk Support設定でSalesforceトリガがアクティブにされていることを確認します。
  • トリガのJSONボディが編集されていないこと、以下に示すとおりであることを確認します。このJSONボディを変更すると、同期に失敗します。 
    {"ticket_id": {{ticket.id}}, "salesforce_org_id": "YOUR_SFDC_ORG_ID"}

  • 正しいレコードタイプIDを入力したことを確認します。レコードタイプIDに誤りがあると、同期に失敗します。メモ：レコードタイプIDは、「Salesforce Org ID」とは異なります。
  • すべての必須Salesforceケースフィールドがカスタムチケットフィールドマッピングに含まれていることを確認します。すべての必須フィールドをマッピングしないと、同期に失敗します。
他にご質問がございましたら、リクエストを送信してください

0 コメント

ログインしてコメントを残してください。

関連記事

関連記事

Powered by Zendesk