🔄 Convertir MUCHOS contactos en clientes Kivly (MASIVO)

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

🚀 CONVERSIÓN MASIVA - FUNCIONALIDAD ESPECIAL

¿Qué hace esto?

Convierte decenas, cientos o miles de contactos en clientes completos de Kivly de una sola vez.

🎯 Casos de Uso Perfectos

1. Lanzamiento de Programa de Lealtad

Tienes 500 clientes frecuentes en tu lista y quieres que todos tengan acceso al programa de puntos desde el día 1.

2. Migración desde Otra Plataforma

Vienes de usar otra herramienta (MailChimp, Sendinblue) y quieres que todos tus contactos sean clientes Kivly.

3. Promoción Especial

Quieres dar acceso VIP a todos los contactos de una lista específica.

¿Qué reciben TODOS los contactos convertidos?

• ⭐ Cuenta en el programa de puntos (loyalty_points = 0, listo para acumular)
• 💳 Tarjeta digital para Google Wallet y Apple Wallet
• 📧 Email de bienvenida explicando cómo usar el programa
• 🏷️ Todos sus tags originales se mantienen
• 📱 Acceso a la app móvil de clientes

⚡ Rendimiento

• Procesamiento: ~10-15 contactos por segundo
• 100 contactos: ~7-10 segundos
• 1,000 contactos: ~1-2 minutos
• 5,000+ contactos: Divide en lotes de 1,000

📊 Reporte Detallado

Al finalizar recibirás:

• ✅ Número de conversiones exitosas
• ❌ Número de fallos (con razones específicas)
• 📋 Lista de errores para que puedas corregir

💡 Mejores Prácticas

1. Horario: Hazlo en horario de baja actividad (madrugada)
2. Emails válidos: Verifica que los emails sean correctos antes
3. Lotes: Si tienes >2,000 contactos, divide en lotes
4. Comunicación: Avisa a tus clientes que ahora tienen programa de puntos
5. Backup: Exporta tu lista antes por seguridad

⚠️ Restricciones

• No se pueden convertir contactos que ya son clientes (email duplicado)
• Necesitas un plan Kivly activo
• Se generan wallet passes (cuenta para tu límite mensual)