Si vous êtes un client actuel d'Intercom, vous pouvez importer vos users depuis les sources suivantes :

Note :

Si vous avez juste besoin d'ajouter quelques users à la fois, comme des personnes rencontrées lors d'un événement, vous pouvez les créer directement depuis la liste des personnes.
Il n'est pas possible d'importer des attributs d'entreprise ou des données d'entreprise dans Intercom via l'import CSV.

Toutes les méthodes vous permettent d'importer le nom d'utilisateur, l'email, userID et la date d'inscription au format JJ/MM/AAAA, ISO 8601, ou un timestamp Unix. Notez que si vous utilisez JJ/MM/AAAA, vous ne pouvez pas nous envoyer l'heure.

Les imports CSV vous permettent également de créer des attributs utilisateurs personnalisés (incluez une colonne pour chacun).
Mixpanel inclut last_seen.
MailChimp importe l'IP de l'utilisateur.

Commencer

Tout d'abord, connectez-vous à votre compte Intercom et cliquez sur 'New users or leads' depuis la liste des personnes.

Ensuite, sélectionnez 'Import people' :

Puis, choisissez la méthode que vous souhaitez utiliser pour importer des users et suivez les étapes d'importation.

Vous pouvez également accéder à toutes ces options dans Paramètres > Données > Importations & exportations :

Si vous importez des users dans Intercom et qu'ils correspondent immédiatement aux critères d'un message actif, ils recevront ce message immédiatement.

Comment importer des users depuis un CSV

Étape par étape :

Si vous avez sélectionné l'option d'import CSV, il vous suffit de suivre les étapes suivantes pour importer vos users :

Complétez les étapes 1 et 2 décrites ci-dessus dans la section 'Importer des users à tout moment'. Assurez-vous de cliquer sur Ouvrir l'outil d'import CSV.
Sélectionnez Importer des users pour importer une liste d'utilisateurs connectés ou de clients de votre produit. Ou choisissez ‘Importer des leads’ pour importer une liste de leads dans votre espace Intercom.
Glissez-déposez votre fichier CSV et cliquez sur Téléverser. La taille maximale du fichier est de 20 Mo. Vous devez diviser le fichier s'il est plus volumineux.

Exigences importantes du format CSV :

La colonne user ID doit être formatée comme user_id (minuscules avec underscore)
Vous pouvez identifier les users en utilisant soit :
- user_id (recommandé)
- Colonne Email
Si les deux sont présents, user_id a la priorité
user_id est requis si aucun email n'est fourni
L'utilisation incohérente de user ID et d'email comme identifiants peut entraîner la création de users en double. Pour des résultats optimaux :
- Assurez-vous que chaque enregistrement inclut à la fois un user ID et un email autant que possible.
- Rappelez-vous que le user ID est prioritaire si les deux sont fournis, ce qui aide à éviter les comptes en double.

Meilleure pratique : incluez à la fois les colonnes user_id et Email dans votre fichier CSV pour une gestion optimale des users.

4. Intercom vous invitera maintenant à sélectionner les colonnes pertinentes contenant les adresses email, IDs, noms complets et dates d'inscription de vos users. Cliquez sur ‘Sélectionner cette colonne’ pour chacune et cliquez sur ‘Confirmer’.

Tous les users ou leads dans votre CSV doivent avoir une adresse email. Des doublons peuvent survenir lorsque leads et users avec la même adresse email sont traités comme des entités distinctes. Pour éviter cela, assurez la synchronisation des données users et leads lors des imports.

L'import d'un CSV avec à la fois email et user_id peut créer des doublons si le profil existant n'a pas de user_id.

Les contacts sont identifiés dans l'ordre suivant : Intercom ID → user_id → email. Si un profil user n'a pas de user_id défini, et que votre CSV inclut à la fois un email et un user_id, Intercom ne fera pas correspondre sur l'email, il traitera le user_id comme un nouvel identifiant et créera un contact en double. Pour éviter cela, assurez-vous que les valeurs user_id sont cohérentes et définies pour tous les users avant l'import. Utilisez l'API pour mettre à jour le user_id des users existants qui en sont dépourvus avant votre import CSV.

5. Si vous avez ajouté des colonnes supplémentaires, Intercom vous invitera à donner un nom spécifique à vos attributs personnalisés. Cliquez sur ‘Confirmer’ une fois que vous avez nommé votre attribut personnalisé.

6. Étiquetez votre liste CSV avec un terme mémorable tel que ‘New Sign-Ups 2015’

7. Une fois importée, vous pouvez rechercher dans votre liste Intercom User ‘tag: New Sign-Ups 2015.’ Vous êtes maintenant prêt à faire des actions comme envoyer un message ponctuel à tous sur la liste ou créer un segment pour ce groupe et leur envoyer un message Proactif ciblé.

Vous devrez ajouter l'indicatif téléphonique au début de vos numéros. Par exemple, pour les numéros US, ajoutez ‘+1’ ou ‘001’.

Note : Si vous importez des contacts pour utiliser la messagerie WhatsApp, un numéro de téléphone seul ne suffit pas. Chaque ligne de votre CSV doit aussi inclure un identifiant de contact — soit une adresse email, soit un user_id. Importer un CSV avec uniquement des numéros de téléphone ne fonctionnera pas pour la messagerie sortante WhatsApp.

Note : Les étiquettes peuvent prendre quelques minutes pour s'appliquer complètement après la fin de votre import. Veuillez patienter pour que toutes les étiquettes soient appliquées aux users importés.

Puis-je mettre à jour les données users avec un import CSV ?

Oui. Vous pouvez mettre à jour les valeurs et ajouter de nouveaux attributs pour les users existants. Tous les imports CSV nécessitent une colonne avec les adresses email des users. Quelques points à noter :

Vous pouvez mettre à jour l'email d'un user en envoyant le même user_id avec une adresse email différente. Nous mettrons à jour le user avec ce user_id dans Intercom pour refléter la nouvelle adresse email.
Vous ne pouvez pas mettre à jour le user_id en définissant une nouvelle valeur pour celui-ci tout en utilisant l'adresse email existante - cela créerait un nouvel enregistrement.
Si vous utilisez à la fois user_id et email dans Intercom, envoyer l'email dans un import CSV suffit à faire correspondre l'enregistrement user dans Intercom.

Importer des users via Rest API

Il est possible d'importer des users, ainsi que des attributs utilisateurs personnalisés, via le REST API. Une fois les users importés, vous pouvez aussi ajouter des données d'événements historiques pour vos users via le Events API.

Consultez ce tutoriel qui explique comment importer des données de contacts users et leads depuis un fichier JSON en utilisant les APIs Intercom.

Voir votre historique d'importation de données

Vous pouvez voir votre historique d'importation de données dans la section paramètres d'Intercom.

Que signifie l'erreur « Plusieurs enregistrements correspondent » ?

L'erreur « plusieurs enregistrements correspondent » se produit généralement lorsqu'il y a plusieurs users dans votre système avec la même adresse email. Cela crée un conflit car le système ne peut pas déterminer quel user mettre à jour. Pour résoudre ce problème, vous devez vous assurer que chaque user a une adresse email ou un user ID unique.

Vous pouvez compléter les identifiants appropriés en utilisant l'API d'Intercom en mettant à jour systématiquement les champs external_id pour fusionner les doublons et clarifier les correspondances.

Comprendre les causes des users en double

Les profils users en double dans Intercom peuvent survenir pour diverses raisons. La hiérarchie des identifiants dans Intercom (Intercom ID > User ID > Email) joue un rôle important. Lorsqu'un user_id unique et stable n'est pas fourni, des doublons peuvent apparaître. Par exemple, envoyer des valeurs user_id différentes pour le même email ou initialiser des users sans user_id entraîne des doublons. Les transitions d'une session anonyme à une session connectée, les adresses email qui se chevauchent et les changements d'identifiants utilisateurs aggravent la situation. Les problèmes spécifiques à la plateforme, comme les intégrations WhatsApp où les profils sont générés uniquement avec des numéros de téléphone, contribuent aussi au problème.

Identifiants utilisateurs incohérents :
- Si l'email et le user ID sont utilisés de manière incohérente, des doublons peuvent survenir. L'email sert d'identifiant unique uniquement si aucun user ID n'est fourni. Par conséquent, deux users peuvent partager la même adresse email s'ils ont des user IDs différents. Cela peut arriver après des mises à jour backend ou des changements dans la génération des user IDs.
Comportements d'intégration :
- Les intégrations d'applications comme Shopify peuvent créer des users sans correspondance stricte, utilisant l'email comme identifiant unique au lieu de réconcilier les user IDs.
Logique de correspondance lors des téléchargements :
- Si seul un user ID ou une adresse email est fourni lors des imports, Intercom tente de faire correspondre sur le champ fourni. Cependant, des écarts peuvent survenir lorsque les deux champs sont mal appariés ou attribués de manière incohérente.
Chevauchement des Users et Leads :
- Les Leads et users sont traités comme des objets différents, même lorsqu'ils partagent la même adresse email, ce qui peut entraîner des doublons.

Une initialisation incorrecte du SDK ou la transition d'un état anonyme à connecté sans mises à jour appropriées conduit souvent à des doublons. Par exemple, attribuer un user_id aléatoire pour la navigation anonyme peut créer de nouveaux profils lors de la transition de session.

Prévention des users en double

Standardiser les identifiants utilisateurs :
- Assurez-vous que votre configuration attribue systématiquement à la fois un user ID et une adresse email. Par exemple :
  - Si seul un email est fourni, le système fait correspondre sur l'email.
  - Si seul un user ID est fourni, le système fait correspondre sur le user ID.
  - Lorsque les deux sont fournis, le user ID prend la priorité ; s'il n'y a pas de correspondance par user ID, le système fait correspondre sur l'email.
Initialisation correcte du SDK :
- Pour les users anonymes, initialisez uniquement le SDK avec le app_id.
- Après la connexion, mettez à jour les profils avec les identifiants user_id et email appropriés.
- Arrêtez le SDK (Intercom('shutdown')) avant la déconnexion des users pour éviter les doublons.
Vérifiez les paramètres de conversion des leads :
- Utilisez des user IDs cohérents lors des connexions pour convertir les leads actifs en users sans duplication. Consultez notre guide d'authentification utilisateur pour plus d'informations.
Adaptez-vous aux exigences spécifiques à la plateforme :
- Exemple : Pour WhatsApp, assurez-vous que les paramètres comme « Identifier les users existants » sont activés, et essayez de capturer les identifiants email tôt pour plus de cohérence.
Précautions lors de la migration :
- Lors de la transition vers de nouveaux systèmes d'identification (par exemple UUID), utilisez l'API d'Intercom pour mettre à jour et gérer efficacement les champs external_id sans créer de doublons.

Importez vos données utilisateurs dans Intercom