Importar muchos contactos de una vez (MASIVO)

POST https://api.getkivly.com/api/v1/contact-lists/{list_id}/contacts/bulk

¿Qué hace esto?

✨ Importa cientos o miles de contactos en una sola operación. ¡Súper rápido!

¿Cuándo usarlo?

• Para importar tu base de datos existente desde Excel/CSV
• Para migrar contactos desde otra plataforma (MailChimp, Sendinblue, etc.)
• Para añadir muchos contactos a la vez

¿Cómo funciona?

1. Preparas un array (lista) con todos tus contactos
2. Envías todo de una vez
3. El sistema los valida y crea uno por uno
4. Recibes un reporte: cuántos se crearon ✅ y cuántos fallaron ❌

📊 Capacidad

• Recomendado: Hasta 1,000 contactos por request
• Máximo: 5,000 contactos (pero se demora más)
• Si tienes más: Divide en lotes de 1,000

Manejo de Errores

Si un contacto tiene un error (ej: email inválido), el sistema:

• ❌ Salta ese contacto y registra el error
• ✅ Continúa creando los demás
• 📊 Te da un reporte completo al final

Ejemplo de Flujo

Envías 100 contactos:
- 95 se crean correctamente ✅
- 5 tienen errores ❌ (emails duplicados o inválidos)

Recibes:
{
  "successful": 95,
  "failed": 5,
  "errors": [
    {"contact": "Juan", "email": "invalido", "error": "Email inválido"},
    ...
  ]
}