Si eres un cliente actual de Intercom, puedes importar tus users desde las siguientes fuentes:

Nota:

Si solo necesitas agregar unos pocos users a la vez, como personas que conociste en un evento, puedes crearlos directamente desde la lista de personas.
No es posible importar atributos de empresa o datos de empresa en Intercom mediante la importación CSV.

Todos los métodos te permiten importar nombre de usuario, email, userID y fecha de registro en formato DD/MM/AAAA, ISO 8601 o una marca de tiempo Unix. Ten en cuenta que si usas DD/MM/AAAA no puedes enviarnos la hora.

Las importaciones CSV también te permiten crear atributos personalizados de usuario (incluye una columna para cada uno).
Mixpanel incluye last_seen.
MailChimp importa la IP del user.

Comenzar

Primero, inicia sesión en tu cuenta de Intercom y haz clic en 'New users or leads' desde la lista de personas.

Luego, selecciona 'Import people':

A continuación, elige el método que deseas usar para importar users y sigue los pasos de importación.

También puedes acceder a todas estas opciones en Configuración > Datos > Importaciones y exportaciones:

Si importas users en Intercom y coinciden inmediatamente con los criterios para un mensaje que tienes activo, recibirán ese mensaje de inmediato.

Cómo importar users desde un CSV

Paso a paso:

Si has seleccionado la opción de importación CSV, simplemente completa los siguientes pasos para importar tus users:

Completa los pasos 1 y 2 descritos arriba en la sección 'Import users any time'. Asegúrate de hacer clic en Abrir herramienta de importación CSV.
Selecciona Import users para importar una lista de users conectados o clientes de tu producto. O elige ‘Import leads’ para importar una lista de leads en tu espacio de trabajo de Intercom.
Arrastra y suelta tu archivo CSV y haz clic en Subir. El tamaño máximo del archivo es 20 mb. Debes dividir el archivo si es más grande.

Requisitos importantes del formato CSV:

La columna de ID de user debe estar formateada como user_id (minúsculas con guion bajo)
Puedes identificar users usando cualquiera de estos:
- user_id (recomendado)
- Columna de email
Si ambos están presentes, user_id tiene prioridad
user_id es obligatorio si no se proporciona email
El uso inconsistente de ID de user y email como identificadores puede llevar a la creación de users duplicados. Para obtener mejores resultados:
- Asegúrate de que cada registro incluya tanto un ID de user como un email siempre que sea posible.
- Recuerda que el ID de user tiene prioridad si se suministran ambos, lo que ayuda a prevenir cuentas duplicadas.

Mejor práctica: incluye ambas columnas user_id y Email en tu archivo CSV para una gestión óptima de users.

4. Intercom ahora te pedirá que selecciones las columnas relevantes que contienen los emails, IDs, nombres completos y fechas de registro de tus users. Haz clic en ‘Seleccionar esta columna’ para cada una y luego en ‘Confirmar’.

Todos los users o leads en tu CSV deben tener una dirección de email. Pueden ocurrir entradas duplicadas cuando leads y users con el mismo email se tratan como entidades separadas. Para evitar esto, asegúrate de sincronizar los datos de users y leads durante las importaciones.

Importar un CSV con email y user_id puede crear duplicados si el perfil existente no tiene user_id.

Los contactos se identifican en el siguiente orden: Intercom ID → user_id → email. Si un perfil de user no tiene user_id establecido, y tu CSV incluye tanto email como user_id, Intercom no hará la coincidencia por email, tratará el user_id como un nuevo identificador y creará un contacto duplicado. Para evitar esto, asegúrate de que los valores de user_id sean consistentes y estén establecidos para todos los users antes de importar. Usa la API para actualizar user_id de cualquier user existente que no tenga uno antes de tu importación CSV.

5. Si has añadido columnas adicionales, Intercom te pedirá que des un nombre específico a tus atributos personalizados. Haz clic en ‘Confirmar’ una vez que hayas nombrado tu atributo personalizado.

6. Etiqueta tu lista CSV con un término memorable como ‘New Sign-Ups 2015’

7. Una vez importado, puedes buscar en tu lista de Users de Intercom por ‘tag: New Sign-Ups 2015.’ Ahora estás listo para hacer cosas como enviar un mensaje único a todos en la lista o crear un segmento para ese grupo y enviarles un mensaje Proactivo dirigido.

Necesitarás agregar el código de llamada del país al inicio de tus números telefónicos. Por ejemplo, para números de EE. UU. agregarías ‘+1’ o ‘001’.

Nota: Si importas contactos para usar con mensajes de WhatsApp, solo un número telefónico no es suficiente. Cada fila en tu CSV también debe incluir un identificador de contacto — ya sea una dirección de email o un user_id. Importar un CSV solo con números telefónicos no funcionará para mensajes salientes de WhatsApp.

Nota: Las etiquetas pueden tardar unos minutos en aplicarse completamente después de que tu importación termine. Por favor, espera un poco para que todas las etiquetas se apliquen a los users importados.

¿Puedo actualizar datos de user con una importación CSV?

Sí. Puedes actualizar valores y agregar nuevos atributos para users existentes. Todas las importaciones CSV requieren que tengas una columna con direcciones de email de users. Algunas cosas a tener en cuenta:

Puedes actualizar el email de un user enviando el mismo user_id y una dirección de email diferente. Actualizaremos el user con ese user_id en Intercom para reflejar la nueva dirección de email.
No puedes actualizar el user_id estableciendo un nuevo valor para él y usando la dirección de email existente; eso crearía un nuevo registro.
Si usas tanto user_id como email en Intercom, enviar email en una importación CSV es suficiente para coincidir con el registro de user en Intercom.

Importar users vía Rest API

Es posible importar users, junto con atributos personalizados, vía la REST API. Una vez que hayas importado users, también puedes agregar datos históricos de eventos para tus users vía la Events API.

Consulta este tutorial que explica cómo importar datos de contacto de users y leads desde un archivo JSON usando las APIs de Intercom.

Ver tu historial de importación de datos

Puedes ver tu historial de importación de datos en la sección de configuración en Intercom.

¿Qué significa el error "Multiple records match"?

El error "multiple records matched" suele ocurrir cuando hay varios users en tu sistema con la misma dirección de email. Esto crea un conflicto porque el sistema no puede determinar qué user actualizar. Para resolverlo, debes asegurarte de que cada user tenga una dirección de email o un ID de user único.

Puedes rellenar identificadores correctos usando la API de Intercom actualizando sistemáticamente los campos external_id para fusionar duplicados y aclarar coincidencias.

Comprendiendo las causas de users duplicados

Los perfiles de users duplicados en Intercom pueden surgir por varias razones. La jerarquía de identificadores en Intercom (Intercom ID > User ID > Email) juega un papel importante. Cuando no se proporciona un user_id único y estable, pueden ocurrir duplicados. Por ejemplo, enviar valores diferentes de user_id para el mismo email o iniciar users sin user_id conduce a duplicación. Las transiciones de sesiones anónimas a iniciadas, direcciones de email superpuestas y cambios en los identificadores de user agravan la situación. Problemas específicos de la plataforma, como integraciones de WhatsApp donde los perfiles se generan solo con números telefónicos, también contribuyen al problema.

Identificadores de user inconsistentes:
- Si el email y el ID de user se usan de forma inconsistente, pueden ocurrir duplicados. El email sirve como identificador único solo si no se proporciona ID de user. Por lo tanto, dos users pueden compartir el mismo email si tienen diferentes IDs de user. Esto puede suceder tras actualizaciones en el backend o cambios en la generación de IDs de user.
Comportamientos de integración:
- Las integraciones de apps como Shopify pueden crear users donde no existe una coincidencia exacta, usando el ID de email como identificador único en lugar de conciliar los IDs de user.
Lógica de coincidencia durante cargas:
- Si solo se proporciona un ID de user o una dirección de email durante las importaciones, Intercom intenta coincidir con el campo proporcionado. Sin embargo, pueden ocurrir discrepancias cuando ambos campos están mal asignados o se asignan de forma inconsistente.
Superposición de Users y Leads:
- Leads y users se tratan como objetos diferentes, incluso cuando comparten la misma dirección de email, lo que puede llevar a duplicados.

La inicialización incorrecta del SDK o la transición de un estado anónimo a uno iniciado sin actualizaciones adecuadas a menudo conduce a duplicación. Por ejemplo, asignar un user_id aleatorio para navegación anónima puede crear nuevos perfiles cuando la sesión cambia.

Prevención de users duplicados

Estandarizar identificadores de user:
- Asegúrate de que tu configuración asigne consistentemente tanto ID de user como valores de email. Por ejemplo:
  - Si solo se proporciona un email, el sistema coincide basado en el email.
  - Si solo se proporciona un ID de user, el sistema coincide basado en el ID de user.
  - Cuando se proporcionan ambos, el ID de user tiene prioridad; si no existe coincidencia por ID de user, el sistema coincide basado en el email.
Inicialización adecuada del SDK:
- Para users anónimos, solo inicializa el SDK con el app_id.
- Después del inicio de sesión, actualiza los perfiles con los identificadores adecuados de user_id y email.
- Apaga el SDK (Intercom('shutdown')) antes de que los users cierren sesión para evitar duplicados.
Verifica la configuración de conversión de leads:
- Usa IDs de user consistentes durante los inicios de sesión para convertir leads activos en users sin duplicación. Consulta nuestra guía de autenticación de users para más pasos.
Adáptate a los requisitos específicos de la plataforma:
- Ejemplo: Para WhatsApp, asegúrate de que configuraciones como "Identificar users existentes" estén habilitadas, y trata de capturar identificadores de email temprano para consistencia.
Precauciones de migración:
- Al hacer la transición a nuevos sistemas de ID (por ejemplo, UUIDs), utiliza la API de Intercom para actualizar y gestionar los campos external_id eficazmente sin causar duplicados.

Importa tus datos de usuario en Intercom