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 asignar automáticamente cada columna a un campo de destino: Nombre, Apellido, Teléfono, Correo electrónico, Etiquetas, Notas o No importar. Compruebe la sugerencia de cada columna y corrija las que sean incorrectas usando el selector que aparece junto a ellas. Una tabla de vista previa muestra las primeras filas exactamente como se importarán.
    • Es obligatorio incluir una columna de número de teléfono; no puede continuar sin asignar una.
    • Una columna asignada a Etiquetas se convierte en etiquetas reales en cada contacto. Puede incluir varias etiquetas en una misma celda; sepárelas con una coma o un punto y coma (vip; newsletter; hotmart). Las etiquetas que aún no existen se crearán automáticamente; las que ya existen se reutilizarán, sin distinguir entre mayúsculas y minú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: elija una lista existente del menú desplegable o escriba un nombre para crear una nueva al instante. Solo puede hacer una de las dos cosas, no ambas.
    • 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: no se cambiará nada en ese contacto y no se añadirá a la lista. Si está activado, esas filas actualizarán el contacto: el nombre, el correo electrónico y las notas de su archivo sobrescribirán lo que ya existe (las celdas vacías dejan el valor actual intacto), se añadirán todas las etiquetas de la fila y el contacto se añadirá a la lista que haya elegido. Así es como se vuelve a importar un archivo para corregir o enriquecer los contactos que ya tiene.
  1. Haga clic en Importar [count]. Accederá a una pantalla de resultados que muestra cuántos contactos se crearon, cuántos contactos existentes se actualizaron (cuando esa opción está activada) y, si se omitió alguna fila, un desglose del motivo (número de teléfono no válido, número de teléfono faltante, duplicado, límite de contactos alcanzado, etc.).

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 / Apellido / 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 que utiliza para filtrar, dirigir difusiones y activar webhooks. Ponga varias en una misma 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 realizó una importación antes de esa fecha, vuelva a importar el mismo archivo con la opción Actualizar contactos existentes activada y las etiquetas se aplicarán correctamente (el campo personalizado tags sobrante no causa ningún daño; contacte con el soporte técnico si desea que se elimine de todos los contactos).
  • Actualmente no existe una asignación de columnas para campos personalizados arbitrarios (como las columnas custom_<fieldname> de la versión clásica); consulte Carga masiva de campos personalizados para conocer la solución alternativa actual.

Consejos

  • Asegúrese de 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 es necesario eliminar espacios, guiones o paréntesis de los números de teléfono; el importador admite el formato común, pero sigue necesitando 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 por parte del asistente, pero el número total de contactos sigue estando limitado por su plan. Si una importación le hiciera superar el límite de su plan, esas filas se rechazarán y aparecerán 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 una persona. Para editar de forma masiva los contactos que ya tiene (corregir nombres o correos electrónicos, añadir etiquetas, ponerlos en una lista), 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 automáticamente. El buscador automático del asistente solo reconoce los encabezados de nombre/teléfono/correo electrónico/etiquetas/notas; cualquier otra cosa se asigna por defecto a No importar, por lo que una columna custom_company no rellenará el campo personalizado company por sí sola. Añade los valores después a través de Campos personalizados o mediante la API.

¿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