Verstehen und Verwalten von Benutzer-IDs

Um Ihre Kunden effektiv zu verwalten, verwendet Intercom zwei Arten von IDs: die Intercom ID und die user_id. Das Verständnis ihrer Zusammenarbeit ist entscheidend für die Datenintegrität und eine genaue Kundenidentifikation.

Die Intercom ID

Die Intercom ID ist ein Identifikator, der automatisch von unserem System für jeden Kunden-Datensatz generiert wird. Diese ID ist konstant und kann nicht geändert werden. In unserer API wird sie oft als contact_id bezeichnet.

Die benutzerdefinierte user_id (externe ID)

Die user_id ist ein anpassbarer Identifikator, den Sie so einstellen können, dass er dem Primärschlüssel oder der eindeutigen ID aus Ihrer eigenen Datenbank entspricht. Sie bietet eine flexible Möglichkeit, Intercom mit Ihren externen Systemen zu integrieren und kann über die API aktualisiert werden.

Bewährte Methoden für die Verwaltung von Benutzer-IDs

Die Befolgung dieser bewährten Methoden hilft Ihnen, häufige Datenprobleme wie doppelte Datensätze oder zusammengeführte Konversationen zu vermeiden.

Weisen Sie einen eindeutigen und konsistenten Identifikator zu

Sie sollten jedem Kunden immer eine eindeutige user_id zuweisen, typischerweise den Primärschlüssel aus Ihren eigenen Datenbankeinträgen. Es ist entscheidend, dieselbe user_id für alle zukünftigen Interaktionen und Profilaktualisierungen dieses Kunden zu verwenden.

Vermeiden Sie es, für dieselbe E-Mail-Adresse unterschiedliche user_ids zu übermitteln, da dies doppelte Kundendatensätze erzeugt.

Wichtig:

Die Verwendung inkonsistenter oder überlappender user_ids kann schwerwiegende Probleme mit der Datenintegrität verursachen, wie z. B. Kontenübergreifende Anmeldungen und zusammengeführte Konversationen zwischen verschiedenen Kunden.
Der Wert -1 ist vom Intercom-System für interne Zwecke reserviert und sollte nicht als user_id verwendet werden. Die Verwendung dieses Werts kann unerwartetes Verhalten verursachen, z. B. dass Konversationen fälschlicherweise mit dem falschen Benutzerprofil verknüpft werden. Wenn Sie -1 als user_id verwenden, wird dieser oft als Standard- oder Platzhalterwert genutzt. Das bedeutet, wenn ein Benutzer ihn hat, ist er nicht mehr eindeutig und kann Probleme verursachen.

Verwenden Sie global eindeutige Benutzer-IDs in Multi-Tenant-Setups

Die user_id-Werte, die an Intercom gesendet werden, müssen in Ihrem gesamten Workspace global eindeutig sein. In Multi-Tenant-Setups – bei denen mehrere Mandanten oder Organisationen denselben Intercom-Workspace teilen – können user_ids, die nur innerhalb eines einzelnen Mandanten eindeutig sind, zwischen Mandanten kollidieren und dazu führen, dass separate Kunden im selben Intercom-Kontaktdatensatz zusammengeführt werden.

Um dies zu verhindern, versehen Sie user_id-Werte vor dem Senden an Intercom mit einem Mandantenkennzeichen. Zum Beispiel senden Sie statt "user_123" "tenant_abc:user_123".

Hinweis: Die Aktivierung der JWT-Authentifizierung ist ebenfalls erforderlich, um Kollisionen von Benutzer-Datensätzen zu verhindern und eine sichere Identifikation zu gewährleisten. Ohne sie kann ein Angreifer einen anderen Benutzer durch Angabe seiner user_id imitieren, was zu unbefugtem Zugriff auf Gesprächsverläufe und Workspace-Daten führen kann. Global eindeutige user_id-Werte verhindern versehentliche Zusammenführungen, während die JWT-Authentifizierung absichtliche Imitationen verhindert.

Vermeiden Sie die Verwendung von Standard- oder Platzhalterwerten

Weisen Sie niemals Standardwerte wie "undefined" zu oder verwenden Sie dieselbe user_id für mehrere Kunden. Dies führt zu Datenfehlern und verhindert die korrekte Identifikation einzelner Kunden.

Nachträgliches Befüllen oder Aktualisieren von Benutzer-IDs

Wenn Sie einen Kundendatensatz aktualisieren müssen, der zuvor eine unbekannte user_id hatte, können Sie den korrekten Identifikator später hinzufügen.

Profi-Tipp: Sie können Ihre eigene Datenbank konsultieren, um die korrekte user_id zu finden, und dann den Kundendatensatz in Intercom per CSV-Import oder über unsere API aktualisieren.

Schritt-für-Schritt: Aktualisierung einer user_id über die Intercom ID

Verwenden Sie den Search for a Contact-Endpunkt, um den Kontakt per E-Mail oder einem anderen bekannten Attribut zu finden.
Notieren Sie das id-Feld in der Antwort – dies ist die permanente Intercom ID des Kontakts.
Suchen Sie die korrekte user_id in Ihrer eigenen Datenbank.
Rufen Sie den Update a Contact-Endpunkt auf und übergeben Sie die Intercom ID (id) sowie die korrekte user_id.

{
  "id": "contact_intercom_id",
  "user_id": "your_stable_database_id"
}

Wichtig: Verwenden Sie immer die Intercom ID (id) – nicht die E-Mail oder eine bestehende user_id – wenn Sie einen Kontakt aktualisieren. So stellen Sie sicher, dass Sie den richtigen Datensatz aktualisieren, auch wenn der Kontakt keine user_id hat oder eine falsche.

Verhindern, dass Integrationen falsche Benutzer-IDs setzen

Integrationen wie CRM-Synchronisationen, Analysetools und Datenpipelines können versehentlich falsche user_ids setzen. Häufige Ursachen sind:

Zuordnung einer Sitzungs-ID, eines Cookies oder eines temporären Tokens anstelle eines stabilen Primärschlüssels der Datenbank
Senden von null, undefined, 0 oder -1 als Platzhalterwerte, wenn ein Kunde nicht authentifiziert ist
Verwendung einer E-Mail-Adresse im user_id-Feld (E-Mails können sich ändern und unterbrechen die Kontaktkontinuität)
Verschiedene Integrationen senden unterschiedliche user_ids für denselben Kunden

Um dies zu verhindern:

Prüfen Sie Ihre Integrationszuordnungen – bestätigen Sie, welches Feld in Ihrem System der user_id in Intercom zugeordnet ist. Es sollte der Primärschlüssel Ihrer Datenbank für jeden Kunden sein.
Validieren Sie vor dem Senden – stellen Sie sicher, dass user_id nicht null, nicht leer und kein reservierter Wert (wie -1 oder undefined) ist, bevor sie an Intercom übergeben wird.
Verwenden Sie eine einzige Quelle der Wahrheit – wenn mehrere Integrationen Daten an Intercom senden, stellen Sie sicher, dass alle denselben stabilen Kundenidentifikator verwenden.
Testen Sie mit bekannten Datensätzen – verwenden Sie nach der Konfiguration einer Integration den Search for a Contact-Endpunkt, um zu überprüfen, ob die user_ids einiger Kunden mit Ihrer Datenbank übereinstimmen.

Verwaltung von Benutzer-IDs mit der API

Sie können die API von Intercom verwenden, um mehrere wichtige Aktionen zur Verwaltung Ihrer Kunden-IDs durchzuführen. Für vollständige Details siehe unser Developer Hub.

Abrufen, Aktualisieren oder Suchen eines Kontakts

Kontakt abrufen: Rufen Sie die Details eines Kunden mit seiner Intercom ID (id) oder Ihrer benutzerdefinierten user_id über den Retrieve a Contact-Endpunkt ab.
Kontakt aktualisieren: Setzen oder korrigieren Sie eine user_id mit dem Update a Contact-Endpunkt.
Kontakt suchen: Validieren Sie Identifikatoren wie user_id oder E-Mail mit dem Search for a Contact-Endpunkt.

Audit Ihrer Integrationen

Regelmäßige Audits helfen Ihnen, falsche user_ids zu erkennen, bevor sie Datenintegritätsprobleme verursachen. Befolgen Sie diese Schritte, um Ihre Integrationen zu prüfen und sicherzustellen, dass alle Kontakte die korrekte, stabile user_id haben.

Identifizieren Sie Kontakte mit fehlenden oder verdächtigen user_ids – verwenden Sie den Search for a Contact-Endpunkt, um Kontakte abzufragen, bei denen user_id leer ist oder einen bekannten Platzhalterwert (wie -1 oder undefined) enthält. Sie können auch Ihre Kontaktliste aus Intercom exportieren und nach Anomalien filtern.
Verfolgen Sie die Quelle jeder user_id – identifizieren Sie für jeden markierten Kontakt, welche Integration zuletzt die user_id gesetzt hat. Prüfen Sie Ihre Integrationsprotokolle oder Ereignishistorie, um die Herkunft des Werts zu bestätigen.
Korrigieren Sie die user_id mit der Intercom ID – suchen Sie die korrekte user_id in Ihrer eigenen Datenbank und verwenden Sie dann den Update a Contact-Endpunkt mit der Intercom ID des Kontakts, um den richtigen Wert zu setzen. Siehe Nachträgliches Befüllen oder Aktualisieren von Benutzer-IDs für den Schritt-für-Schritt-Prozess.
Beheben Sie die Integrationskonfiguration – aktualisieren Sie die Integration, um künftig den korrekten, stabilen Identifikator zuzuordnen. Prüfen Sie bei Drittanbieter-Tools die Feldzuordnungseinstellungen und passen Sie diese an, damit sie auf den Primärschlüssel Ihrer Datenbank zeigen.
Validieren Sie nach der Korrektur – suchen Sie die aktualisierten Kontakte erneut, um zu bestätigen, dass user_id jetzt den korrekten Wert widerspiegelt, und überwachen Sie neue Vorkommnisse in den folgenden Tagen.

Sicherstellung korrekter Identifikation mit JWT-Authentifizierung

Um eine robuste Authentifizierung für angemeldete Kunden zu gewährleisten, ist es bewährte Praxis, den Primärschlüssel Ihrer Datenbank als user_id im JSON Web Token (JWT)-Payload zu verwenden.

Wenn Sie nur eine E-Mail-Adresse zur Identifikation eines Kunden haben, sollten Sie sowohl die user_id als auch die E-Mail-Attribute im JWT-Payload mit der E-Mail-Adresse des Kunden befüllen.

Fehlerbehebung bei häufigen Benutzer-ID-Problemen

Archivierung einer benutzerdefinierten user_id

Wenn Sie ein benutzerdefiniertes user_id-Attribut archivieren, wird das Standard-Intercom-user_id-Feld nicht automatisch mit diesen Daten aktualisiert. Ein manuelles Nachtragen ist erforderlich, um die Datensätze zu aktualisieren.

Umgang mit doppelten Datensätzen

Inkonsistente user_id-Werte können auch dazu führen, dass die Aktivitäten eines einzelnen Besuchers – einschließlich Seitenaufrufen – auf mehrere Kontaktdatensätze verteilt werden. Diese Kontaktfragmentierung bedeutet, dass einige Seitenaufrufe nicht im erwarteten Kontakt erscheinen, z. B. in der App für kürzliche Seitenaufrufe.

Wenn Sie doppelte Datensätze finden, die durch nicht übereinstimmende user_id- und E-Mail-Zuordnungen verursacht werden, müssen Sie die Datensätze manuell bereinigen oder die API verwenden, um sie zusammenzuführen oder zu löschen.

Wechsel von einer benutzerdefinierten zur Standard-ID

Wenn Sie Ihr Benutzer-Datenbankfeld aktualisieren müssen, konsultieren Sie Ihren Entwickler, wie Sie die Intercom API verwenden oder den CSV-Import-Workflow nutzen können.