Die Attribute, die Sie zwischen Intercom und Salesforce zuordnen, werden synchronisiert, wenn sie sich in einem der Systeme ändern. Wenn die Änderung in Intercom erfolgt, wird die Synchronisation zu Salesforce sofort ausgelöst, während Salesforce alle 5 Minuten überprüft wird, um festzustellen, ob Änderungen zur Synchronisation mit Intercom vorliegen. Details zur Datenaktualisierung in verschiedenen Situationen finden Sie in den untenstehenden Tabellen.

Die folgenden Auslöser in Intercom führen dazu, dass Daten in Salesforce aktualisiert werden. Das Verhalten in jedem dieser Fälle ist unterschiedlich, je nachdem, ob eine bestehende Übereinstimmung zwischen einer Person (lead/user) in Intercom und einer Person (lead/contact) in Salesforce vorliegt. Diese Übereinstimmung wird als „identity mapping“ bezeichnet.

Intercom überprüft alle 5 Minuten Salesforce auf Änderungen (neue oder aktualisierte leads & contacts) und aktualisiert bei Fund die Informationen in Intercom.

Da die Salesforce-App auf der standardmäßigen Out-of-the-Box-Konfiguration von Salesforce basiert, kann es vorkommen, dass die Integration nicht installiert wird oder nicht wie erwartet funktioniert. Wenn ein Fehler auftritt, hilft Ihnen diese Fehlerbehebung, das Problem zu identifizieren und zu beheben.

Folgende Aktionen werden ausgeführt:

Wir speichern keine historischen Daten oder Protokolle zu früheren Einstellungen oder zugeordneten Attributen, die zuvor in der Salesforce-App eingerichtet wurden.

Wenn es notwendig ist, die App zu deinstallieren und neu zu installieren, empfehlen wir dringend, vor dem Deinstallationsprozess Screenshots oder eine klare Aufzeichnung Ihrer Einstellungen zu machen, damit diese nach der Neuinstallation leicht reproduziert werden können. Einstellungen werden nach der Neuinstallation der App nicht gespeichert oder wiederhergestellt.

Der Tab „Sync Errors“ in den Einstellungen der Salesforce-App zeigt alle Fehler an, die beim Synchronisieren von Daten zwischen Intercom und Salesforce auftreten. Wir zeigen an, wann der Fehler aufgetreten ist und was ihn verursacht hat. Fahren Sie mit der Maus über eine Zeile und klicken Sie auf die Schaltfläche „Details“, um mehr über diese Probleme zu erfahren.

Sync Errors zeigen nur Fehler bei der Daten-Synchronisation von Intercom zu Salesforce an.

Sie können die Synchronisierung auch erneut versuchen. Wenn Intercom die Synchronisierung erfolgreich durchführt, wird der Fehler aus der Liste entfernt:

Um mehr darüber zu erfahren, wann Attribute synchronisiert werden, lesen Sie diesen Artikel.

Der Fehler „FIELD_FILTER_VALIDATION_EXCEPTION: dieses Feld muss einen Wert enthalten“ wird häufig angezeigt, wenn Salesforce für Fälle ein bestimmtes Feld verlangt, das in der Seitenleiste des Fall-Erstellers in Intercom nicht angezeigt wird.

Um dies zu beheben, befolgen Sie bitte die unten aufgeführten Schritte:

1. Gehen Sie in Salesforce und überprüfen Sie Ihre Einstellungen für Fälle. Alle erforderlichen Felder im Fallobjekt müssen im Fall-Ersteller in Intercom hinzugefügt werden.

2. Sobald Sie fehlende Felder gefunden haben, gehen Sie zum App Store von Intercom.

3. Navigieren Sie vollständig zu den Fall-Einstellungen, indem Sie Intercom App Store > Salesforce > Einstellungen > Fälle einrichten aufrufen, und klicken Sie dann auf die Schaltfläche „Felder hinzufügen“.

4. Sie erhalten ein Menü mit verschiedenen Feldern zur Auswahl.

5. Klicken Sie auf das erforderliche Feld, um es der Seitenleiste hinzuzufügen, und wiederholen Sie diesen Vorgang, bis Sie alle benötigten Felder hinzugefügt haben.

Wenn Intercom keine Verbindung zu Ihrem Salesforce-Konto herstellen kann, sehen Sie dieses Banner in Ihren App-Einstellungen:

Dies kann aus mehreren Gründen passieren:

Sie sollten prüfen, ob Sie diese Probleme haben. Sobald sie behoben sind, sollten Sie die App erfolgreich erneut authentifizieren können.

Wenn Sie die Salesforce-App deinstallieren, werden Ihre Zuordnungen gelöscht. Es ist daher ratsam, vor der Deinstallation einen Screenshot der Zuordnungen für Ihre leads und Kontakte zu machen.

Beim Deinstallieren der App werden keine Daten auf der Intercom- oder Salesforce-Seite beeinträchtigt. Nach der Neuinstallation wird eine weitere Synchronisierung ausgelöst.

Wenn bei der Erstellung eines leads oder einer Aufgabe etwas fehlschlägt, können Sie das Problem selbst diagnostizieren. Besuchen Sie einfach den App Store und klicken Sie auf die Salesforce-App. Dort sehen Sie eine Liste von Fehlern sowie die Ursachen dafür.

Die Integration sendet Daten von Intercom an bestimmte Felder in Salesforce. Dies sind Standardfelder in Salesforce, aber wenn sie geändert, ausgeblendet oder entfernt wurden, funktioniert die Integration möglicherweise nicht. Sie müssen Ihre Salesforce-Einstellungen bearbeiten, um sicherzustellen, dass diese Felder verfügbar sind.

Erforderliche Salesforce-Felder:

Lead-Objekt

Kontakt-Objekt

Account-Objekt

Aufgaben-Objekt

Jedes Salesforce-Konto hat ein festgelegtes Limit, das vom gewählten Plan abhängt. Intercom verbraucht einen Teil dieses Limits. Wenn Sie Ihr Salesforce API-Limit erreicht haben, funktionieren alle Ihre Salesforce-Integrationen nicht mehr, einschließlich Intercom.

Wenn Sie einen Intercom lead mit einem in Salesforce abgeglichen haben - aber dann die E-Mail in Intercom so ändern, dass sie zu einem anderen Salesforce lead passt - kann es bis zu 10 Minuten dauern, bis benutzerdefinierte Attribute mit Salesforce-Daten aktualisiert werden.

Sie können Intercom-Attribute mit Feldern in Salesforce so zuordnen, dass sie in Ihren Integrations-Einstellungen synchron bleiben. Sie sehen die kompatiblen Felder (z. B. Text kann mit Text, Ganzzahlen mit Ganzzahlen übereinstimmen usw.).

Für Listen ordnen wir jede Option zu. Wenn es eine Option in Salesforce gibt, die in Intercom nicht zugeordnet ist, fügen wir sie für Sie in der Optionsliste hinzu. Wir können Optionen jedoch nur hinzufügen, wenn die Salesforce-Auswahlliste NICHT auf eingeschränkt gesetzt ist.

Wenn Sie versuchen, eine Salesforce-Aufgabe in Intercom zu erstellen, erhalten Sie möglicherweise die Fehlermeldung: ‚Intercom benötigt diese Felder im Salesforce-Aufgabenobjekt: Type‘:
​

Das ‚Type‘-Feld für das Aufgabenobjekt ist für die meisten Benutzer ein Standardfeld in Salesforce, aber wenn Sie die Salesforce Professional Edition haben, ist es standardmäßig auf ‚versteckt‘ gesetzt.

Unsere Integration benötigt es, um Aufgaben zu erstellen. Sie können dies in Salesforce ändern, indem Sie zu Objekt-Manager > Aufgabe > Felder & Beziehungen > Type > Feldsicherheitseinstellungen gehen und es auf ‚sichtbar‘ setzen.

Wir haben einen neuen Salesforce-Gesundheitscheck für alle Arbeitsbereiche eingeführt, die die Salesforce-App installiert haben. Diese Prüfung stellt sicher, dass:

Wir führen diese Gesundheitsprüfung jede Stunde durch. Betroffene Arbeitsbereiche wechseln innerhalb der ersten 24 Stunden nach Aktivierung dieser Prüfung allmählich in den neuen fehlerhaften Zustand.

Wir senden eine E-Mail entweder an den Teamkollegen, der die Integration installiert hat, oder, falls dieser Teamkollege nicht mehr Mitglied des Arbeitsbereichs ist, an den ersten aktiven menschlichen Teamkollegen, der am längsten Teil des Arbeitsbereichs ist. Diese Prüfung findet um 7 Uhr UTC statt.

Gehen Sie zu Ihren Salesforce App-Einstellungen und Sie werden einige Fehler in der Benutzeroberfläche angezeigt bekommen.

Die hier angezeigten möglichen Nachrichten sind:

Dies passiert, wenn der Teamkollege, der die Salesforce App zuletzt installiert hat, als Teamkollege aus Ihrem Arbeitsbereich entfernt wurde. Ein Hinweis darauf ist, wenn neben dem "Installiert von ..."-Button kein Teamkollegenname angezeigt wird:

Wenn dies der Fall ist, müssen Sie die Salesforce App deinstallieren und neu installieren, während Sie mit einem Salesforce-Konto mit vollständigen Administratorrechten angemeldet sind. Intercom kann Änderungen an Salesforce mit dem Salesforce-Konto der Person synchronisieren, die die App installiert, weshalb volle Administratorrechte erforderlich sind.

Derzeit unterstützt unsere Salesforce App nicht das Synchronisieren von granular subscription data von Intercom zu Salesforce. Sie können nur das Attribut "Vom Empfang von E-Mails abgemeldet" synchronisieren, das für alle E-Mails gilt, aber nicht für spezifische E-Mail-Listen.

Als Workaround könnten Sie jedoch eine benutzerdefinierte Integration erstellen, die unsere Subscription Webhook topics und eine API-Anfrage verwendet, um Salesforce zu aktualisieren, wann immer sich jemand von einer E-Mail-Liste in Intercom abmeldet. Das granular.unsubscribe Webhook-Thema könnte verwendet werden, um Sie zu benachrichtigen, wenn sich jemand von einem Nachrichten-Abonnementtyp in Intercom abgemeldet hat. Nach Erhalt des Webhooks könnten Sie dann eine API-Anfrage an Salesforce stellen, um die betreffende Person zu aktualisieren.

Die Attribute, die Sie zwischen Intercom und Salesforce zuordnen, werden synchronisiert, wenn sie sich in einem der Systeme ändern (siehe detaillierte Erklärung des Triggers in den obigen Abschnitten). Wenn die Änderung in Intercom erfolgt, wird die Synchronisierung zu Salesforce sofort ausgelöst, während Salesforce alle 5 Minuten überprüft wird, um festzustellen, ob Änderungen zurück zu Intercom synchronisiert werden müssen.

Derzeit können Sie Salesforce-Felder von Leads und Kontakten zu Intercoms Personenobjekten synchronisieren (Sie müssen nicht definieren, ob es sich um ein Intercom Lead- oder User-Objekt handelt).

Sie können die meisten Attribute synchronisieren. Einige Ausnahmen sind schreibgeschützte Attribute, Attribute in Intercom, die sich sehr häufig ändern (z. B. last_seen) oder Formel-Felder (siehe nächste Frage).

Formel-Felder sind komplexer und das Synchronisationsverhalten kann von der Salesforce-Konfiguration abhängen. Im Allgemeinen können Formel-Felder zugeordnet und mit Intercom synchronisiert werden. Da dieses Feld jedoch berechnet wird, löst eine Änderung dieses Feldes keinen Trigger aus, was bedeutet, dass dieses Feld nur synchronisiert wird, wenn etwas anderes die Synchronisierung auslöst.

Natürlich! Sie können diese neue Version mit einem Test-Arbeitsbereich mit einem Salesforce-Sandbox-Konto testen.

Die einzige Möglichkeit, die Empfänger-E-Mails der Salesforce-E-Mail-Benachrichtigung zu ändern, besteht darin, die App vom Administrator, dessen E-Mail-Adresse angezeigt werden soll, zu deinstallieren und neu zu installieren.

Wenn Sie weiterhin Probleme mit Ihrer Salesforce-Integration haben, wenden Sie sich bitte an unser Support-Team über den Messenger 😄