Importar contactos

CX Inbox permite importar contactos desde archivos CSV para crear listas de destinatarios en tus campañas de WhatsApp.

Formato del archivo CSV

El archivo CSV debe cumplir con los siguientes requisitos:

Requisito	Detalle
Formato	CSV (valores separados por comas)
Codificación	UTF-8 (para soportar caracteres especiales y acentos)
Columna obligatoria	Teléfono con código de país, sin el signo `+`
Columnas opcionales	Nombre y cualquier variable requerida por la plantilla
Primera fila	Encabezados de columna

Formato del teléfono

El número de teléfono debe incluir el código de país y contener solo dígitos, sin el signo +, sin espacios ni guiones:

Formato	Ejemplo	Válido
Con código de país, solo dígitos	`5215512345678`	Si
Con signo +	`+5215512345678`	No
Con espacios	`52 1 55 1234 5678`	No
Sin código de país	`5512345678`	No

Ejemplo de CSV

A continuación un ejemplo de archivo CSV válido para una plantilla que usa las variables nombre y producto:

telefono,nombre,producto
5215512345678,María García,Internet 100 Mbps
5215587654321,Carlos López,Internet 200 Mbps
5214491234567,Ana Martínez,Fibra Empresarial

Y un ejemplo mínimo solo con teléfonos:

telefono
5215512345678
5215587654321
5214491234567

Los nombres de las columnas pueden ser cualquier texto descriptivo. Lo importante es el mapeo que harás en el siguiente paso al crear la campaña.

Cómo importar

La importación de contactos se realiza dentro del flujo de creación de una campaña:

Ve a Campañas en el menú principal
Haz clic en + Nueva campaña
Selecciona la plantilla de WhatsApp que deseas enviar
En la sección de destinatarios, selecciona Importar CSV
Arrastra tu archivo CSV o haz clic para seleccionarlo
CX Inbox lee el archivo y muestra una vista previa de los datos

Mapeo de campos

Después de cargar el CSV, debes mapear las columnas del archivo a las variables de la plantilla:

CX Inbox muestra las columnas detectadas en tu CSV
Para cada variable de la plantilla (ej: {{1}}, {{2}}), selecciona la columna correspondiente del CSV
La columna de teléfono se detecta automáticamente si se llama telefono, phone o numero
Verifica que el mapeo sea correcto en la vista previa

Por ejemplo, si tu plantilla tiene el texto Hola {{1}}, tu plan {{2}} está listo, mapearías:

Variable de plantilla	Columna del CSV
`{{1}}`	`nombre`
`{{2}}`	`producto`

Validación

CX Inbox valida los datos antes de permitir el envío de la campaña:

Validación	Qué verifica
Teléfono requerido	Cada fila debe tener un número de teléfono
Formato de teléfono	Solo dígitos, con código de país
Variables completas	Todas las variables de la plantilla deben tener un valor
Duplicados	Números de teléfono repetidos se detectan

Los registros con errores se muestran en un resumen para que puedas corregir el CSV y volver a cargarlo.

Si tu CSV tiene filas con errores, esas filas no se incluirán en la campaña. Corrige el archivo original y vuelve a importarlo para asegurar que todos los contactos sean incluidos.

Límites de importación

La cantidad máxima de contactos por importación depende del plan de tu organización:

Plan	Contactos por campaña
Starter	Hasta 1,000
Professional	Hasta 10,000
Enterprise	Hasta 50,000

Si el CSV contiene números de teléfono repetidos, CX Inbox los detecta durante la validación. Solo se incluye una entrada por número de teléfono para evitar enviar el mismo mensaje varias veces al mismo contacto.

Consejos para preparar tu CSV

Usa un editor de hojas de cálculo (Google Sheets, Excel, LibreOffice Calc) para preparar los datos y luego exporta como CSV
Verifica la codificación UTF-8 si tu archivo contiene acentos o caracteres especiales: en Excel, al guardar selecciona "CSV UTF-8"
Valida los teléfonos antes de importar: asegúrate de que todos tengan el código de país
Limpia los datos eliminando filas vacías, espacios extra y caracteres no numéricos en la columna de teléfono
Haz una prueba pequeña primero: importa un CSV con 5-10 contactos de prueba para verificar que el mapeo y la plantilla funcionen correctamente

¿Esta página fue útil?