Manchmal hat dieselbe Person in Intercom zwei user-Profile. Zum Beispiel, wenn sie sich zweimal mit unterschiedlichen Benutzer-IDs angemeldet hat oder eine Integration ein zweites Profil erstellt hat. Ihre Gespräche, tickets und Notizen sind dann auf beide Profile verteilt.

Sie können jetzt einen user in einen anderen zusammenführen, sodass alle Informationen zu dieser Person in einem einzigen Profil gespeichert sind. Dies können Sie im Inbox oder über die REST API (Intercoms API zum Lesen und Schreiben von Daten über HTTP) tun.

Wer das betrifft: Teammitglieder mit der Berechtigung Can merge a user into another user (Inbox) und Entwickler, die eine OAuth-App (eine App, die mit einem OAuth-Zugriffstoken authentifiziert ist, statt mit einem statischen API-Schlüssel) mit dem Merge users-Bereich (API) verwenden.

Möchten Sie stattdessen einen Lead in einen user zusammenführen? Siehe Lead- und Benutzerprofile zusammenführen

Was passiert, wenn Sie zwei users zusammenführen

Eine Zusammenführung hat immer zwei Seiten:

Der Duplikat (Quelle): das Profil, das zusammengeführt und gelöscht wird. Es wird dauerhaft gelöscht.
Der überlebende user (Ziel): das Profil, das behalten wird.

Was zum überlebenden user übertragen wird

Gespräche und tickets, einschließlich deren Antworten, Notizen, Anhänge und Bewertungen
Notizen im Profil
Tags
Unternehmen
Telefonate
An den user gesendete Nachrichten sowie deren Öffnungen, Klicks und Antworten
Fortschritt bei Umfragen und Zielen
Registrierungen von mobilen Push-Geräten
Links zu verbundenen Helpdesks und Integrationen

Was nicht übertragen wird

Attribute. Der überlebende user behält seine eigenen Standard- und benutzerdefinierten Attributwerte, die Werte des Duplikats werden verworfen. Vor der Bestätigung zeigt die Zusammenführungsvorschau alle Werte, die gelöscht werden. Wenn Sie einen Wert behalten möchten, kopieren Sie ihn vor oder nach der Zusammenführung auf den überlebenden user.
WhatsApp-Konversationsdaten. Die Zusammenführung wird trotzdem durchgeführt, aber die WhatsApp-Daten des Duplikats werden dabei gelöscht.
SMS-Konversationsverläufe

Wichtig: Das Zusammenführen ist dauerhaft. Es kann nicht rückgängig gemacht werden.

Bevor Sie beginnen: Wer users zusammenführen kann

Im Inbox

Das Zusammenführen von users erfordert eine neue Teammitglied-Berechtigung, Can merge a user into another user.

Sie ist standardmäßig deaktiviert und wird beim Start nicht automatisch vergeben. Teammitglieder mit vollem Zugriff haben sie bereits.
Ein Administrator kann sie für ein Teammitglied aktivieren, indem er dessen Berechtigungen unter Einstellungen > Arbeitsbereich > Teammitglieder bearbeitet.
Sie ist für Full-, Support-, Engage-, Convert- und Lite-Plätze verfügbar.

Das Zusammenführen eines Leads in einen user benötigt diese Berechtigung nicht und funktioniert wie bisher.

Über die API

API-Anfragen zum Zusammenführen von zwei users benötigen beides:

Ein OAuth-Zugriffstoken. Legacy-API-Schlüssel werden für user-Zusammenführungen nicht unterstützt.
Den Merge users-Bereich zusätzlich zu dem Bereich, den Ihre App bereits zum Schreiben von Kontakten verwendet (z. B. Read and write users).

Hinweis: Das Zusammenführen von users über die API befindet sich derzeit in der Vorschau. Es ist nicht automatisch für jeden Arbeitsbereich verfügbar. Kontaktieren Sie uns, um Zugang zu beantragen. Der Merge users-Bereich erscheint im Developer Hub erst, wenn der Zugang für Ihren Arbeitsbereich freigeschaltet wurde.

So führen Sie zwei users im Inbox zusammen

Öffnen Sie ein Gespräch mit dem user, den Sie behalten möchten.
Suchen Sie in der Seitenleiste der Gesprächsdetails nach Duplikat-user-Daten. Dort werden alle Profile aufgelistet, die Intercom als Duplikate dieses users erkannt hat.
Klicken Sie neben dem Duplikat-user auf Merge User Into User.
Überprüfen Sie die Vorschau. Sie zeigt, wie viele Gespräche, tickets, Notizen, Tags und Telefonate übertragen werden und welche Attributwerte des Duplikats verworfen werden. Es ändert sich nichts, bis Sie bestätigen.
Klicken Sie auf Zusammenführen.

5. Klicken Sie auf Merge. Das Duplikatprofil wird sofort gelöscht, seine Gespräche, tickets und Notizen erscheinen nun im Profil des überlebenden users, und Sie kehren zum ursprünglichen Gespräch zurück.

Seitenleiste der Gesprächsdetails mit einer Benutzerprofilkarte, die den Namen, das Unternehmen, den Typ und die E-Mail-Adresse des users zeigt, der als erkanntes Duplikat markiert ist, sowie eine Schaltfläche Merge User Into User.

Vorschau-Dialog zum Zusammenführen von user in user mit einer Bestätigungsnachricht, dass das Duplikatprofil dauerhaft gelöscht und in den überlebenden user zusammengeführt wird, sowie einer Tabelle, die die Werte von Duplikat, user und user nach der Zusammenführung für Felder wie Name, E-Mail, Telefon, Sitzungsanzahl, Gespräche und Notizen vergleicht.

Was sollte ich vor dem Zusammenführen noch wissen?

Das Profil, das Sie sehen, wenn Sie auf Merge User Into User klicken, ist immer das, das überlebt. Um stattdessen das andere Profil zu behalten, öffnen Sie ein Gespräch, das zu diesem Profil gehört, und führen Sie die Zusammenführung von dort aus durch.
Es werden nur erkannte Duplikate aufgelistet. Zwei users gelten als Duplikate, wenn sie dieselbe E-Mail-Adresse oder Telefonnummer teilen.
Wenn Sie nicht die Berechtigung haben, ist die Schaltfläche deaktiviert und zeigt „Sie haben derzeit keine Berechtigung, user-Zusammenführungen durchzuführen.“ Bitten Sie einen Administrator, diese zu erteilen.

So führen Sie zwei users mit der API zusammen

User-Zusammenführungen verwenden den bestehenden Merge a contact-Endpunkt, der mit dem Preview-API-Versionsheader aufgerufen wird (Intercoms Veröffentlichungsstufe für frühzeitige API-Änderungen) – diese Preview-API-Version ist getrennt von der oben beschriebenen Zusammenführungsvorschau. Siehe die Entwicklerdokumentation.

Vorschau der Zusammenführung zuerst (empfohlen)

POST /contacts/merge/preview zeigt, was eine Zusammenführung bewirken würde, ohne etwas zu ändern:

curl https://api.intercom.io/contacts/merge/preview \
  -X POST \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Intercom-Version: Preview" \
  -H "Content-Type: application/json" \
  -d '{ "from": "<duplicate_contact_id>", "into": "<surviving_contact_id>" }'

Die Antwort sagt Ihnen, ob die Zusammenführung erlaubt ist („allowed“) und wenn nicht, warum („reasons“). Sie enthält auch eine „summary“ der Datensätze, die verschoben werden, und der Attributwerte, die verworfen werden.

Zusammenführen

POST /contacts/merge führt die Zusammenführung durch:

curl https://api.intercom.io/contacts/merge \
  -X POST \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Intercom-Version: Preview" \
  -H "Content-Type: application/json" \
  -d '{ "from": "<duplicate_contact_id>", "into": "<surviving_contact_id>" }'

„from“ ist der Duplikat-user, der gelöscht wird.

„into“ ist der user, den Sie behalten möchten.

Eine erfolgreiche Zusammenführung gibt den überlebenden Kontakt zurück, einschließlich seiner ID und der zusammengeführten Daten (Gespräche, tickets, Notizen, Tags), die jetzt damit verknüpft sind. Zum Beispiel: { "type": "contact", "id": "", "email": "...", ... }

Was sind die Einschränkungen beim Zusammenführen von users?

Zusammenführungen sind dauerhaft. Es gibt keine Möglichkeit, sie rückgängig zu machen.
Attribute werden nicht kombiniert. Die Attributwerte des überlebenden users werden behalten, die des Duplikats verworfen.
Einige Kontakte können nicht zusammengeführt werden: users, die Sie über Facebook kontaktiert haben, users mit Telegram-Gesprächen (als Duplikat) und Mailinglisten-Kontakte.
WhatsApp- und SMS-Konversationsdaten des Duplikats werden nicht übertragen.
Im Inbox müssen users dieselbe E-Mail-Adresse oder Telefonnummer teilen. Um users zusammenzuführen, die das nicht tun, verwenden Sie die API mit skip_duplicate_validation.
Die API befindet sich in der Vorschau, daher können sich das Anfrage- und Antwortformat ändern, bevor sie eine nummerierte API-Version erreicht.

Verwandte Artikel