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 Windows Arabic; comas, puntos y coma o tabulaciones) o Excel .xlsx (la primera hoja). Hasta 20 MB, 100.000 filas y 200 columnas. Se rechaza un .xls antiguo de Excel: 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 una caja Importar como . Adivinamos por los encabezados en los diez idiomas de la app, con o sin acentos ('الجوال', 'Téléphone', 'Handy' o 'Cep telefonu' → Teléfono (WhatsApp), 'الاسم', 'Nom complet' o 'Nama' → Nombre, un encabezado que coincide con un campo personalizado → ese campo). Junto a una columna de nombre, se toma un 'Nom' o 'Name' como apellido; junto a una columna de apellido, 'Nome' o 'Nombre' es el nombre de pila. Establecer columnas que no necesitas No importar. Ejemplo muestra un valor del archivo. Cuando una columna configurada como No importar se parece a números de teléfono o direcciones de correo electrónico (y no hay ninguna otra columna asignada a ellas), una línea amarilla debajo lo indica, por ejemplo Esta columna parece números de teléfono, pero está configurada como "No importar", por lo que no serán importados. Elige "Teléfono (WhatsApp)" para importarlos.
4. En Opciones:

• País para los números locales: los números escritos sin código de país ('07400 123456', o '7400 123456' cuando Excel eliminó el cero) se leen como números de este país. Los dígitos árabes (٠٥٠...) están bien. Una columna de País en el archivo gana para su fila. Comienza como el país de tu empresa (sin ningún puesto se lee Elige un país, y solo se leen los números escritos con su código de país); la lista tiene todos los países, nombrados en tu idioma, en orden alfabético bajo Todos los países (el país en el que indica tu navegador, cuando lo dice, aparece primero en Sugerido).
• 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): hasta 10 etiquetas, de hasta 50 caracteres cada una (se ignora un # inicial). Si hay más, aparece Add at most 10 extra tags. Remove some, or add them later with Add tags. bajo el cuadro, y con una etiqueta más larga A tag can be at most 50 characters. Shorten it, or split it with a comma.; Continuar espera hasta que el cuadro sea correcto.

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. Un contacto tiene como máximo 20 etiquetas: cuando algunas personas superarían ese límite, la comprobación lo dice, por ejemplo 3 contacts would pass the limit of 20 tags. They keep their tags and get this import's own tag; the other new tags are added only while there is room. Un archivo creado con Exportar CSV se importa tal cual: se quita el apóstrofo delante de un número como '+447400123456.
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). Un archivo subido que dejaste antes de importar (en Columnas, Consentimiento o después de Revisar el archivo) aparece en Importaciones recientes como Sin terminar, con Continuar (vuelve a donde lo dejaste) y Descartar. Descartar pregunta "¿Descartar el archivo subido "(archivo)"? No se importó nada de él. Se eliminan sus filas y el archivo guardado." y lo quita de la lista. Los archivos subidos que quedan sin terminar durante 7 días se descartan automáticamente; en ningún caso cambia nada en Contactos.
10. Cuando veas Importación finalizada., pulsa Ver contactos importados para ver la lista, o Descargar errors.csv (mostrado, con Las filas que no se importaron, con el motivo, en las columnas originales del archivo., solo cuando algunas filas no fueron importadas). En los totales, Todos los que esta importación creó o actualizó están en la lista "Importar – customers.csv – 2026-09-24" (n personas). nombra la lista que la importación hizo; Abrir la lista y la abres en Contactos → Audiencias (ver 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ñadir una fila de cabecera. El archivo tiene nombres de columnas pero no filas de personas. → el archivo tiene una fila de cabecera y nada debajo (o solo filas vacías); añade una fila por persona bajo los nombres de las columnas y súbelo de nuevo. El archivo está vacío. significa que no se encontró nada en el archivo.
• El archivo tiene más de 100.000 filas o El archivo es mayor de 20 MB → dividirlo. El segundo mensaje también aparece para un archivo pequeño pero que contiene millones de celdas llenas una vez abierto.
• El archivo tiene más de 200 columnas. → elimina las columnas que no necesites. Un valor escrito muy a la derecha, incluso en una columna vacía, cuenta; las celdas vacías no.
• 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 la razón: No es un número de teléfono válido (revisa el código de país) (marca 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, Huso horario desconocido, Un valor de campo personalizado no encaja con el campo (el campo se nombra en detalle: debe ser una opción de elección, una fecha YYYY-MM-DD o día/mes/año, solo cifras numéricas), 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 propias columnas del archivo, así que puedes corregir las filas e importarlas como un archivo nuevo. Viene en el idioma en el que usas la app: sus primeras cuatro columnas (fila, estado, motivo, detalle), el estado de cada fila y la razón están en ese idioma.
• 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. Rellenar Nombre (hasta 120 caracteres) y al menos uno de 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. El País comienza como el país de tu empresa (Configuración → Empresa) y lista todos los países nombrados en tu idioma; sin ninguno activado dice Elige un país. Los dígitos tecleandos en un teclado árabe (٠٥٥...) se convierten en 0-9 en Teléfono (WhatsApp) mientras escribes, de modo que el número se lee de izquierda a derecha en su orden habitual.
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 [nombre]. y se abre el contacto.
5. Esta persona ya está en Contactos. → el número o correo electrónico pertenece a alguien; pulsa Abrir el contacto. Cuando un cuadro es el problema, la razón aparece en rojo debajo de esa casilla, la casilla se vuelve roja y el cursor se mueve hacia ella. Por ejemploEse no es un número de teléfono válido para el país elegido. Introduce un número local de ese país, o el número completo que empieza por + y el código de país. en Teléfono (WhatsApp) (sin País elegido: Ese no es un número de teléfono válido. Comprueba los dígitos después del + y el código de país, o elige el País abajo e introduce un número local.), Elige la plataforma del usuario. en Plataforma (siempre que se escriba un usuario, incluso con teléfono o correo electrónico), El consentimiento de WhatsApp o SMS necesita un número de teléfono. Introduce el número o desmarca WhatsApp y SMS. en Teléfono (WhatsApp) El consentimiento para correo electrónico requiere una dirección de correo electrónico. Introduce la dirección o desmarca Correo electrónico. o Escribe una dirección de correo electrónico como nombre@ejemplo.com. bajo Correo electrónico, o Indica cómo dio su consentimiento la persona (al menos 3 caracteres). en ¿Cómo dio su consentimiento? Cada motivo está en tu idioma. Arrégjalo y pulsa Añadir contacto de nuevo. Aparece un mensaje sobre el formulario completo (Indica un número de teléfono, un correo electrónico o un usuario.

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 ('nombre', 'teléfono', 'correo', 'handle' + 'plataforma', 'país', 'tags', 'notes', 'atributos', 'consentimiento: {channels, evidence}'); 409 devuelve el 'contactId' existente. Importaciones: 'POST .../contacts/imports' (archivo multiparte), 'GET .../contacts/imports/{id}', 'PATCH' '{mapping, options}', 'POST .../validate', 'POST .../run', 'POST .../cancel', 'GET .../errors.csv?lang=ar' ('lang': en, ar, fr, es, pt, de, tr, id, hi or your). El 'GET' de una importación terminada devuelve 'audience' ('id', 'name', 'memberCount') — la lista anterior.

Relacionado

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