Wenn Sie ein aktueller Intercom-Kunde sind, können Sie Ihre users aus den folgenden Quellen importieren:

Hinweis:

Wenn Sie nur ein paar users gleichzeitig hinzufügen müssen, zum Beispiel Personen, die Sie auf einer Veranstaltung getroffen haben, können Sie diese direkt aus der Personenliste erstellen.
Es ist nicht möglich, Unternehmensattribute oder Unternehmensdaten über den CSV-Import in Intercom zu importieren.

Alle Methoden erlauben es Ihnen, Benutzername, E-Mail, userID und Anmeldedatum im Format TT/MM/JJJJ, ISO 8601 oder einen Unix-Zeitstempel zu importieren. Bitte beachten Sie, dass bei Verwendung von TT/MM/JJJJ keine Uhrzeit übermittelt werden kann.

CSV-Importe ermöglichen auch das Erstellen benutzerdefinierter Benutzerattribute (fügen Sie für jedes eine Spalte hinzu).
Mixpanel enthält last_seen.
MailChimp importiert die IP des users.

Loslegen

Melden Sie sich zuerst bei Ihrem Intercom-Konto an und klicken Sie in der Personenliste auf ‚Neue users oder leads‘.

Wählen Sie dann ‚Personen importieren‘:

Wählen Sie als Nächstes die Methode aus, mit der Sie users importieren möchten, und folgen Sie den Import-Schritten.

Sie können auch auf alle diese Optionen unter Einstellungen > Daten > Importe & Exporte zugreifen:

Wenn Sie users in Intercom importieren und diese sofort die Kriterien für eine aktive Nachricht erfüllen, erhalten sie diese Nachricht sofort.

So importieren Sie users aus einer CSV

Schritt-für-Schritt:

Wenn Sie die CSV-Importoption ausgewählt haben, führen Sie einfach die folgenden Schritte aus, um Ihre users zu importieren:

Führen Sie die oben unter ‚users jederzeit importieren‘ beschriebenen Schritte 1 und 2 aus. Stellen Sie sicher, dass Sie auf CSV-Import-Tool öffnen klicken.
Wählen Sie users importieren, um eine Liste angemeldeter users oder Kunden Ihres Produkts zu importieren. Oder wählen Sie ‚leads importieren‘, um eine Liste von leads in Ihren Intercom-Arbeitsbereich zu importieren.
Ziehen Sie Ihre CSV-Datei per Drag & Drop und klicken Sie auf Hochladen. Die maximale Dateigröße beträgt 20 MB. Sie sollten die Datei aufteilen, wenn sie größer ist.

Wichtige CSV-Format-Anforderungen:

Die Spalte für die Benutzer-ID muss als user_id formatiert sein (kleingeschrieben mit Unterstrich).
Sie können users entweder mit folgendem identifizieren:
- user_id (empfohlen)
- E-Mail-Spalte
Wenn beide vorhanden sind, hat user_id Vorrang.
user_id ist erforderlich, wenn keine E-Mail angegeben ist.
Inkonsistente Verwendung von Benutzer-ID und E-Mail als Identifikatoren kann zur Erstellung doppelter users führen. Für optimale Ergebnisse:
- Stellen Sie sicher, dass jeder Datensatz nach Möglichkeit sowohl eine Benutzer-ID als auch eine E-Mail enthält.
- Beachten Sie, dass die Benutzer-ID Vorrang hat, wenn beide angegeben sind, was hilft, doppelte Konten zu vermeiden.

Beste Praxis: Fügen Sie sowohl user_id als auch E-Mail-Spalten in Ihre CSV-Datei ein, um eine optimale Benutzerverwaltung zu gewährleisten.

4. Intercom fordert Sie nun auf, die relevanten Spalten auszuwählen, die die E-Mail-Adressen, IDs, vollständigen Namen und Anmeldedaten Ihrer users enthalten. Klicken Sie für jede Spalte auf ‚Diese Spalte auswählen‘ und dann auf ‚Bestätigen‘.

Alle users oder leads in Ihrer CSV müssen eine E-Mail-Adresse haben. Doppelte Einträge können auftreten, wenn leads und users mit derselben E-Mail als separate Entitäten behandelt werden. Um dies zu verhindern, stellen Sie sicher, dass die Synchronisierung von user- und lead-Daten während der Importe erfolgt.

Das Importieren einer CSV mit sowohl E-Mail als auch user_id kann Duplikate erzeugen, wenn das vorhandene Profil keine user_id hat.

Kontakte werden in folgender Reihenfolge identifiziert: Intercom ID → user_id → E-Mail. Wenn ein Benutzerprofil keine user_id hat und Ihre CSV sowohl eine E-Mail als auch eine user_id enthält, wird Intercom nicht anhand der E-Mail abgleichen, sondern die user_id als neuen Bezeichner behandeln und einen doppelten Kontakt erstellen. Um dies zu vermeiden, stellen Sie sicher, dass user_id-Werte konsistent sind und für alle users vor dem Import gesetzt werden. Verwenden Sie die API, um user_id für vorhandene users ohne diese vor Ihrem CSV-Import zu aktualisieren.

5. Wenn Sie zusätzliche Spalten hinzugefügt haben, fordert Intercom Sie auf, Ihren benutzerdefinierten Attributen einen spezifischen Namen zu geben. Klicken Sie auf ‚Bestätigen‘, sobald Sie Ihr benutzerdefiniertes Attribut benannt haben.

6. Markieren Sie Ihre CSV-Liste mit einem einprägsamen Begriff wie ‚Neue Anmeldungen 2015‘.

7. Nach dem Import können Sie in Ihrer Intercom-User-Liste nach ‚tag: Neue Anmeldungen 2015‘ suchen. Nun können Sie Dinge tun wie eine einmalige Nachricht senden an alle in der Liste oder ein Segment erstellen für diese Gruppe und eine gezielte Proaktive Support-Nachricht senden.

Sie müssen die Ländervorwahl zu Beginn Ihrer Telefonnummern hinzufügen. Zum Beispiel würden Sie für US-Nummern ‚+1‘ oder ‚001‘ hinzufügen.

Hinweis: Wenn Sie Kontakte für WhatsApp-Nachrichten importieren, reicht eine Telefonnummer allein nicht aus. Jede Zeile in Ihrer CSV muss auch einen Kontaktbezeichner enthalten – entweder eine E-Mail-Adresse oder eine user_id. Das Importieren einer CSV mit nur Telefonnummern funktioniert für WhatsApp-Ausgangsnachrichten nicht.

Hinweis: Tags können einige Minuten benötigen, um nach Abschluss Ihres Imports vollständig angewendet zu werden. Bitte erlauben Sie etwas Zeit, bis alle Tags auf die importierten users angewendet sind.

Kann ich Benutzerdaten mit einem CSV-Import aktualisieren?

Ja. Sie können Werte aktualisieren und neue Attribute für vorhandene users hinzufügen. Alle CSV-Importe erfordern eine Spalte mit Benutzer-E-Mail-Adressen. Einige Dinge sind zu beachten:

Sie können die E-Mail eines users aktualisieren, indem Sie dieselbe user_id und eine andere E-Mail-Adresse senden. Wir aktualisieren den user mit dieser user_id in Intercom, um die neue E-Mail-Adresse widerzuspiegeln.
Sie können die user_id nicht aktualisieren, indem Sie einen neuen Wert dafür festlegen und die vorhandene E-Mail-Adresse verwenden – das würde einen neuen Datensatz erstellen.
Wenn Sie sowohl user_id als auch E-Mail in Intercom verwenden, reicht das Senden der E-Mail in einem CSV-Import aus, um den Benutzer-Datensatz in Intercom abzugleichen.

Users über Rest API importieren

Es ist möglich, users zusammen mit benutzerdefinierten Benutzerattributen über die REST API zu importieren. Sobald Sie users importiert haben, können Sie auch historische Ereignisdaten für Ihre users über die Events API hinzufügen.

Sehen Sie sich dieses Tutorial an, das erklärt, wie Sie Kontakt-, user- und lead-Daten aus einer JSON-Datei mit den Intercom APIs importieren.

Sehen Sie Ihre Datenimport-Historie ein

Sie können Ihre Datenimport-Historie im Einstellungsbereich in Intercom sehen.

Was bedeutet der Fehler „Mehrere Datensätze stimmen überein“?

Der Fehler „Mehrere Datensätze stimmen überein“ tritt typischerweise auf, wenn mehrere users in Ihrem System dieselbe E-Mail-Adresse haben. Dies führt zu einem Konflikt, da das System nicht bestimmen kann, welchen user es aktualisieren soll. Um dies zu beheben, müssen Sie sicherstellen, dass jeder user eine eindeutige E-Mail-Adresse oder Benutzer-ID hat.

Sie können korrekte Bezeichner mit der Intercom API nachtragen, indem Sie external_id-Felder systematisch aktualisieren, um Duplikate zusammenzuführen und Übereinstimmungen zu klären.

Ursachen für doppelte users verstehen

Doppelte Benutzerprofile in Intercom können aus verschiedenen Gründen entstehen. Die Bezeichner-Hierarchie in Intercom (Intercom ID > Benutzer-ID > E-Mail) spielt eine wichtige Rolle. Wenn keine eindeutige und stabile user_id angegeben wird, können Duplikate entstehen. Zum Beispiel führt das Senden unterschiedlicher user_id-Werte für dieselbe E-Mail oder das Initialisieren von users ohne user_id zu Duplikaten. Übergänge von anonymen zu angemeldeten Sitzungen, sich überschneidende E-Mail-Adressen und Änderungen der Benutzerbezeichner verschärfen die Situation. Plattform-spezifische Probleme, wie WhatsApp-Integrationen, bei denen Profile nur mit Telefonnummern erstellt werden, tragen ebenfalls zum Problem bei.

Inkonsistente Benutzerbezeichner:
- Wenn E-Mail und Benutzer-ID inkonsistent verwendet werden, können Duplikate entstehen. E-Mail dient nur als eindeutiger Bezeichner, wenn keine Benutzer-ID angegeben ist. Daher können zwei users dieselbe E-Mail teilen, wenn sie unterschiedliche Benutzer-IDs haben. Dies kann nach Backend-Updates oder Änderungen bei der Benutzer-ID-Generierung passieren.
Integrationsverhalten:
- App-Integrationen wie Shopify können users erstellen, bei denen keine exakte Übereinstimmung besteht, indem die E-Mail-ID als eindeutiger Bezeichner verwendet wird, anstatt Benutzer-IDs abzugleichen.
Abgleichslogik während des Uploads:
- Wenn nur eine Benutzer-ID oder E-Mail-Adresse während des Imports angegeben wird, versucht Intercom, anhand des angegebenen Feldes abzugleichen. Es können jedoch Diskrepanzen auftreten, wenn beide Felder nicht übereinstimmen oder inkonsistent zugewiesen sind.
Überlappung von Users und Leads:
- Leads und users werden als unterschiedliche Objekte behandelt, selbst wenn sie dieselbe E-Mail-Adresse teilen, was potenziell zu Duplikaten führt.

Eine fehlerhafte SDK-Initialisierung oder der Übergang von einem anonymen zu einem angemeldeten Zustand ohne ordnungsgemäße Aktualisierungen führt oft zu Duplikaten. Zum Beispiel kann die Zuweisung einer zufälligen user_id für anonymes Browsen neue Profile erstellen, wenn die Sitzung wechselt.

Vermeidung doppelter users

Standardisieren Sie Benutzerbezeichner:
- Stellen Sie sicher, dass Ihre Einrichtung konsequent sowohl Benutzer-ID als auch E-Mail-Werte zuweist. Zum Beispiel:
  - Wenn nur eine E-Mail angegeben ist, erfolgt der Abgleich anhand der E-Mail.
  - Wenn nur eine Benutzer-ID angegeben ist, erfolgt der Abgleich anhand der Benutzer-ID.
  - Wenn beide angegeben sind, hat die Benutzer-ID Vorrang; wenn kein Abgleich über die Benutzer-ID erfolgt, wird anhand der E-Mail abgeglichen.
Ordnungsgemäße SDK-Initialisierung:
- Für anonyme users initialisieren Sie das SDK nur mit der app_id.
- Nach der Anmeldung aktualisieren Sie Profile mit korrekten user_id- und E-Mail-Bezeichnern.
- Fahren Sie das SDK herunter (Intercom('shutdown')), bevor sich users abmelden, um Duplikate zu vermeiden.
Überprüfen Sie die Einstellungen zur Lead-Konvertierung:
- Verwenden Sie während der Anmeldungen konsistente Benutzer-IDs, um aktive leads ohne Duplikate in users umzuwandeln. Weitere Schritte finden Sie in unserem Benutzerauthentifizierungsleitfaden.
Passen Sie sich plattformspezifischen Anforderungen an:
- Beispiel: Für WhatsApp stellen Sie sicher, dass Einstellungen wie „Bestehende users identifizieren“ aktiviert sind, und versuchen Sie, E-Mail-Bezeichner frühzeitig zu erfassen, um Konsistenz zu gewährleisten.
Migrationsvorkehrungen:
- Beim Übergang zu neuen ID-Systemen (z. B. UUIDs) nutzen Sie die Intercom API, um external_id-Felder effektiv zu aktualisieren und zu verwalten, ohne Duplikate zu verursachen.