メインコンテンツにスキップ

Salesforce統合のトラブルシューティングとよくある質問

Salesforceアプリの認証、フィールドマッピング、データ同期のトラブルシューティングガイド。

対応者:Beth-Ann Sher

IntercomとSalesforce間のデータはどのように同期されますか?

IntercomとSalesforce間でマッピングした属性は、どちらかのシステムで変更があった場合に同期されます。Intercomで変更が発生すると即座にSalesforceへの同期がトリガーされ、Salesforceは5分ごとにIntercomへの同期対象の変更があるか確認されます。異なる状況でのデータ更新方法の詳細は下記の表をご覧ください。

SalesforceまたはIntercomで変更(または新規レコード)があった場合のみデータが同期されるため、過去のデータは常に同期されているわけではありません。更新をトリガーする変更がなければ、Salesforce inboxアプリに表示されるデータは古い可能性があります。Salesforceアプリ使用時に既存の過去データの一括更新はありません。

IntercomからSalesforceへデータが同期されるのはいつですか?

Intercomの以下のトリガーがSalesforceのデータ更新を引き起こします。これらのケースでの動作は、Intercomのperson(lead/user)とSalesforceのperson(lead/contact)間に既存の一致(“identity mapping”)があるかどうかで異なります。

トリガー

identity mappingが既に存在する場合

既存のidentity mappingが見つからない場合

Intercomでpersonが更新された場合

更新された属性をSalesforceに同期します。

  • 新しいidentity mappingを作成します。

  • 更新された属性をSalesforceに同期します。

Intercomでマッピングキーが更新されました。(例:Salesforceのレコードと一致させるためのメールアドレス)

  • identity mappingを削除します。

  • 新しいidentity mappingを作成します。

  • 更新された属性をSalesforceに同期します。

  • 新しいidentity mappingを作成します。

  • 更新された属性をSalesforceに同期します。

Intercomでpersonが作成された場合

該当なし。

  • 新しいidentity mappingを作成します。

  • マッピングされたすべての属性をSalesforceに同期します。

Intercomでpersonが削除された場合

identity mappingを削除します。

該当なし。

「マッピングされた属性」とは、設定でIntercomとSalesforce間の同期を設定した属性のことです。

SalesforceからIntercomへデータが同期されるのはいつですか?

Intercomは5分ごとにSalesforceの変更(新規または更新されたleads & contacts)を確認し、見つかるとIntercomの情報を更新します。

トリガー

identity mappingが既に存在する

新しいidentity mappingが作成された

Salesforceでpersonが更新された場合

マッピングされたすべての属性をIntercomに同期します。

  • 新しいidentity mappingを作成します。

  • マッピングされたすべての属性をIntercomに同期します。

Salesforceでマッピングキーが更新されました。(例:Intercomのレコードと一致させるためのメールアドレス)

  • identity mappingを削除します。

  • 新しいidentity mappingを作成します。

  • マッピングされたすべての属性をIntercomに同期します。

  • 新しいidentity mappingを作成します。

  • マッピングされたすべての属性をIntercomに同期します。

Salesforceでpersonが作成された場合

該当なし。

  • 新しいidentity mappingを作成します。

  • マッピングされたすべての属性をIntercomに同期します。

Salesforceでpersonが削除された場合

identity mappingを削除します。

該当なし。

Salesforceでリードが連絡先に適格化されました。

  • リードのIDマッピングを削除します。

  • 連絡先の新しいIDマッピングを作成します。

  • 連絡先のすべてのマッピングされた属性をIntercomに同期します。

  • リードのIDマッピングを削除します。

  • 連絡先の新しいIDマッピングを作成します。

  • すべてのマッピングされた属性をIntercomに同期します。

    連絡先のために。

この表の「Person」はSalesforceのリードまたは連絡先を指します。

SalesforceアプリはSalesforceが提供する標準の設定に依存しているため、統合のインストールや動作が期待通りに行かない場合があります。エラーが発生した場合は、このトラブルシューティングガイドが問題の特定と解決に役立ちます。

IntercomのLead/UserとCompanyの関係、およびSalesforceのLeads/ContactとAccountsの関係は同期しません。この関係はそれぞれのプラットフォームで別々に管理する必要があります。

IntercomのLeadがSalesforceで作成されるとどうなりますか?

次のアクションが発生します:

  • 新しいIDマッピングが作成されました。

  • Salesforceでリードを作成します。

  • 新しいIDマッピングを作成します。

  • すべてのマッピングされた属性をSalesforceに同期します。

  • すべてのマッピングされた属性をIntercomに同期します。

Intercomで連絡先を作成しても、自動的にSalesforceで作成されるわけではありません。

新しいIDマッピングはSalesforceの既存レコードに対してのみ作成されます。

Salesforceの新しいリードは、以下の方法でIntercomから作成されます:


よくある質問

IntercomはSalesforce App内の設定やマッピングされた属性の履歴データやログを保持していますか?

Salesforce App内で以前に設定された過去の設定やマッピングされた属性の履歴データやログは保持していません。

アプリをアンインストールして再インストールする必要がある場合は、アンインストール前に設定のスクリーンショットや記録を取ることを強くお勧めします。再インストール後に設定は保持または復元されません。

同期プロセスに問題があると思われる場合はどうすればよいですか?

Salesforceアプリ設定の「Sync Errors」タブには、IntercomとSalesforce間のデータ同期時に発生したエラーが表示されます。エラー発生時刻と原因が表示されます。行にカーソルを合わせ、「Details」ボタンをクリックして詳細を確認してください。

Sync ErrorsはIntercomからSalesforceへのデータ同期のエラーのみ表示します。

同期を再試行することもできます。Intercomが同期に成功すると、エラーはリストから削除されます。

このタブは、属性同期が正しく設定されていない可能性がある場合に通知します。このヘルプバナーはアカウント同期のみに関するものです。

ケースを作成できず、FIELD_FILTER_VALIDATION_EXCEPTIONエラーが表示されます。どうすればよいですか?

FIELD_FILTER_VALIDATION_EXCEPTION: このフィールドは値を含める必要があります」エラーは、Salesforceがケースに特定のフィールドを要求しているが、Intercomのケース作成サイドバーに表示されていない場合によく表示されます。

これを解決するには、以下の手順に従ってください:

1. Salesforceに入り、Casesの設定を確認します。ケースオブジェクトの必須フィールドはすべてIntercomのケース作成者に追加する必要があります。

2. 欠落しているフィールドを見つけたら、IntercomのApp Storeに移動します。

3. Intercom App Store > Salesforce > Settings > Set up Casesに進み、「Add Fields」ボタンをクリックします。

4. さまざまなフィールドを選択できるメニューが表示されます。

5. 必須フィールドをクリックしてサイドバーに追加し、必要なフィールドをすべて追加するまでこの手順を繰り返します。

注意: 「Add Fields」ボタンが表示されない場合は、Salesforceの権限に関係しています。その場合は、ITチームやSalesforceアカウントの管理者に相談してください。

Salesforceアプリの再接続が必要です。どうすればよいですか?

IntercomがSalesforceアカウントへの接続に失敗すると、アプリ設定にこのバナーが表示されます:

これはいくつかの理由で発生することがあります:

  • SalesforceがIntercomに接続していません - インストールプロセスを完了する前に終了した場合に発生します。

  • Salesforce内でOAuthトークンが手動で削除されました - IntercomのOAuthトークンがSalesforceから削除されると、統合は機能しなくなります。

  • SalesforceのOAuthトークンを4つすべて使用しました - Salesforceは1ユーザーがOAuthトークンで4つのアプリを接続することを許可しています。より多くのアプリを接続するには、別のSalesforceユーザーがアプリを接続する必要があります。詳細はこちらの記事

  • あなたのSalesforce APIアクセスは無効です - SalesforceをIntercomに接続するにはAPIアクセスが必要です。

これらの問題が発生しているか確認してください。解決すれば、アプリの再認証が正常に行えます。

注意: Salesforceアプリを再認証すると、データの同期が通常通り再開されます。データの再インポートは不要です。

Salesforceアプリをアンインストール/再インストールすると設定はどうなりますか?

Salesforceアプリをアンインストールするとマッピングがクリアされるため、アンインストール前にleadsとcontactsのマッピングのスクリーンショットを撮ることをお勧めします。

アプリをアンインストールしてもIntercom側やSalesforce側のデータには影響ありません。再インストール時に再同期がトリガーされます。

アプリ設定で問題がないか確認しましたか?

leadやtaskの作成に失敗した場合は、自分で問題を診断できます。アプリストアでSalesforceアプリをクリックすると、エラー一覧と原因が表示されます。

Salesforceの設定にIntercomが必要とするフィールドは含まれていますか?

この統合はIntercomからSalesforceの特定フィールドにデータを送信します。これらはSalesforceの標準フィールドですが、変更・非表示・削除されていると統合が機能しません。これらのフィールドが利用可能かSalesforce設定を編集してください。

必要なSalesforceフィールド:

Leadオブジェクト

  • Email

  • LastName

  • FirstName

  • Company

  • Phone

  • Status(別名 Lead Status)

  • LeadSource

  • OwnerId

Contactオブジェクト

  • Email

Accountオブジェクト

  • OwnerId

Taskオブジェクト

  • Description(別名 Comments)

  • CreatedById(別名 Created By)

  • ActivityDate(別名 Due Date)

  • Subject

  • Type

  • Status

  • Priority

  • OwnerId(別名 Assigned to)

Salesforce APIの制限に達しましたか?

Salesforceアカウントにはプランに応じたレート制限があります。Intercomはこの制限の一部を使用します。Salesforce APIの制限に達すると、Intercomを含むすべてのSalesforce統合が停止します。

IntercomでSalesforceのデータが一部欠けていますか?

IntercomのleadをSalesforceのleadに紐付けた後、Intercomのメールを別のSalesforce leadに合わせて更新すると、Salesforceデータを表示するカスタム属性の更新に最大10分かかることがあります。

Intercomリストのマッピング時にSalesforceのピックリストが見つかりません。

Intercom属性をSalesforceのフィールドとマッピングして、統合設定で同期を保てます。対応可能なフィールド(例:テキストはテキスト、整数は整数など)が表示されます。

リストの場合、各オプションをマッチさせます。SalesforceにあってIntercomにないオプションはリストに追加します。ただし、Salesforceのピックリストが制限付きでない場合のみ追加可能です。

注意: オプションが表示されない場合は、読み取り専用に設定されていないか確認してください。

なぜIntercomでSalesforceのタスクを作成できないのですか?

IntercomでSalesforceのタスクを作成しようとすると、エラー「IntercomはSalesforce Taskオブジェクトのこれらのフィールドを必要とします: Type」が表示されることがあります。

SalesforceでTypeフィールドは表示されていますか?

Taskオブジェクトの「Type」フィールドはほとんどのSalesforceユーザーにとって標準フィールドですが、Salesforce Professionalエディションの場合、デフォルトで「非表示」に設定されています

統合ではタスク作成にこのフィールドの表示が必要です。Salesforceのオブジェクトマネージャー > Task > Fields & Relationships > Type > フィールドレベルのセキュリティ設定で「表示」に変更してください。

「IntercomとのSalesforce統合に問題があります」というメールを受け取りました。なぜですか?

Salesforceアプリがインストールされているすべてのワークスペースに新しいSalesforceヘルスチェックを展開しました。このチェックは以下を確認します。

  1. アプリが正しくインストールされていること

  2. Salesforce APIで認証できること

  3. Salesforceは私たちが使いやすいように設定されています。

このヘルスチェックは毎時間実行しています。影響を受けたワークスペースは、このチェックを有効にしてから最初の24時間で徐々に新しい不健康な状態に移行します。

統合をインストールしたteammate、またはそのteammateがワークスペースのメンバーでなくなった場合は、最も長くワークスペースに所属している最初のアクティブな人間のteammateにメールを送信します。このチェックはUTCの午前7時に行われます。

Salesforceアプリ設定にアクセスすると、UIにいくつかのエラーが表示されます。

ここに表示される可能性のあるメッセージは次のとおりです:

  • IntercomはSalesforceに認証できません <error details>

  • IntercomはSalesforceの<object name>オブジェクトでこれらのフィールドをフィルタ可能にする必要があります:<list of fields>

  • IntercomはSalesforceの<object name>オブジェクトでこれらのフィールドを必要とします:<list of fields>

  • これらのフィールドはSalesforceの<object name>オブジェクトで必要ですが(Intercomでは使用されません):<list of fields>

設定タブに「インストールが完了していません..」という通知がありますが、統合は以前にインストールされて問題なく同期されていますか?

これは、Salesforce Appを最近インストールしたteammateがワークスペースから削除された場合に発生します。問題の証拠は、「Installed by ...」ボタンの横にteammate名がない場合に確認できます:

これが発生した場合は、Salesforceの完全な管理者権限を持つアカウントでログインしてSalesforceアプリをアンインストールし、再インストールする必要があります。Intercomはアプリをインストールする人のSalesforceアカウントを使ってSalesforceへの変更を同期するため、完全な管理者権限が必要です。

IntercomからSalesforceへ詳細なサブスクリプションデータを同期することは可能ですか?

現在、私たちのSalesforce AppはIntercomからSalesforceへの詳細なサブスクリプションデータの同期をサポートしていません。同期できるのはすべてのメールに適用される「メールの購読解除」属性のみで、特定のメールリストには対応していません。

ただし、回避策として、Subscription Webhook topicsとAPIリクエストを使用して、誰かがIntercomのメールリストの購読を解除したときにSalesforceを更新するカスタム統合を作成することができます。granular.unsubscribe webhookトピックは、誰かがIntercomのメッセージ購読タイプの購読を解除したときに通知するために使用できます。Webhookを受信した後、SalesforceにAPIリクエストを送信して該当する人物を更新できます。

データはどのくらいの頻度で同期されますか?

IntercomとSalesforce間でマッピングした属性は、どちらかのシステムで変更があったときに同期されます(詳細は上記のトリガー説明を参照)。Intercomで変更があった場合は即座にSalesforceへの同期がトリガーされ、Salesforceは5分間隔でチェックしてIntercomに同期する変更があるか確認します。

どのオブジェクトをIntercomに同期できますか?

現時点では、LeadsとContactsのSalesforceフィールドをIntercomのpeopleオブジェクトに同期できます(IntercomのLeadまたはUserオブジェクトかどうかを定義する必要はありません)。

どのIntercom属性でも同期できますか?

ほとんどの属性は同期可能です。例外は読み取り専用属性、非常に頻繁に変わるIntercomの属性(例:last_seen)、または数式フィールドです(次の質問を参照)。

Salesforceの数式フィールドは同期できますか?

数式フィールドは複雑で、同期の挙動はSalesforceの設定によって異なります。一般的に数式フィールドはマッピングしてIntercomに同期できますが、このフィールドは計算されるため、変更がトリガーを起動せず、他の何かが同期をトリガーしたときのみ同期されます。

まずsandboxアカウントでテストできますか?

もちろんです!Salesforceのsandboxアカウントを使ってテストワークスペースでこの新バージョンをテストできます。

Salesforceのメール通知の受信者メールを変更できますか?

Salesforceのメール通知の受信者メールを変更する唯一の方法は、表示したいメールアドレスの管理者がアプリをアンインストールして再インストールすることです。


Salesforceの設定でまだ問題がありますか?

Salesforce統合でまだ問題がある場合は、Messenger経由でサポートチームにお問い合わせください😄

こちらの回答で解決しましたか?