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

Nota:

Si solo necesitas añadir 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 a Intercom mediante importación CSV.

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

Las importaciones CSV también permiten crear atributos personalizados para users (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 a Intercom y cumplen inmediatamente los criterios para un mensaje 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 a 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 user ID y email como identificadores puede generar users duplicados. Para mejores resultados:
- Asegúrate de que cada registro incluya tanto un user ID como un email siempre que sea posible.
- Recuerda que el user ID tiene prioridad si se suministran ambos, lo que ayuda a evitar 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 te pedirá seleccionar 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 evitarlo, 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: ID de Intercom → user_id → email. Si un perfil de user no tiene user_id y tu CSV incluye ambos, email y user_id, Intercom no hará la coincidencia por email, tratará el user_id como un nuevo identificador y creará un contacto duplicado. Para evitarlo, 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 lo tenga antes de tu importación CSV.

5. Si has añadido columnas adicionales, Intercom te pedirá que nombres 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 ‘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 añadir el código de llamada del país al inicio de tus números telefónicos. Por ejemplo, para números de EE. UU. añadirías ‘+1’ o ‘001’.

Nota: Si importas contactos para usar con mensajes de WhatsApp, solo un número de teléfono no es suficiente. Cada fila en tu CSV debe incluir también un identificador de contacto — ya sea una dirección de email o un user_id. Importar un CSV solo con números de teléfono 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 users con una importación CSV?

Sí. Puedes actualizar valores y añadir 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 el nuevo email.
No puedes actualizar el user_id estableciendo un nuevo valor para él y usando el email existente; eso crearía un nuevo registro.
Si usas tanto user_id como email en Intercom, enviar el email en una importación CSV es suficiente para hacer coincidir el registro del user en Intercom.

Importar users vía Rest API

Es posible importar users, junto con atributos personalizados, vía la REST API. Una vez importados, también puedes añadir 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.

Cómo descargar un informe de errores para una importación CSV

Cuando una importación CSV de contactos tiene filas fallidas, puedes descargar un informe de errores: un archivo CSV que lista cada error en la importación, para que puedas corregir todas las filas fallidas en tu archivo de una vez y reimportar.

Ve a Configuración > Datos > Importaciones y exportaciones y abre Importaciones CSV.
Encuentra tu importación en la lista. Un indicador giratorio aparece en la columna de informe de errores mientras se prepara el informe.
Haz clic en Descargar informe de errores para descargar el archivo CSV.

El informe de errores de importación CSV incluye lo siguiente para cada error:

Número de fila en la hoja de cálculo, que coincide con la fila en tu propio archivo. Los números de fila cuentan la fila de encabezado y cualquier fila en blanco, así que la fila 7 en el informe es la fila 7 en tu hoja de cálculo.
ID de user y Email del contacto en esa fila.
Columna que causó el error.
Tipo de error, en lenguaje claro, como "Email inválido", "Email faltante", "Tipo de dato incorrecto", "Longitud máxima excedida" o "Múltiples registros coinciden".

Cada error está listado, así que una fila con 2 errores aparece dos veces en el informe de errores.

Nota: Solo el compañero que ejecutó la importación CSV puede descargar su informe de errores, y el informe se conserva por 30 días. El informe de errores no aparece en la página de exportaciones CSV, y no se envía correo cuando está listo. Las importaciones realizadas antes de que se lanzara el informe de errores aún muestran el resumen de importación anterior.

¿Qué significa el error "Múltiples registros coinciden"?

El error "múltiples registros coinciden" 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 user ID único.

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

Comprender las causas de users duplicados

Los perfiles duplicados de users en Intercom pueden surgir por varias razones. La jerarquía de identificadores en Intercom (ID de Intercom > 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 conectadas, direcciones de email superpuestas y cambios en los identificadores de users agravan la situación. Problemas específicos de 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 se usan email y user ID de forma inconsistente, pueden ocurrir duplicados. El email sirve como identificador único solo si no se proporciona user ID. Por lo tanto, dos users pueden compartir el mismo email si tienen diferentes user IDs. Esto puede suceder tras actualizaciones en el backend o cambios en la generación de user ID.
Comportamientos de integración:
- Integraciones de apps como Shopify pueden crear users donde no existe una coincidencia exacta, usando el email como identificador único en lugar de reconciliar user IDs.
Lógica de coincidencia durante cargas:
- Si solo se proporciona un user ID o email durante las importaciones, Intercom intenta hacer la coincidencia con el campo proporcionado. Sin embargo, pueden ocurrir discrepancias cuando ambos campos están mal asignados o son inconsistentes.
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 generar duplicados.

La inicialización incorrecta del SDK o la transición de un estado anónimo a conectado sin actualizaciones adecuadas a menudo conduce a duplicados. 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 user ID como email. Por ejemplo:
  - Si solo se proporciona un email, el sistema hace la coincidencia basada en email.
  - Si solo se proporciona un user ID, el sistema hace la coincidencia basada en user ID.
  - Cuando se proporcionan ambos, user ID tiene prioridad; si no existe coincidencia por user ID, el sistema hace la coincidencia por 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 correctos de user_id y email.
- Apaga el SDK (Intercom('shutdown')) antes de que los users cierren sesión para evitar duplicados.
Verificar 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 duplicados. Consulta nuestra guía de autenticación de users para más pasos.
Adaptarse a requisitos específicos de la plataforma:
- Ejemplo: Para WhatsApp, asegúrate de que configuraciones como "Identificar users existentes" estén activadas, y trata de capturar identificadores de email temprano para consistencia.
Precauciones en la 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 los datos de tus users en Intercom