Importar Contactos por Excel o CSV

📊

CRMInbox · Audiencias — Excel y CSV

Aprende a subir listas masivas desde hojas de cálculo, mapear columnas requeridas y asociar variables dinámicas para personalizar tus llamadas de voz.

💡 Flexibilidad total: La importación por archivo es el método más rápido para lanzar campañas con bases de datos externas de cualquier procedencia. Admite formatos .xlsx, .xls y .csv con hasta 10,000 registros por carga.

🎯 Objetivo

Cargar correctamente un archivo de contactos a una campaña de voz, mapear automáticamente los campos obligatorios de teléfono y nombre, y configurar columnas adicionales como variables dinámicas (como saldos, servicios o fechas) para que el agente de voz las mencione durante la llamada.

✅ Requisitos del archivo

📄

Fila de encabezados: La primera fila del archivo debe incluir obligatoriamente los nombres de las columnas (ej. Nombre, Numero, Deuda).

📞

Formato internacional E.164: Los teléfonos deben incluir código de país (ej. +529986374476) para garantizar que la llamada salga sin errores de marcación.

⚖️

Límite de tamaño: Archivos de hasta 10,000 filas por campaña.

⚠️ Depuración automática: El motor de CRMInbox valida cada número. Las filas que contengan números vacíos, incompletos o teléfonos duplicados serán excluidas automáticamente de la campaña para no cobrar llamadas fallidas.

Procedimiento

Pasos para cargar y mapear tu archivo

1

Seleccionar el Origen CSV o Excel

En el asistente de la campaña, haz clic sobre la opción de archivo para desplegar el cargador de hojas de cálculo.

Ruta: Crear Campaña → 2. Selección de contactos → CSV o Excel

Al entrar a la fase 2. Selección de contactos:

Haz clic en la primera tarjeta: CSV o Excel (Sube un archivo. Las columnas extra se vuelven variables).
Observarás la sección 1. ARCHIVO con el área de carga punteada y las especificaciones del archivo.

Pantalla de selección de contactos con tarjeta CSV o Excel y sección 1 Archivo

✅ Resultado esperado: Aparecerá el área de arrastre de archivos con el botón Elegir archivo.

2

Subir el Archivo desde tu Equipo

Selecciona el archivo Excel o CSV guardado en tu computadora para que CRMInbox lo procese.

Puedes arrastrar el archivo directamente desde tu carpeta sobre la zona punteada o hacer clic en Elegir archivo para abrir el explorador de archivos de tu sistema operativo y seleccionar tu archivo (ej. Contactos.csv).

Ventana de explorador de archivos seleccionando el archivo Contactos.csv

✅ Resultado esperado: El archivo comenzará a subirse y en un segundo se mostrarán sus propiedades.

3

Verificar Lectura y Mapeo Automático de Columnas

Comprueba que el archivo se haya leído correctamente y que los campos requeridos estén asignados.

El sistema confirmará la lectura exitosa mostrando:

✅ Contactos.csv (0.1 KB · 3 filas encontradas) — con botones Elegir archivo y Quitar.

En la sección 2. COLUMNAS, el algoritmo detecta y mapea en automático:

Columna del archivo Numero → Tipo de dato: Teléfono (Obligatorio).
Columna del archivo Nombre → Tipo de dato: Nombre del contacto.

Archivo Contactos.csv cargado y sección 2 Columnas con mapeo automático de Número y Nombre

✅ Resultado esperado: Los campos obligatorios de teléfono y nombre quedarán asociados sin intervención manual.

4

Añadir Columnas Extras como Variables del Prompt

Convierte datos como adeudos, servicios o fechas en variables que el agente de voz pronunciará con naturalidad durante la llamada.

Si tu archivo contiene columnas adicionales (como deudas, planes o fechas de corte), puedes convertirlas en variables dinámicas para el agente de IA:

1. Añadir campo: Haz clic en el botón azul + Añadir campo.

2. Seleccionar columna: En el primer desplegable elige la columna del archivo (ej. Deuda).

3. Elegir variable: En el segundo desplegable selecciona la variable del prompt correspondiente (ej. {{balance}}).

💡 ¿Falta una variable en la lista? Haz clic en el enlace "Créala en Variables y vuelve a cargar esta página" para darla de alta en tu CRM.

Botón Añadir campo y selección de la columna Deuda del archivo

Desplegable de Variables para el prompt seleccionando la variable {{balance}}

✅ Resultado esperado: La columna adicional quedará vinculada y lista para ser usada en el prompt del bot.

5

Revisión, Validación de Números y Guardado

Inspecciona la tabla de validación de teléfonos y confirma la audiencia para avanzar a la programación.

En la sección 3. REVISIÓN dispones de una auditoría completa antes de confirmar:

Total de filas: 3

✔ Teléfonos válidos: 3

La tabla previa te muestra en tiempo real cómo se importará cada fila:

Estado: Insignia verde Válido con palomita.
Teléfono: Normalizado con código de país (ej. +529986374476).
Nombre: Nombre del titular (ej. Raziel, Karlos con K, Manuel).
Variables mapeadas: Los valores numéricos o de texto reales (ej. {{balance}}: 150, 10000, 9999999).

Tabla de revisión con 3 teléfonos válidos, estado verde y valores mapeados de la variable balance

✅ Resultado esperado: Al hacer clic en Guardar y siguiente ➜, la lista de contactos quedará guardada y avanzarás al paso 3 (Programación).

🧾 Estructura recomendada para tu plantilla Excel/CSV

Prepara tu archivo con esta estructura de columnas para que el sistema lo reconozca al instante:

Nombre	Numero	Deuda	Servicio
Juan Pérez	+529981234567	450.00	Internet 100 Megas
María Gómez	+529987654321	600.00	Fibra 200 Megas

🧭 Preguntas frecuentes

¿Qué pasa si mis teléfonos no tienen el signo '+' al inicio?

El sistema intentará interpretarlo, pero te recomendamos encarecidamente incluir el prefijo internacional con '+' (ej. +52) en tu archivo Excel para evitar que se interprete como número local o con formato erróneo.

¿Puedo actualizar los contactos subiendo otro archivo más adelante?

Sí. Si la campaña sigue en estado borrador, al subir un archivo nuevo se reemplazará la lista anterior. Si ya hubo llamadas emitidas, los contactos que ya fueron llamados conservarán su historial.

¿Cómo pronuncia el agente las variables numéricas como la deuda?

El motor de voz con IA lee automáticamente los números en formato monetario legible (por ejemplo, '450.00' lo pronunciará como 'cuatrocientos cincuenta pesos').

¿Qué formato de archivo es el más confiable entre CSV y Excel?

Tanto .xlsx como .csv funcionan perfectamente. Si usas CSV, asegúrate de guardarlo con codificación UTF-8 para que las tildes y nombres con 'ñ' se importen correctamente.

Documentación relacionada y otros orígenes

📞 Guía Base: Cómo Crear Campañas de Voz en CRMInbox→ 🌐 Añadir contactos desde WispHub (Clientes y Cobranza)→ 📡 Añadir contactos desde MikroWisp (Clientes y Cobranza)→ 🔌 Añadir contactos mediante API Externa (REST)→ 🧭 Comparativa de los 5 Orígenes de Campañas de Voz→

SIGUIENTE: IMPORTAR DESDE WISPHUB ➜