Importar contactos desde Excel o CSV (con consentimiento)

Contactos → Importar (/app/contacts/import) trae una lista completa de clientes desde un archivo. Añadir contacto en la página Contactos añade una persona a mano. No se guarda nada hasta que hayas revisado el archivo y pulsado el botón de importar.

Antes de empezar

• Importar requiere la tarea Importar contactos (propietarios y administradores por defecto; un propietario o administrador puede dársela a cualquiera con Editar acceso en Configuración → Miembros, consulta Roles y tareas). Sin ella, el botón Importar está oculto y la página dice Para importar contactos necesitas la tarea Importar contactos. Pídesela a un Propietario o Administrador.
• Añadir contacto requiere la tarea Administrar contactos (propietarios, administradores y editores por defecto).
• El archivo: CSV (UTF-8, UTF-16 o árabe de Windows; con comas, punto y coma o tabulaciones) o Excel .xlsx (la primera hoja). Hasta 20 MB y 100.000 filas. Un Excel antiguo .xls se rechaza: en Excel elige Archivo > Guardar como > Libro de Excel (.xlsx) o CSV UTF-8.
• La primera fila debe nombrar las columnas, por ejemplo Name, Phone, Email o الاسم، الجوال، البريد الإلكتروني. Cada persona necesita un número de teléfono o un correo electrónico.
• Para importar datos personalizados (nivel de membresía, cumpleaños...), crea primero los campos en Campos personalizados de contacto.

Paso a paso: importar un archivo

1. En Contactos pulsa Importar. 2. Archivo: pulsa Elige un archivo, selecciónalo y pulsa Subir. Ves Leyendo el archivo… y luego las columnas. 3. Columnas: en Asignar las columnas, cada columna de tu archivo tiene un cuadro Importar como. Lo deducimos de los encabezados en inglés y en árabe (الجوال → Teléfono (WhatsApp), الاسم → Nombre, un encabezado que coincide con un campo personalizado → ese campo). Pon las columnas que no necesites en No importar. Ejemplo muestra un valor del archivo. 4. En Opciones: - País para los números locales: los números escritos sin código de país (0501234567, o 501234567 cuando Excel quitó el cero) se interpretan como números de este país. Los dígitos árabes (٠٥٠...) no son problema. Una columna País en el archivo tiene prioridad para su fila. Empieza con el país de tu empresa. - Personas que ya están en Contactos (mismo teléfono o correo electrónico): Actualizarlas con los valores del archivo (las celdas con datos sustituyen lo que tenía el contacto, las celdas vacías nunca borran nada, las etiquetas se añaden, un teléfono o correo electrónico solo se añade cuando el contacto no tiene ninguno) u Omitirlas. - Etiquetas extra para todos los importados (separadas por comas). 5. Pulsa Continuar. 6. Consentimiento: elige No: no aceptaron, o no lo sé o Sí: aceptaron y puedo decir cómo. Si es sí, marca los Canales en los que aceptaron (WhatsApp, SMS, Correo electrónico), elige ¿Dónde aceptaron?, escribe ¿Cómo aceptaron estas personas? (al menos 10 caracteres, por ejemplo "Marcaron Envíenme ofertas por WhatsApp al unirse a nuestro programa de fidelidad"), rellena Cuándo aceptaron (opcional) si lo sabes y marca Confirmo que estas personas dieron este consentimiento y puedo mostrar la prueba si me la piden. 7. Pulsa Revisar el archivo. La revisión lee cada fila y no guarda nada (Revisando n de N filas…). 8. Resultado de la revisión muestra Listos para importar, Con problemas, Contactos nuevos, Ya están en Contactos y Repetidos en el archivo, y las Primeras filas con problemas con el motivo. Cambiar configuración te lleva atrás; Descargar errors.csv da todas las filas con problemas. 9. Pulsa Importar n contactos. Importando n de N… muestra el progreso. Puedes salir de la página: la importación continúa, y Contactos → Importar → Importaciones recientes la vuelve a abrir (Abrir). 10. Cuando veas Importación finalizada., pulsa Ver contactos importados para ver la lista, o Descargar errors.csv. Bajo los totales, Todas las personas que esta importación creó o actualizó están en la lista "Import – customers.csv – 2026-09-24" (n personas). indica la lista que creó la importación; Abrir la lista la abre en Contactos → Audiencias (consulta la siguiente sección).

La lista de la importación

Cuando termina una importación, todas las personas que creó o actualizó se ponen en una nueva lista (una audiencia estática) llamada Import – <file name> – <date>, por ejemplo Import – customers.csv – 2026-09-24. Úsala como cualquier lista: elígela como audiencia de una difusión de WhatsApp, ábrela en Contactos → Audiencias, añade o quita personas (Audiencias).

• Las personas omitidas (que ya estaban en Contactos, con Omitirlas), las filas con problemas y las filas que no se pudieron guardar no están en ella.
• La fecha es el día en que terminó la importación. Si importas el mismo archivo de nuevo el mismo día, sus personas se unen a la misma lista; otro día obtienes una lista nueva.
• Una importación cancelada no obtiene lista. Las personas que ya había importado conservan la etiqueta de la importación, así que todavía puedes encontrarlas.
• Un espacio de trabajo guarda hasta 500 audiencias. Cuando ya tiene 500, la importación termina sin lista y dice No se creó ninguna lista para esta importación: el espacio de trabajo ya tiene 500 audiencias. Archiva las listas que ya no necesites en Contactos → Audiencias; la etiqueta sigue marcando a todas las personas del archivo.

Cómo se identifican las personas (sin duplicados)

• Una fila es la misma persona que un contacto cuando su número de teléfono (después de escribirlo como +código de país y número) o su correo electrónico ya está en este espacio de trabajo, en cualquier canal. Un contacto fusionado se actualiza como una sola persona.
• Dos filas con el mismo número o correo electrónico en un archivo se convierten en un contacto: la primera lo crea y las siguientes lo actualizan (o se omiten si elegiste Omitirlas).
• Un contacto nuevo con número de teléfono se crea como contacto de WhatsApp de esa persona, así que cuando te escribe, sus mensajes llegan a la misma tarjeta. Su Origen es Importación.
• Cada contacto importado recibe la etiqueta propia de la importación, import: más la fecha y el nombre del archivo (por ejemplo import:2026-09-24-customers-3f9a), para que puedas volver a encontrarlos en la página Contactos (filtrando por la etiqueta), además de la lista de la importación descrita arriba.

Consentimiento: qué se registra

• Con Sí, cada persona recibe un registro de consentimiento por canal marcado, con el origen Importación y tu declaración, el lugar, la fecha y el nombre del archivo como prueba, y quién inició la importación. Aparece en Historial de consentimiento en el contacto (Consentimiento y baja).
• Solo los canales para los que la fila tiene una dirección: WhatsApp y SMS necesitan un número de teléfono; el correo electrónico necesita un correo electrónico.
• Una columna Consentimiento de marketing (sí / no) en el archivo: solo las filas que dicen sí (yes, y, 1, نعم, موافق) obtienen consentimiento; las filas que dicen no o están vacías no obtienen ninguno. Esa columna necesita la declaración (Sí) o debe ponerse en No importar.
• Las personas que se dieron de baja o respondieron STOP conservan su elección (se cuentan como Se mantuvo su negativa anterior). Una importación nunca la anula; solo puede hacerlo la persona, o un compañero que registre su nueva aceptación con Registrar consentimiento.
• Con No, nadie obtiene consentimiento de marketing. Igualmente pueden recibir respuestas dentro de la ventana de 24 horas y mensajes de utilidad.

Si algo sale mal

• Este es un archivo antiguo de Excel (.xls)... → guárdalo como .xlsx o CSV UTF-8 y vuelve a subirlo.
• La primera fila debe nombrar las columnas → añade una fila de encabezado.
• El archivo tiene más de 100.000 filas o El archivo pesa más de 20 MB → divídelo.
• Asigna una columna de teléfono o de correo electrónico. → pon una columna en Teléfono (WhatsApp) o Correo electrónico.
• Hay dos columnas asignadas a "…" → pon una de ellas en No importar.
• Filas en errors.csv, con el motivo: No es un número de teléfono válido (revisa el código de país) (revisa País para los números locales), Sin número de teléfono ni correo electrónico, No es una dirección de correo electrónico válida, País desconocido, Idioma desconocido, Zona horaria desconocida, Un valor de campo personalizado no encaja con el campo (el campo se indica en el detalle: una opción debe ser una de sus opciones, una fecha AAAA-MM-DD o día/mes/año, un número solo dígitos), La columna de consentimiento debe decir sí o no, Ya es un contacto: se omitió, No se pudo guardar (intenta importar esa fila de nuevo). errors.csv tiene las columnas propias del archivo, así que puedes corregir las filas e importarlas como un archivo nuevo.
• Cancelar importación se detiene antes de las siguientes 1.000 filas; los contactos ya importados se quedan.
• Las filas y la copia guardada del archivo se eliminan 30 días después de subirlo; a partir de entonces errors.csv ya no está disponible (Las filas de este archivo se eliminaron 30 días después de subirlo.). Los totales de la importación y la declaración de consentimiento se conservan.

Añadir un contacto

1. En Contactos pulsa Añadir contacto.
2. Rellena Nombre y al menos uno de estos: Teléfono (WhatsApp) (con el código de país, o un número local del País que elijas), Correo electrónico o Usuario en otra plataforma con su Plataforma.
3. Opcional: Etiquetas (separadas por comas), Notas y, en Consentimiento de marketing (opcional), los canales que la persona aceptó más ¿Cómo dio su consentimiento?
4. Pulsa Añadir contacto. Ves Se añadió a {name}. y se abre el contacto.
5. Esta persona ya está en Contactos. → el número o el correo electrónico pertenece a alguien; pulsa Abrir el contacto.

Un contacto añadido solo con un usuario obtiene su propia tarjeta; cuando la persona te escriba desde esa plataforma, fusiona los dos con Fusionar con… (Contactos).

Desarrolladores (API)

POST /workspaces/{workspaceId}/contacts añade un contacto (name, phone, email, handle + platform, country, tags, notes, attributes, consent: {channels, evidence}); 409 devuelve el contactId existente. Importaciones: POST .../contacts/imports (multipart file), GET .../contacts/imports/{id}, PATCH {mapping, options}, POST .../validate, POST .../run, POST .../cancel, GET .../errors.csv?lang=ar. El GET de una importación finalizada devuelve audience (id, name, memberCount): la lista descrita arriba.

Relacionado

• Contactos
• Listas y segmentos (audiencias)
• Consentimiento y baja
• Campos personalizados de contacto
• Difusiones de WhatsApp