Si un utilisateur existant vous contacte anonymement via Messenger, par exemple en mode navigation privée, un nouveau profil de lead sera créé pour lui dans Intercom. Cela signifie que vous aurez à la fois un profil de lead et un profil d'utilisateur pour la même personne.
Dans Intercom, un lead est un contact non identifié qui a interagi via Messenger mais n'a pas été authentifié. Un user est un contact identifié et connecté.
Utilisez cet article pour fusionner manuellement un lead dans un user depuis l'Inbox, configurer la fusion automatique ou déclencher une fusion via le REST API. Il explique aussi comment résoudre les cas où une fusion ne se produit pas comme prévu.
Lorsque cela se produit, vous pouvez fusionner le profil de lead avec le profil d'user, afin que toutes leurs informations soient suivies et stockées en un seul endroit.
Comment les profils de lead et d'user peuvent être fusionnés
Un lead peut être fusionné dans le compte d'un user existant soit manuellement, automatiquement ou via le REST API. Fusionner un lead dans un user signifie que toutes les informations associées au lead seront transférées vers le profil de l'user.
Des profils en double peuvent aussi apparaître dans plusieurs scénarios courants : suppression des cookies, identifiants utilisateur incohérents, ou communication par email uniquement sans identifiants liés. Un autre scénario est lorsqu'une personne est identifiée avec un user_id différent, créant un nouveau profil même si l'email correspond.
Il existe certains types de profils que vous pouvez (et ne pouvez pas) fusionner :
Un lead peut être fusionné dans un profil d'user.
2 leads ne peuvent pas être fusionnés.
2 users ne peuvent pas être fusionnés.
Un profil d'user ne peut pas être fusionné dans un profil de lead.
Note : Comme 2 users ne peuvent pas être fusionnés, si vous devez consolider l'historique des conversations d'un user à un autre, vous devrez utiliser la solution API décrite ci-dessous.
Comment migrer des conversations entre users via l'API
Note : Cette solution nécessite un accès développeur au REST API d'Intercom.
Puisque la fusion de deux profils d'user n'est pas prise en charge, les développeurs peuvent utiliser l'API Conversations pour migrer manuellement l'historique des conversations d'un user à un autre. Les étapes sont :
Récupérez toutes les conversations de l'user source en utilisant le List conversations API — cela nécessite uniquement l'ID de contact Intercom du contact.
Recréez ces conversations sous le profil de l'user de destination.
Archivez ou supprimez le doublon du user source pour nettoyer.
Note : Si vous souhaitez filtrer les conversations par User ID plutôt que par Contact ID, vous devez inclure l'en-tête Intercom-Version avec une valeur de 2.5 ou moins. Le support pour la liste des conversations par user a été déprécié dans la version 2.6 de l'API au profit de la Search conversations API, qui fonctionne avec toutes les versions actuelles de l'API.
Voici comment fusionner deux profils :
Comment fusionner manuellement un lead dans un user
Il y a deux façons de déclencher une fusion manuelle :
Méthode 1 : Changez l'adresse email du lead. Ouvrez le profil du lead, localisez le champ Email, et mettez-le à jour pour correspondre à l'adresse email d'un user existant.
Le profil de lead sera alors automatiquement fusionné dans le profil de l'user correspondant lors de la prochaine visite de l'utilisateur sur votre site ou actualisation de la page.
Si deux users ou plus ont cette adresse email, l'user le plus récemment actif sera fusionné avec le lead.
Méthode 2 : Import via CSV (valeurs séparées par des virgules). Importez un fichier contenant les données du lead.
Note : Le lead doit avoir la même adresse email que celle d'un user existant pour qu'une fusion ait lieu. De plus, si un lead existe déjà dans Intercom, l'importation d'un CSV ne fusionnera pas le lead existant dans un user. Un lead importé via CSV ne fusionnera dans un user que s'il s'agit d'un tout nouveau lead.
Une fois l'import terminé, tout lead répondant aux conditions de fusion sera automatiquement fusionné dans le profil d'user correspondant. Vous pouvez vérifier la fusion en consultant le profil de l'user dans Intercom — les conversations et attributs du lead y apparaîtront.
Comment fusionner manuellement les doublons potentiels depuis l'Inbox
Note : Cette option est disponible pour tout coéquipier ayant accès à l'Inbox. L'option de fusion apparaît lors de la consultation d'une conversation avec un lead où un profil d'user en double a été détecté.
La fonction de doublons potentiels vous avertira via l'Inbox s'il existe des leads ou users en double pour la personne avec qui vous discutez actuellement. Si la conversation est avec un lead et que le doublon détecté est un user, vous pouvez cliquer sur Merge Lead into User. Vous verrez un aperçu exact des modifications que la fusion entraînera avant de la confirmer. Apprenez à lire l'aperçu de fusion Après la fusion, le profil de lead sera supprimé et le profil d'user restera comme enregistrement survivant. La conversation dans l'Inbox apparaîtra désormais sous le profil d'user fusionné.
Comment fonctionne la fusion automatique basée sur les cookies
Les fusions automatiques ne nécessitent aucune action de votre part. Lorsqu'une personne visite votre site en étant déconnectée, un cookie Intercom lui est attribué pour l'identifier de manière unique. Dès qu'elle commence une conversation ou répond à un message, elle devient un lead.
S'ils se connectent ou s'inscrivent à votre produit alors que le cookie Intercom est présent, leur profil de lead sera automatiquement fusionné avec leur profil d'user.
Comment activer la fusion automatique basée uniquement sur l'email
Note : Cette configuration nécessite un accès administrateur à l'espace de travail pour être configurée.
Vous pouvez activer la "Fusion des Leads non vérifiés dans les Users" dans vos Paramètres de sécurité. Cela modifiera la logique de fusion lead-user pour fusionner les leads dans les users uniquement sur la base de l'adresse email. Les leads et users ne devront pas partager le même appareil, cookie ou session pour qu'une fusion ait lieu. Avant d'activer ce paramètre, assurez-vous que "Sécuriser le Messenger avec JSON Web Tokens (JWTs)" est activé dans les paramètres de sécurité de l'installation du Messenger. Utilisez le secret de l'espace de travail correct lors de la génération du user_hash pour les environnements de test et de production.
Pour minimiser les doublons, activez les paramètres d'identification sur les pages concernées. C'est particulièrement important pour les applications monopage où les données de connexion doivent être transmises de manière cohérente. De plus, assurez-vous que votre intégration met à jour l'attribut Email par défaut dans Intercom chaque fois qu'un client change son email dans votre application pour éviter la création de profils séparés.
Si vous souhaitez activer cela, vous devez activer la vérification d'identité au préalable, car cela garantit que vos requêtes utilisateur proviennent bien des utilisateurs qu'ils prétendent être.
Note : Toute fusion automatique aura lieu lors de la prochaine connexion de l'utilisateur à Intercom.
Comment fusionner les profils en utilisant l'API
Note : Cette section est destinée aux développeurs ayant accès au REST API.
Vous pouvez aussi utiliser le REST API pour convertir un lead en user. Utilisez la structure JSON suivante pour la requête de fusion : { "from": "<lead's Intercom ID>", "into": "<user's Intercom ID>" }. Après une fusion réussie, le lead est supprimé et l'user devient l'enregistrement survivant.
Une fusion réussie renvoie l'objet contact user mis à jour. Vous pouvez vérifier la fusion en récupérant l'user via le Contacts API.
Note : Après avoir fusionné un lead dans un user, le frontend doit réinitialiser Messenger avec le user_id vérifié et un user_hash calculé (un hachage cryptographique HMAC-SHA256 de user_id, signé avec la clé secrète du Messenger) pour se conformer à la vérification d'identité obligatoire. Retournez ces valeurs dans la réponse de vérification du mot de passe à usage unique (OTP) afin que le frontend puisse lancer Messenger en tant qu'user correct.
Questions fréquentes sur la fusion des profils
Quelles données sont incluses dans la fusion ?
Attributs du profil de lead (uniquement si le profil d'user existant ne contient pas de valeur pour ces attributs)
Conversations (toutes les conversations associées aux profils de lead et d'user seront incluses)
Événements (premier/dernier survenu et nombre d'événements ; aucune métadonnée n'est incluse)
Pour voir exactement ce qui arrivera à une paire spécifique de profils — y compris quelles valeurs survivent et combien de conversations, tickets, notes, tags et appels téléphoniques sont transférés, utilisez l'aperçu de fusion.
Pourquoi un lead n'a-t-il pas fusionné ?
La plupart du temps, les profils de lead et d'user fusionnent immédiatement. Mais comme c'est un processus en arrière-plan (pas instantané), de petits délais peuvent survenir. Par exemple, lorsqu'un user se connecte et qu'il y a un ou plusieurs leads marqués comme nécessitant une fusion (basée sur cookie et email), le processus de fusion automatique commencera au prochain ping (rafraîchissement de page) de cet user. Pour résoudre ce problème, assurez-vous que les données utilisateur envoyées à Intercom incluent les bons identifiants tels que user_id et email. Confirmez aussi que le navigateur de l'user conserve les cookies nécessaires, car des cookies expirés ou supprimés peuvent empêcher les fusions réussies.
Les leads créés via le REST API n'ont pas de cookie de session navigateur, donc ils ne fusionneront pas automatiquement comme les leads basés sur les cookies. Les scénarios suivants entraînent tous l'absence de fusion automatique :
Si vous créez un lead via l'API, puis un user avec la même adresse email qui n'existait pas auparavant envoie un ping (en se connectant à votre application), les profils de lead et d'user ne seront pas fusionnés automatiquement. Intercom ne fait la fusion asynchrone que lorsque le lead et l'user ont le même anonymous_id (un identifiant unique stocké dans le cookie de session du navigateur). Les leads créés via l'API n'ont pas de cookies. Vous pouvez plutôt fusionner manuellement via l'API.
Si vous créez un lead via l'API et qu'un user avec la même adresse email existe déjà, alors lorsque cet user existant envoie un ping (en se connectant à votre application), les enregistrements de lead et d'user ne fusionneront pas automatiquement.
Si vous créez un lead via l'API, puis créez un user via l'API, le profil de lead ne sera pas fusionné automatiquement dans le profil d'user lorsque cet user enverra un ping (en se connectant à votre application).