Your AI Connector Docs

Importar contactos desde un archivo

Si tiene una lista de contactos en una hoja de cálculo, puede subirlos todos a la vez en lugar de añadirlos uno por uno. La aplicación utiliza un asistente de 3 pasos — Subir → Asignar columnas → Revisar — que funciona con el archivo CSV que ya tiene, sin necesidad de descargar una plantilla primero.

Cómo importar contactos

  1. Haz clic en Contactos en la barra lateral izquierda, luego haz clic en Importar en la parte superior de la página.
  2. Cargar. Arrastra tu archivo CSV a la zona de carga o haz clic en ella para buscarlo. No hay ninguna plantilla que descargar primero: utiliza el archivo que ya tienes.
  1. Asignar columnas. El asistente lee la fila de encabezado de su archivo e intenta hacer coincidir automáticamente cada columna con un campo de destino: Nombre, Apellidos, Teléfono, Correo electrónico, Etiquetas, Notas, cualquiera de sus campos personalizados o No importar. Compruebe la estimación de cada columna y corrija las que sean incorrectas mediante el selector situado junto a ella. Una tabla de vista previa muestra las primeras filas exactamente tal y como se importarán.
    • Una columna cuyo encabezado sea el nombre de uno de sus campos personalizados se asigna a ese campo automáticamente. Las mayúsculas y los acentos no importan, por lo que una columna CPF encuentra un campo llamado cpf. También puede elegir manualmente cualquier campo personalizado para cualquier columna.
    • Una columna que aún no sea uno de sus campos personalizados puede convertirse en uno: elija Nuevo campo personalizado: en su selector y el campo se creará al importar.
    • Si un campo personalizado tiene un tipo (Número, Casilla de verificación, Menú desplegable) y algunos de los valores de la columna no encajan, el asistente le advertirá de cuántas filas afecta antes de importar. Esas filas se omiten por completo, incluidos el nombre y el correo electrónico. Haga clic en Cambiar a Texto en la advertencia para cambiar el tipo de campo en un solo paso, o corrija los valores, o establezca la columna en No importar.
    • Es obligatorio incluir una columna de número de teléfono; no podrá continuar sin asignar una.
    • Una columna asignada a Etiquetas se convierte en etiquetas reales en cada contacto. Varias etiquetas en una misma celda no suponen un problema: sepárelas con una coma o un punto y coma (vip; newsletter; hotmart). Las etiquetas que aún no existen se crearán para usted; las que ya existen se reutilizarán, ignorando las mayúsculas.
  1. Revisar. Elija:
    • Canal predeterminado — WhatsApp Business, WhatsApp Web o SMS. Esto se aplica a cualquier contacto importado que no especifique ya un canal.
    • Lista — seleccione una lista existente del menú desplegable o escriba un nombre para crear una nueva al instante. Solo puede hacer una cosa o la otra, no ambas. Si abre la importación mientras la página de Contactos muestra una de sus listas, esa lista ya estará seleccionada para usted; bórrela si no la desea.
    • Actualizar contactos existentes — desactivado de forma predeterminada. Si está desactivado, las filas que coincidan con un contacto que ya tiene (mismo número de teléfono) se omitirán como duplicados: nada en ese contacto cambia, aunque si seleccionó una lista, el contacto que ya tiene se unirá a ella. Si está activado, esas filas actualizan el contacto: el nombre, el correo electrónico y las notas en su archivo sobrescriben lo que hay allí (las celdas vacías dejan el valor actual intacto), se añaden las etiquetas de la fila y el contacto se añade a la lista que seleccionó. Así es como se vuelve a importar un archivo para corregir o enriquecer los contactos que ya tiene.
  1. Haga clic en Importar [count]. Llegará a una pantalla de resultados que muestra cuántos contactos se crearon, cuántos contactos existentes se actualizaron (cuando esa opción está activada), cuántos contactos que ya tenía se añadieron a la lista que eligió y, si se omitió alguna fila, un desglose del motivo (número de teléfono no válido, falta de número de teléfono, duplicado, límite de contactos alcanzado, etc.). Si la opción Actualizar contactos existentes estaba desactivada y algunas filas coincidían con contactos que ya tiene, la pantalla de resultados lo indicará y ofrecerá Actualizar estos contactos: un solo clic vuelve a enviar solo esas filas con el interruptor activado, por lo que no tiene que volver a importar el archivo.

Detalles de la asignación de columnas

  • Teléfono es la única columna obligatoria. Las filas sin número de teléfono se descartan antes de la importación y se cuentan por separado en la pantalla de resultados.
  • Nombre / Apellidos / Correo electrónico se asignan directamente a los campos básicos del contacto.
  • Notas se asigna al campo Notas / Perfil del cliente potencial del contacto.
  • Etiquetas crea (o reutiliza) etiquetas reales y las aplica al contacto: las mismas etiquetas con las que filtra, con las que segmenta envíos y desde las que activa webhooks. Ponga varias en una celda separadas por comas o puntos y coma. Antes del 19 de agosto de 2026, esta columna se guardaba como un campo personalizado llamado tags; si importó antes de esa fecha, vuelva a importar el mismo archivo con Actualizar contactos existentes activado y las etiquetas se aplicarán correctamente (el campo personalizado tags sobrante no causa ningún daño; contacte con soporte si desea que se elimine de todos los contactos).
  • Campos personalizados: cada uno de sus campos personalizados es su propio destino. Un encabezado que coincida con el nombre de un campo se selecciona automáticamente para usted; el valor se guarda en el contacto exactamente como está en el archivo (un campo de Número, Fecha, Casilla de verificación o Menú desplegable convierte formas reconocibles como 19,99, 01/02/1990 o yes). Elija Nuevo campo personalizado para crear un campo a partir de una columna. Con Actualizar contactos existentes activado, los valores de los campos personalizados en el archivo también actualizan los contactos que ya tiene; las celdas vacías dejan el valor actual tal como está.
  • Una columna que contiene identificadores con puntos, guiones o ceros iniciales (un CPF, un número de identificación fiscal, un código postal) pertenece a un campo de Texto. En un campo de Número, esos valores no encajan y la fila se omite.

Consejos

  • Verifique dos veces que los números de teléfono incluyan el código de país. Sin él, los mensajes no se entregarán, y las filas sin un número de teléfono utilizable se omitirán por completo.
  • No necesita eliminar espacios, guiones o paréntesis de los números de teléfono; el importador tolera el formato común, pero aún necesita el código de país.
  • Los archivos se analizan completamente en su navegador, por lo que no hay un límite de tamaño de carga fijo desde el asistente en sí, pero su recuento total de contactos sigue estando limitado por su plan. Si una importación lo supera, esas filas se rechazan y aparecen en la pantalla de resultados como contact_limit_reached.
  • Si ya existe un contacto con el mismo número de teléfono, esa fila se omite de forma predeterminada; aparece como duplicate en la pantalla de resultados. La importación nunca crea una segunda copia de alguien. Seleccionar una lista sigue funcionando en esas filas: el contacto que ya tiene se añade a la lista y se cuenta por separado en la pantalla de resultados, por lo que volver a importar el mismo archivo es la forma de llenar una lista con personas que ya están en su cuenta. Para actualizar también sus campos (corregir nombres o correos electrónicos, añadir etiquetas), active Actualizar contactos existentes en el paso de Revisión y vuelva a importar el archivo.

Preguntas frecuentes

Mi CSV tiene una columna custom_company de una exportación antigua: ¿se asignará correctamente? No por sí sola, porque el encabezado no es exactamente company. Elija Campo personalizado: company en el selector de esa columna y se importará al campo company. Cambiar el nombre del encabezado a company antes de subirlo hará que el asistente lo haga coincidir por usted.

Se omitieron algunas filas con el mensaje “Un valor de campo personalizado no encaja con el tipo de ese campo”: ¿por qué? La columna está asignada a un campo personalizado con tipo (por ejemplo, Número) y esas filas contienen otra cosa, como 001.576.401-08 en un campo de Número. Haga clic en Cambiar a Texto en la advertencia del paso Asignar columnas (o cambie el tipo en Campos personalizados) e importe el archivo de nuevo con Actualizar contactos existentes activado.

¿A dónde ha ido el botón “Descargar plantilla”? Ha desaparecido; el asistente funciona directamente con cualquier CSV que ya tengas y te permite corregir cualquier columna que no coincida en el paso de Asignación.

Ya importé mis contactos, ¿cómo añado etiquetas o corrijo campos para todos ellos a la vez? Vuelva a importar el mismo archivo (o uno actualizado) con la opción Actualizar contactos existentes activada en el paso de Revisión. Las filas que coincidan con un número de teléfono existente actualizarán ese contacto (nombre, correo electrónico, notas, etiquetas y lista) en lugar de omitirse. Solo se utilizan los números de teléfono para realizar la coincidencia, así que mantenga esa columna exactamente como estaba.

¿Puedo importar contactos de Instagram o Messenger desde un archivo? No. La importación solo es compatible con WhatsApp Business, WhatsApp Web y SMS, ya que esos canales llegan a las personas a través de su número de teléfono. Por el contrario, Instagram y Messenger identifican a las personas mediante su cuenta social, por lo que esos contactos se crean automáticamente cuando alguien le envía un mensaje a través de ese canal.

¿Puedo importar contactos como inactivos para el bot? No hay una columna por fila para ello. Importa el lote primero y, a continuación, utiliza la acción masiva Bot desactivado en los contactos importados; consulta Exclusión de contactos del bot de IA.

Próximos pasos