# 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. 3. **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. 4. **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. 5. 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](custom-contact-fields.md#notes-lead-profile) 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_` de la versión clásica); consulte [Carga masiva de campos personalizados](custom-contact-fields.md#bulk-loading-custom-fields) 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](custom-contact-fields.md) 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](excluding-contacts-from-bot.md). --- ## Próximos pasos - [Organización de listas y contactos](list-and-contact-management.md) — gestione y ordene sus contactos recién importados. - [Migración de campañas a difusiones y agentes](../moving-from-campaigns.md) — comience a enviar mensajes a su lista importada. - [Campos personalizados, perfil de cliente potencial y notas](custom-contact-fields.md) — complete detalles más completos después de la importación.