Importar contactos masivamente

¿Cuándo usar la importación masiva?

La importación masiva es ideal cuando tienes una base de contactos existente en otro sistema (Excel, Google Sheets, tu ERP, sistema de cobranza) y necesitas llevarla a CIFRA 360 de una sola vez.

Para sincronizaciones continuas y automatizadas, te recomendamos usar la API REST en lugar de importaciones manuales.

Preparar tu archivo CSV

Antes de subir el archivo, prepáralo correctamente para evitar errores en el proceso de importación.

Campos soportados

CIFRA acepta los siguientes campos en la importación:

• name (requerido) — Nombre completo o razón social
• phone (requerido) — Número con código de país (ej: +573001234567)
• email — Correo electrónico
• document_id — Cédula o NIT
• debt_amount — Monto de deuda en números (sin puntos ni comas)
• due_date — Fecha de vencimiento en formato YYYY-MM-DD
• tags — Etiquetas separadas por punto y coma (ej: mora-30;priority)
• pipeline — Nombre exacto del embudo donde agregar el contacto
• assigned_to — Email del agente responsable

Formato requerido

• Formato de archivo: CSV o XLSX
• Codificación: UTF-8 (para tildes y caracteres especiales)
• Separador: coma (,) o punto y coma (;)
• Primera fila: encabezados de columna
• Máximo: 50.000 contactos por importación

name,phone,email,debt_amount,due_date,tags
Juan Pérez,+573001234567,juan@email.com,450000,2026-02-15,mora-30
María López,+573009876543,maria@email.com,120000,2026-01-20,mora-60;priority
Carlos Ruiz,+573005555555,,890000,2025-12-01,mora-90

Subir el archivo

Ve a Contactos → Importar → Subir archivo. Arrastra tu archivo CSV/XLSX o haz clic para seleccionarlo. CIFRA mostrará una vista previa de las primeras 5 filas para que confirmes que el archivo se leyó correctamente.

Mapear los campos

Si los nombres de columnas de tu CSV no coinciden exactamente con los campos de CIFRA, usa la pantalla de mapeo para relacionarlos manualmente. Por ejemplo, si tu CSV tiene "Celular" puedes mapearlo al campo "phone" de CIFRA.

CIFRA reconoce automáticamente columnas con nombres comunes en español e inglés.

Revisar el resultado

Una vez procesada la importación verás un resumen con:

• ✅ Contactos importados exitosamente
• ⚠️ Contactos con advertencias (datos incompletos pero importados)
• ❌ Contactos con errores (no importados, con detalle del problema)

Puedes descargar el reporte de errores en CSV para corregir los registros fallidos e importarlos de nuevo.

Errores frecuentes

• "Número de teléfono inválido": Asegúrate de incluir el código de país (+57 para Colombia)
• "Contacto duplicado": CIFRA detecta duplicados por número de teléfono. Puedes elegir entre omitir o actualizar el registro existente
• "Caracteres especiales en campos": Asegura la codificación UTF-8 al guardar el CSV desde Excel
• "Fecha en formato incorrecto": Usa siempre YYYY-MM-DD (ej: 2026-03-15)