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, wie sie zusammenarbeiten, 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 Unterhaltungen 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 sich überschneidender user_ids kann schwerwiegende Probleme mit der Datenintegrität verursachen, wie z. B. Kontenübergreifende Anmeldungen und zusammengeführte Unterhaltungen zwischen verschiedenen Kunden.
Der Wert
-1ist 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 Unterhaltungen fälschlicherweise mit dem falschen Benutzerprofil verknüpft werden. Wenn Sie-1als 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
User_id-Werte, die an Intercom gesendet werden, müssen in Ihrem gesamten Workspace global eindeutig sein. In Multi-Tenant-Setups – bei denen mehrere Mieter oder Organisationen denselben Intercom-Workspace teilen – können user_ids, die nur innerhalb eines einzelnen Mieters eindeutig sind, zwischen Mietern kollidieren, was dazu führt, 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 Mieterkennzeichen. Zum Beispiel senden Sie statt "user_123" "tenant_abc:user_123".
Hinweis: Die Aktivierung der JWT-Authentifizierung ist ebenfalls erforderlich, um Kollisionen von Benutzerkonten 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 von Datensätzen, 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 mit einem CSV-Import oder unserer API aktualisieren.
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: Suchen Sie die Details eines Kunden mit seiner Intercom ID (id) oder Ihrer benutzerdefinierten user_id über den Retrieve a Contact endpoint.
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.
Sicherstellung der korrekten 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 Standardfeld Intercom user_id nicht automatisch mit diesen Daten aktualisiert. Eine manuelle Nachbefüllung ist erforderlich, um die Datensätze zu aktualisieren.
Umgang mit doppelten Datensätzen
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.