📥Importar contactos

Aprende cómo preparar y subir tu archivo de contactos, entiende los requisitos de formato de número de teléfono, mapea las columnas del archivo a variables de plantilla y resuelve errores comunes de i

Los contactos se cargan a una campaña subiendo un archivo CSV o XLSX. Cada fila del archivo se convierte en un destinatario de la campaña — un contacto que recibirá el mensaje de plantilla.

---

Tipos de archivo soportados

Formato	Extensión	Tamaño máximo
Valores separados por comas	.csv	5 MB
Libro de Excel	.xlsx	5 MB

---

Columnas requeridas y opcionales

Columna	Requerida	Descripción
phone_number	✅ Sí	El número de WhatsApp del destinatario.
name	Recomendada	Se usa para personalizar mensajes y se muestra en la pestaña Conversations.
Cualquier otra columna	Opcional	Datos adicionales que quieras mapear a variables de plantilla o de conversación.

💡 Tip: Haz clic en Download template en el paso de carga para obtener un CSV con los encabezados correctos pre-completados.

---

Formato del número de teléfono

Los números de teléfono deben estar en formato E.164: un signo + seguido del código de país y el número completo, sin espacios, guiones ni paréntesis.

✅ Válido	❌ Inválido
[phone]	3001234567
[phone]	[phone]
[phone]	07911 123456

Las filas con números de teléfono inválidos o irreconocibles se rechazan en el momento de la importación y se cuentan como rows_invalid en el resumen de importación. No recibirán mensajes.

---

Qué ocurre durante la importación

Cuando subes un archivo, Dapta lo procesa fila por fila:

1. Valida cada número de teléfono contra las reglas E.164 usando la zona horaria de la campaña como indicador de país.

2. Deduplica — si un número de teléfono ya existe en esta campaña, la fila se omite silenciosamente (contada como rows_duplicate).

3. Inserta los contactos válidos y nuevos como destinatarios pendientes (contados como rows_inserted).

4. Rechaza las filas inválidas con un código de error estructurado (contadas como rows_invalid).

Después del procesamiento se muestra un resumen de importación:

Campo	Descripción
Rows received	Total de filas en el archivo.
Rows inserted	Nuevos contactos agregados a la campaña.
Rows duplicate	Números de teléfono ya existentes en la campaña — omitidos.
Rows invalid	Filas rechazadas por errores de validación de teléfono.

---

Agregar contactos después de crear la campaña

Puedes subir contactos adicionales a una campaña que ya está en ejecución o programada. Navega a la página de detalle de la campaña, ve a Settings y usa el área de carga para agregar un nuevo archivo. Los nuevos contactos se agregan; los números de teléfono existentes se omiten automáticamente.

---

Solución de problemas

Problema	Solución
Todas las filas son rows_invalid	Verifica que la columna phone_number exista y que los valores usen formato E.164 con el prefijo +.
Algunas filas son rows_duplicate	Esos números de teléfono ya fueron importados en una carga anterior. Es el comportamiento esperado — no se requiere ninguna acción.
El menú de plantillas está vacío	El canal seleccionado no tiene plantillas de WhatsApp aprobadas. Aprueba una plantilla en Meta Business Manager primero.
El resumen muestra 0 filas insertadas	El archivo puede estar vacío, tener solo encabezados, o todas las filas pueden ser duplicadas o inválidas.
La carga del archivo falla	Confirma que el archivo sea .csv o .xlsx y que pese menos de 5 MB.