Diagnóstico: La campaña masiva de WhatsApp se detuvo, tiene envíos pendientes o registra fallos

• Categoría: Solución de problemas
• Disponibilidad: Disponible desde el plan Premium (incluido en Premium y Evolución)
• Tiempo estimado de resolución: 4 a 6 minutos
• Rol necesario: Administrador (o Agente con permiso Acceder a Campañas y envíos masivos)

Cuando programas o lanzas una difusión desde Campañas → WhatsApp, esperas que tus mensajes lleguen de forma segura a toda la audiencia seleccionada. Si al revisar el avance observas que la campaña quedó en estado En curso con decenas de envíos Pendientes que no avanzan, o que el contador de Fallidos comenzó a subir, necesitas distinguir de inmediato si se trata de una pausa protectora automática (como el freno fuera de Horario comercial o los intervalos de envío progresivo) o de un rechazo técnico del canal (WhatsApp Cloud API vs. WhatsApp mediante código QR Waha). En esta guía aprenderás a auditar el Reporte de Campaña, interpretar cada error por destinatario, descargar el archivo CSV de diagnóstico y corregir la causa raíz.

Cuadro de diagnóstico rápido (30 segundos)

Antes de comenzar (Requisitos previos verificables)

Para diagnosticar una campaña en curso o finalizada, asegúrate de contar con:

• Acceso al módulo Campañas: Rol de Administrador o un Rol personalizado que tenga activado el permiso Acceder a Campañas y envíos masivos.
• Identificar el tipo de bandeja utilizada: Recuerda que Waclis Inbox ejecuta dos motores de campaña de WhatsApp distintos según el canal elegido:

1. Campañas por WhatsApp Cloud API (Oficial de Meta): Envían una Plantilla de WhatsApp aprobada en Meta a una audiencia definida por etiquetas de contacto.
2. Campañas por WhatsApp mediante código QR (Waha / canales API): Envían texto libre con variables dinámicas ({{contact.name}}, {{nombre}}), variaciones Spintax ({Hola|Buen día}), archivos adjuntos de hasta 40 MB, intervalos aleatorios en segundos y rotación entre múltiples bandejas.

Paso 1: Cómo abrir y auditar el Reporte de Campaña

Nunca adivines qué pasó con una campaña mirando solo el listado general: Waclis Inbox cuenta con un panel forense en tiempo real para cada campaña.

1. En la barra lateral izquierda, ve a Campañas → WhatsApp.
2. Localiza tu campaña en la lista y haz clic en la acción para abrir su Reporte de campaña.

• Nota en tiempo real: Mientras la campaña está En curso o tiene envíos Pendientes > 0, esta pantalla actualiza sus contadores automáticamente cada 5 segundos sin que tengas que recargar la página.

1. Analiza los tres bloques de diagnóstico de la pantalla:

• Las 6 tarjetas superiores de métricas:

1. Total destinatarios: Cantidad total de contactos incluidos en las etiquetas de audiencia al iniciar el envío.
2. Enviados: Mensajes despachados por el servidor que aún esperan confirmación de recepción del teléfono destino.
3. Entregados: Mensajes que ya llegaron al dispositivo del cliente (doble tilde).
4. Leídos: Mensajes abiertos por el cliente (acompañados debajo por la barra de progreso Tasa de lectura).
5. Fallidos: Envíos rechazados que requieren tu revisión.
6. Pendientes: Destinatarios que siguen en la cola esperando su turno de salida.

• El panel de detalles de configuración: Muestra qué bandeja se usó (o si está Rotando entre N bandejas (X msj c/u)), el Intervalo entre mensajes configurado (ej. 25 s – 45 s (aleatorio)), si tiene activa la restricción Solo en horario comercial de la bandeja y las etiquetas de Audiencia.
• La tabla de destinatarios y el botón Descargar CSV:
• Haz clic en la pestaña Fallido (junto a Todos, Enviado, Entregado, Leído, Pendiente) o usa el buscador Buscar por nombre, teléfono o error....
• Observa la columna Detalle / Error en cada fila fallida: allí verás el motivo exacto devuelto por Meta o por el conector Waha.
• Haz clic en el botón Descargar CSV arriba a la derecha de la tabla para bajar el archivo reporte-campana-{id}.csv y trabajar sobre la lista de errores en Excel.

Árbol de diagnóstico según el escenario detectado

Escenario 1: La campaña tiene envíos en Pendientes y parece detenida (Pausa por Horario Comercial o Intervalos)

Si ves que Fallidos está en 0 (o muy bajo) pero hay decenas o cientos de contactos en la pestaña Pendiente que no salen:

1. Verifica la pausa automática por Horario comercial:

• Mira el panel de detalles del reporte: ¿dice Solo en horario comercial de la bandeja?
• Cuando marcas la casilla Enviar solo durante el horario comercial de la bandeja al crear la campaña, Waclis Inbox consulta en vivo el calendario configurado en Ajustes → Entradas → [Tu bandeja] → pestaña Horarios (incluyendo la hora de cierre diario, los fines de semana cerrados y el Agregar horario de almuerzo).
• Qué ocurre cuando llega la hora de cierre: Si tu horario comercial cierra a las 18:00 hs y a las 18:00 todavía quedaban 150 mensajes por salir, el sistema pausa automáticamente la cola para no enviar mensajes comerciales a las 11 de la noche. Al día hábil siguiente, en el minuto exacto en que abre tu horario comercial (por ejemplo, a las 09:00 hs), la campaña se reanuda sola hasta completar los 150 pendientes.
• Atención con multi-bandeja: Si activaste Rotar envío entre varias bandejas, todas las bandejas seleccionadas deben tener su horario comercial habilitado y encontrarse dentro de su franja activa.

1. Calcula el tiempo de los intervalos de envío progresivo (Bandejas QR Waha):

• En campañas por código QR, el sistema espera un tiempo aleatorio uniforme entre el Intervalo mínimo (segundos) y el Intervalo máximo (segundos) antes de despachar cada mensaje (por defecto entre 25 y 45 segundos, con un promedio de 35 segundos por contacto).
• Esto significa que enviar 100 mensajes toma aproximadamente 58 minutos. No es una falla ni una lentitud del servidor: es el escudo de seguridad que simula el ritmo de escritura humano para evitar que WhatsApp bloquee tu línea por comportamiento automatizado.

Escenario 2: Envíos Fallidos en una campaña de WhatsApp Cloud API (Oficial de Meta)

Si la campaña se lanzó a través de una bandeja oficial WHATSAPP CLOUD y observas errores en la pestaña Fallido, verifica estas cuatro causas en orden:

1. Tope diario alcanzado en Límite de mensajería de Meta:

• Ve a Ajustes → Entradas → [Tu bandeja WHATSAPP CLOUD] → pestaña Salud de la Cuenta.
• Revisa el indicador Límite de mensajería: las cuentas nuevas de Meta comienzan con un tope de 250 conversaciones iniciadas por la empresa cada 24 horas (y luego escalan a 1K, 10K, 100K e Ilimitados).
• Si tu campaña tenía 600 contactos y tu nivel en Meta es de 250, los primeros 250 saldrán como Entregados y los 350 restantes serán rechazados por Meta al superar tu cuota diaria.

1. Plantilla pausada o deshabilitada por Meta a mitad del envío:

• Ve a Ajustes → Plantillas Meta y pulsa Sincronizar plantillas.
• Si muchos destinatarios bloquearon el mensaje o lo reportaron al recibir los primeros envíos, Meta puede cambiar el estado de esa plantilla a Pausada (calidad baja) e impedir que siga saliendo al resto de la lista.

1. Variables vacías o enlaces rotos en los parámetros de la plantilla:

• Si tu plantilla incluye variables (por ejemplo {{1}} mapeada al nombre o a un atributo del contacto) y algunos contactos de tu etiqueta de audiencia tenían ese campo completamente vacío en su ficha, Meta rechaza el armado del mensaje para esos contactos puntuales.

1. Fallo en el método de pago de Meta Business Suite:

• Como cada mensaje de campaña (Marketing o Utilidad) en Cloud API consume saldo en Meta, si la tarjeta de crédito vinculada en Meta Business Suite alcanzó su límite o rechazó el cargo automático, Meta frena inmediatamente la entrega de plantillas con error de pago.

Escenario 3: Envíos Fallidos masivos en una campaña de WhatsApp mediante código QR (Waha)

Si la campaña corría sobre una o varias bandejas con etiqueta WAHA y los mensajes empezaron a caer en Fallido:

1. Desconexión de la sesión QR en la bandeja (o en una de las bandejas en rotación):

• Ve a Ajustes → Entradas, entra a la bandeja WAHA utilizada (y a cada una de las bandejas incluidas si activaste Rotar envío entre varias bandejas) y abre la pestaña Configuración de sesión.
• Si en Gestión de sesiones el estado pasó a Detenido o Fallido (porque el celular se quedó sin batería, perdió internet o WhatsApp cerró la sesión), haz clic en Recrear sesión y vuelve a vincular con Generar código QR o Generar código de emparejamiento.

1. Archivo adjunto superior a 40 MB o formato no admitido:

• El creador de campañas de WhatsApp QR admite un archivo adjunto opcional (imagen, video, audio, PDF, Word o Excel) de hasta 40 MB. Si el archivo está corrupto o excede la capacidad de recepción del teléfono destino, el envío fallará.

1. Sintaxis incompleta en bloques Spintax:

• Al redactar variaciones con la sintaxis {Opción 1|Opción 2|Opción 3}, verifica siempre con el botón Generar otro ejemplo antes de lanzar la campaña que no haya quedado ninguna llave { sin cerrar ni bloques sin el separador vertical |.

Escenario 4: Contactos individuales en Fallido por formato de número telefónico (+E.164)

Tanto en WhatsApp Oficial como en WhatsApp QR, si el 95 % de la campaña se entregó con éxito y solo un 5 % dio Fallido, la causa está en la ficha de esos contactos específicos:

1. En el Reporte de campaña, filtra por la pestaña Fallido y mira la columna Teléfono:

• Falta el signo + o el código de país (formato E.164): Si el teléfono dice 1144556677 o 0981123456 sin el prefijo internacional (+549..., +595..., +569..., +521...), WhatsApp no sabe a qué país enrutar el mensaje y lo rechaza.
• Es un teléfono fijo de línea o no tiene cuenta de WhatsApp activa: El número existe en la guía telefónica pero nunca fue registrado en WhatsApp.

1. Cómo reenviar solo a los fallidos corregidos:

• Pulsa Descargar CSV en el reporte de la campaña.
• Filtra en tu planilla las filas con estado failed, corrige los números de teléfono al formato +E.164, impórtalos nuevamente en Contactos → Importar asignándoles una etiqueta limpia (por ejemplo, reintento-campana-mayo) y lanza una campaña corta dirigida únicamente a esa etiqueta.

Tabla de blindaje: Configuración recomendada para campañas sin fallos ni bloqueos

Prevención y cómo combinarlo con otras funciones de Waclis Inbox

1. Prepara al Agente de IA Capitán y a tus Reglas antes de lanzar la campaña: Una campaña exitosa de 500 mensajes puede generar 150 respuestas en menos de una hora. Antes de programarla, asegúrate de que el Agente de IA Capitán tenga un escenario activo para responder las dudas sobre esa promoción, o crea una regla en Ajustes → Automatización que detecte las palabras clave de los botones de tu plantilla y asigne la conversación al equipo de ventas con prioridad Alta.
2. Crea tarjetas automáticas en el Tablero Kanban para los interesados: Combina las respuestas a tu campaña con la acción Crear elemento Kanban en Reglas de Automatización para que cada cliente que responda "Quiero la promo" aparezca automáticamente como una oportunidad en la columna Interesados Campaña de tu embudo comercial.
3. Usa Segmentos en Contactos para validar teléfonos antes de etiquetar: Antes de asignar la etiqueta de audiencia para una campaña, ve a Contactos → Filtrar contactos y añade la condición Número de teléfono → Contiene → + para asegurarte de etiquetar únicamente fichas que tengan teléfono internacional válido.

Relación con el ecosistema Waclis

• Diferencia y sinergia entre las Campañas de Waclis Inbox y Waclis Reach:
• El módulo Campañas propio de Waclis Inbox está diseñado para envíos puntuales de difusión (one-off) por WhatsApp, SMS o API hacia una etiqueta de contactos y para mensajes proactivos en el Chat en vivo de tu sitio web.
• Si necesitas ejecutar secuencias comerciales multietapa (por ejemplo: Día 1 enviar presentación → esperar 3 días → si no respondió, enviar caso de éxito → si respondió, detener automáticamente), la herramienta indicada del ecosistema es Waclis Reach. Waclis Reach utiliza tus bandejas conectadas en Waclis Inbox, inyecta en la ficha del contacto los atributos personalizados de campaña, y puede recibir eventos mediante Webhooks (Mensaje creado) cuando el contacto responde en Waclis Inbox para coordinar el seguimiento con tu vendedor.
• Waclis (Tienda Online / Catálogo): Si en tu campaña compartes el enlace a un producto o catálogo de tu tienda Waclis, recuerda usar siempre el dominio completo de tu tienda (evitando acortadores genéricos como bit.ly que Meta suele rechazar en plantillas oficiales).

Preguntas frecuentes (FAQ)

¿Por qué el contador de Leídos en mi campaña de WhatsApp es menor de lo que esperaba si los clientes me están respondiendo?

Porque el estado Leído (doble tilde azul) depende de la configuración de privacidad del teléfono de cada destinatario. Si un cliente tiene desactivadas las "Confirmaciones de lectura" en su propio WhatsApp personal, WhatsApp entrega el mensaje (figura como Entregado) pero no informa el evento de lectura aunque el cliente lo haya abierto.

¿Puedo editar el texto o la audiencia de una campaña de WhatsApp que ya empezó a enviarse?

Una vez que una campaña programada inició el despacho de mensajes o finalizó (completed), el registro queda bloqueado para preservar la integridad del Reporte de campaña. Si cometiste un error antes de que llegue la Hora programada de inicio, puedes eliminarla o reprogramarla desde Campañas → WhatsApp.

¿Qué pasa si tengo activado "Enviar solo durante el horario comercial" y mi bandeja no tiene configurado ningún horario comercial?

Al marcar la casilla Enviar solo durante el horario comercial de la bandeja en el formulario de creación de campaña, Waclis Inbox verifica que la bandeja seleccionada (o todas las bandejas elegidas en modo rotación) tengan encendido Habilitar horario de atención en Ajustes → Entradas → [Bandeja] → pestaña Horarios. Si alguna no lo tiene activo, el propio asistente te mostrará un aviso para que lo configures antes de programar.

Artículos relacionados

• Constructor visual de plantillas de WhatsApp Meta y buenas prácticas de aprobación: Constructor visual de Plantillas Meta: creación, variables, botones y aprobación
• Campañas masivas de WhatsApp con Spintax, rotación multi-inbox y reportes CSV: Campañas de difusión por WhatsApp, SMS y Chat Web: segmentación, Spintax, rotación multi-bandeja y reportes CSV
• Salud de la cuenta de WhatsApp Oficial, límites de mensajería de Meta, calificación de calidad y migración de bandejas (Migrar bandeja): Salud de la cuenta de WhatsApp Oficial, límites de mensajería de Meta, calificación de calidad y migración de bandejas (Migrar bandeja)
• Diagnóstico: Sesión de WhatsApp por código QR desconectada repentinamente: Diagnóstico: Sesión de WhatsApp por código QR desconectada repentinamente