Una campaña masiva de WhatsApp programada en Waclis Inbox se detiene inesperadamente, cambia a estado "Pausada por el sistema" o reporta mensajes fallidos. Esta guía explica cómo descargar e interpretar el reporte de errores en CSV, corregir variables y reanudar el envío de forma segura.
Síntoma y Significado
Síntoma
En el módulo de Campañas, el progreso del envío masivo se congela y la etiqueta de estado cambia a "Pausada por el sistema" o muestra advertencias con conteo de envíos fallidos.
Significado técnico
El motor de campañas de Waclis Inbox aplica mecanismos automáticos de protección de reputación. Si detecta que una de las líneas vinculadas se desconectó, que se alcanzó el límite de tasa de envío de Meta Cloud API, que la lista contiene números telefónicos mal formateados o que faltan variables requeridas por la plantilla de mensaje, pausa el proceso para evitar rebotes acumulados y sanciones.
Comprobación rápida y Causas
Comprobación rápida
- En el listado de campañas, abre la campaña afectada y haz clic en Exportar reporte de errores (CSV).
- Revisa en la columna de fallos los códigos de error más frecuentes (
INVALID_PHONE_FORMAT,PARAMETER_COUNT_MISMATCH,RATE_LIMIT_EXCEEDED).
Causas principales
- Variables de plantilla incorrectas o ausentes: La plantilla de WhatsApp exige variables dinámicas (
{{1}},{{2}}) y la lista de contactos importada no contenía esos campos o estaban en blanco. - Números telefónicos mal formateados: Contactos sin código de país internacional (E.164) o con caracteres no numéricos.
- Límite de tasa de envío o cupo de Meta Cloud API: Se alcanzó el límite de mensajes por segundo o el nivel de cuota diaria del número.
- Desconexión de una línea de WhatsApp QR: Una de las líneas del grupo de rotación perdió la sesión multidispositivo.
Solución paso a paso
Paso 1: Descargar e interpretar el reporte de errores en CSV
- En la barra lateral, abre el módulo Campañas.
- Haz clic sobre la campaña detenida para ver su panel de detalle.
- Haz clic en el botón Exportar reporte de errores (CSV) disponible en el resumen.
- Abre el archivo CSV descargado y filtra por la columna
error_codepara identificar los registros específicos que causaron el bloqueo.
Paso 2: Corregir variables de plantilla y números en la lista
- Si el error indica variables faltantes, verifica en el Administrador de Plantillas cuántos parámetros requiere el cuerpo del mensaje.
- Asegúrate de que las columnas del archivo de contactos mapeen exactamente cada variable (
{{1}} = Nombre,{{2}} = Monto). - Corrige los números que carezcan de prefijo de país internacional (ej. convertir
0981...a+595981...).
Paso 3: Reanudar la campaña
- En el panel de la campaña en Waclis Inbox, haz clic en el botón Reanudar campaña.
- El sistema continuará el despacho exactamente desde el último contacto procesado con éxito, sin reenviar a los destinatarios que ya recibieron el mensaje.
Prevención y Datos para soporte
Prevención
- Valida y depura tus bases de contactos antes de iniciar difusiones masivas.
- Utiliza siempre Spintax y pausas de envío para distribuir el flujo de mensajes de forma equilibrada entre tus líneas.
Datos a recopilar si el fallo persiste
- Identificador de la campaña (
campaign_id). - Archivo CSV de errores descargado del panel.
- Nombre interno de la plantilla de WhatsApp utilizada.
Comprobación
Presiona "Reanudar campaña" tras verificar los parámetros y confirma que el contador de mensajes despachados comience a avanzar de manera progresiva.
Límites y buenas prácticas
El restablecimiento del cupo diario de mensajes en WhatsApp Oficial depende del ciclo de facturación y cuota de Meta, el cual se renueva de acuerdo con los límites oficiales de la plataforma.
Artículos relacionados
¿Necesitas más ayuda?
Si este artículo no resolvió tu consulta, nuestro equipo puede ayudarte personalmente.
Soporte por WhatsApp