Fallos en el envío de mensajes activos: Dónde encontrarlos y qué significan – Blip | Blip Help

¿Qué son los fallos en el envío?

Los fallos en el envío de mensajes activos son errores que impiden que una comunicación iniciada por una empresa (como envíos de campañas o notificaciones) llegue al destinatario.

Un fallo en el envío ocurre cuando Blip intenta realizar el envío de ese mensaje al usuario final, pero la entrega es negada o impedida por algún error técnico, error en la construcción de la solicitud (API) o por bloqueos relacionados con las políticas de uso del canal WhatsApp.

Antes de comenzar

La verificación de fallos debe realizarse directamente en el bot conectado al canal WhatsApp.
Si tu contacto inteligente utiliza la arquitectura de routers y sub-bots, la verificación debe hacerse en el router, pues es allí donde tu canal WhatsApp estará conectado.

¿Dónde encuentro los fallos en el envío?

Actualmente, existen dos maneras principales de identificar el motivo del fallo en el envío de un mensaje activo:

A través del dashboard de mensajes activos en el módulo de Análisis;
A través del informe de campaña en Growth;

En ambos enfoques descritos a continuación, la verificación debe realizarse directamente en el bot conectado al canal WhatsApp.

Vale la pena recordar: si tu contacto inteligente utiliza la arquitectura de routers y sub-bots, la verificación debe hacerse en el router, pues es allí donde tu canal WhatsApp estará conectado

A través del dashboard de mensajes activos en el módulo de Análisis:

1. Accede al portal;
2. Luego, accede al bot conectado al canal WhatsApp;
3. Selecciona la pestaña “Análisis”;
4. Dentro de Análisis, haz clic en el dashboard "Mensajes Activos".
5. Filtra por el período o fecha deseada;
6. O busca por el nombre de la plantilla cuyas fallas deseas investigar;
7. Al final del informe, existe una sección específica con el detalle de los errores, “Fallos en el envío”, donde puedes observar los fallos por el período o plantilla deseada:

En esta sección encontrarás información importante sobre los envíos que fallaron basada en las columnas existentes. A continuación detallamos cada una de ellas:

Código: Muestra el código técnico del fallo. Puedes consultar este código directamente en la documentación oficial de Meta (o en herramientas de búsqueda) para identificar la causa exacta del bloqueo;
Descripción del error: Complementa la columna anterior, explicando de forma sucinta qué significa el código de error;
Ocurrencias: Indica el volumen total de mensajes que fallaron debido a este mismo error, de acuerdo con el período o plantilla filtrada.

A través del informe de campaña en Growth:

1. En tu bot conectado a WhatsApp, selecciona la pestaña ‘Growth’;

2. Selecciona ‘Mensajes Activos;’

3. Luego haz clic en ‘Resumen de envíos’;

(Opcional) Es posible filtrar por:

Canal deseado (en caso de que no utilices solo WhatsApp);
Tipo de mensaje (programadas o no programadas);
Tipo de campaña (individual o masiva).

Si no seleccionas ninguna de las opciones, se mostrarán todas.

5. (Opcional) Es posible buscar por nombre de campaña. Si no usas el campo de búsqueda, se mostrarán todas las campañas.

6. Localiza la campaña/envío deseado y selecciona, en la columna Acciones, los 3 puntitos;

7. Selecciona ‘Descargar informe’:

Descargarás un archivo .csv que contiene las siguientes columnas:

Fecha
ID de la campaña
Nombre de la campaña
Modelo de mensaje
Enviado por
Canal
Identidad del contacto
Teléfono del contacto
Estado del mensaje
Enviado
Recibido
Leído
Fallo
Código de fallo
Descripción del fallo
Dirección de respuesta
Código de error
Grupo del error
Mensaje de error
Descripción del error

Para verificar si un mensaje falló, analiza las columnas Estado del Mensaje y Fallo.

Para analizar el motivo del fallo, revisa las columnas Código de fallo, Descripción del fallo, Código de error, Mensaje de error y Descripción del error.

¿Qué significan los errores presentados en el informe?

Durante el procesamiento de campañas y envíos, los errores pueden originarse en dos frentes distintos: en la propia plataforma Blip o directamente en el proveedor del canal (Meta).

A continuación, detallamos los posibles retornos y códigos de fallo que pueden presentarse en tus informes, categorizados por sus respectivas fuentes:

Errores generados por la plataforma Blip:

Código	Mensaje	Detalle
38	Max Command throughput rate reached - blocked until. Your limit is 200 per second.	El contacto inteligente alcanzó el límite máximo de comandos/solicitudes por segundo (Rate Limit). La plataforma bloquea temporalmente los envíos excedentes para proteger la infraestructura.
N/A	NOT_PROCESSED	El mensaje no llegó a ser procesado por el sistema de mensajería de Blip. Generalmente asociado a payload JSON en formato inválido, fallos de enrutamiento jerárquico en el bot o indisponibilidad momentánea del servicio.

Errores generados por META:

Código	Mensaje (Meta API)	Detalle
0	Authentication error	No fue posible autenticar al usuario. El token expiró, es inválido o el acceso fue bloqueado.
1	General Error	Ocurrió un error general. Posible error de servidor o solicitud inválida.
2	Service Unavailable	Ocurrió un error de tiempo de espera. Servicio temporalmente fuera de línea o sobrecargado.
3	Capability or Permission Issue	La aplicación no tiene permiso para realizar esta acción.
4	Rate limit hit	La aplicación alcanzó el límite de tasa de llamadas API (Rate Limit).
10	Permission denied	El permiso para esta acción no fue concedido o fue removido de la aplicación.
33	Phone number deleted	El número de teléfono comercial proporcionado fue eliminado o no es válido.
38	Authorization Max Throughput Rate Reached	Se alcanzó la tasa máxima de transferencia de mensajes del bot.
51	Dispatch Error	Error general de envío, el canal de destino no está disponible.
81	Gateway error	Error general en el procesamiento del gateway, incluyendo errores de la API del canal.
86	Gateway operation timed out	La operación en el proveedor/gateway presentó timeout.
100	Invalid parameter	La solicitud incluyó parámetros incompatibles, ausentes o con error tipográfico.
190	Access token has expired	El token de acceso de la aplicación ha perdido validez.
200-299	Permission error	Permiso no concedido, revocado o el token no fue enviado en la solicitud.
368	Account restricted	La cuenta de WhatsApp (WABA) fue restringida/desactivada por violar políticas de Meta.
429	Too Many Requests	Se excedió el límite volumétrico de solicitudes a la API.
1013	User not found	El usuario destino no es válido para esta integración o el perfil no puede ser alcanzado.
1505	Invalid recipient for channel	El número de teléfono no tiene una cuenta activa de WhatsApp.
1601	General broadcast processing error	Error genérico ocurrido durante el procesamiento de una transmisión de campaña.
1602	Recipient in attendance	Mensaje bloqueado porque el cliente ya está en atención humana activa en la plataforma Blip.
3304	Spam rate limit hit	La cuenta excedió el límite de envíos debido a una alta tasa de denuncias de spam recientes.
80007	Rate limit reached	La cuenta de WhatsApp Business alcanzó su límite total de volumen.
130403	Message undeliverable	La empresa fue bloqueada por el usuario final directamente en WhatsApp.
130429	Rate limit hit	Se alcanzó la tasa de transferencia de la Cloud API.
130472	User's number is part of an experiment	Aproximadamente el 1% de los usuarios no recibirán plantillas de marketing debido a un experimento de Meta iniciado el 14/06/2024. El mensaje se retiene temporalmente.
130497	Country restricted	La WABA no tiene permiso para enviar mensajes a usuarios de este país.
131000	Something went wrong	Fallo interno desconocido, error de firma o en el endpoint GraphQL.
131005	Access denied	La aplicación no tiene los permisos adecuados para ejecutar esta acción.
131008	Required parameter is missing	Falta información crucial/obligatoria en el payload de la solicitud.
131009	Parameter value is not valid	Uno o más valores en la solicitud no son aceptados o válidos.
131016	Service unavailable	Algún servicio interno de WhatsApp está temporalmente fuera de línea.
131021	Sender and recipient are the same	Intento de enviar una notificación activa al mismo número comercial remitente.
131026	Message Undeliverable	Respuesta de Meta indicando que el mensaje no pudo ser entregado. Causa común: número incorrecto o inactivo. Otras: cliente bloqueó la empresa, no aceptó los Términos de Servicio o usa app desactualizada.
131031	Account has been locked	La WABA fue restringida o falló en verificaciones obligatorias (ej: PIN incorrecto).
131037	Business phone number not approved	El número de prueba (555) utilizado no tiene un nombre de exhibición validado.
131042	Payment issue	Ocurrió un error con el método de pago/línea de crédito en el Administrador.
131043	Outside allowed window	Intento de envío de mensaje de texto libre o medios fuera de la ventana de 24 horas de atención.
131045	Incorrect certificate	Fallo en la entrega causado por una anomalía en el registro del número de teléfono.
131047	Re-engagement message	Han pasado más de 24 horas desde la última interacción libre del cliente.
131049	This message was not delivered to maintain healthy ecosystem engagement.	Meta identificó unilateralmente que el mensaje puede no estar enganchando a los usuarios como se espera, aplicando un bloqueo automático para preservar la calidad de las interacciones.
131050	Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business	Blip envió la solicitud correctamente, pero el contacto señaló en la configuración de "Ofertas y anuncios" de la aplicación que desea detener los mensajes de marketing.
131051	Unsupported message type	El formato enviado en el mensaje activo (ej: archivo específico) no es compatible.
131052	Media download error	El sistema no pudo descargar el medio recibido por el usuario en la conversación.
131053	Media upload error	Fallo al cargar el medio enviado vía solicitud. Formato no soportado.
131055	Method not allowed	Intento de enviar plantilla de utilidad/autenticación a través de la API de Marketing.
131056	Too many messages sent	Exceso de mensajes enviados al mismo destinatario en un intervalo muy corto.
131057	Account in maintenance mode	La cuenta de WhatsApp Business está pasando por procesos de mantenimiento interno.
131061	Template not approved	Intento de enviar una plantilla que aún está con estado "Pendiente" o "Rechazada".
131063	Marketing messages disabled	La plantilla es de marketing, pero los envíos de este tipo están desactivados en la Cloud API.
131064	Template quality limit reached	La cuenta sufrió restricciones en el volumen de envíos por uso de plantillas de baja calidad.
132000	Template parameter count mismatch	La cantidad de variables en la solicitud no coincide con lo requerido por la plantilla.
132001	Template does not exist	Plantilla inexistente, no aprobada, o hay divergencia en el idioma solicitado.
132005	Template hydrated text too long	El texto final tras la sustitución de variables excede el límite impuesto por Meta.
132007	Template policy violation	El contenido formateado en la plantilla viola las políticas de comercio y mensajes de Meta.
132012	Template parameter format mismatch	El formato de las variables enviadas es inválido y no coincide con la configuración.
132015	Template paused due to low quality	Plantilla interrumpida temporalmente por generar muchas denuncias o bloqueos.
132016	Template disabled	La plantilla fue desactivada definitivamente tras pausas múltiples por denuncias.
132018	Template validation error	Problema detectado en los parámetros durante el uso de la API de Mensajes de Marketing.
132068	Flow blocked	El WhatsApp Flow en cuestión fue bloqueado por la plataforma.
132069	Flow limited	Exceso de mensajes enviados usando este mismo flujo en la última hora.
133000	Incomplete deregistration	Un intento previo de cancelar el registro de este número en el canal WhatsApp falló.
133004	Server temporarily unavailable	Fallo momentáneo en las llamadas a los servidores principales de WhatsApp.
133005	Two-step verification PIN incorrect	El PIN de dos pasos enviado en el proceso de activación/solicitud es inválido.
133006	Phone number needs to be verified	El número aún no tiene la propiedad confirmada y debe ser validado.
133008	Too many two-step verification PIN guesses	Se hicieron intentos sucesivos incorrectos al tratar de activar el PIN del número.
133009	Two-step verification PIN guessed too fast	El proceso de validación sufrió disparos excesivos en corto tiempo.
133010	Phone number not registered	La línea ingresada no está oficialmente registrada en WhatsApp Business.
133011	Phone number restricted	El número remitente fue baneado o severamente restringido por Meta por violaciones.
133015	Wait before registering	La línea comercial fue eliminada recientemente y el proceso de eliminación aún está en trámite.
133016	Registration limit reached	Se agotó el límite estricto para registros o eliminaciones de cuenta en un intervalo breve.
133017	Invalid configuration	Problema con la configuración del sistema, frecuentemente en la clave del perfil de negocios.
134011	Payment terms pending	Falló porque los Términos de Servicio de Pagos no fueron aceptados en la WABA.
134100	Only marketing messages supported	La API de Marketing fue utilizada para enviar plantillas utilitarias o de autenticación.
134101	Template still syncing	La plantilla o anuncio aún está en su ciclo interno de sincronización.
134102	Template unavailable for use	La plantilla recientemente validada no pudo completar la sincronización, o la WABA no está calificada.
135000	Generic user error	Fallo de formato que causa un error desconocido en la construcción de parámetros.
1752041	Duplicate Request	Intento de incorporación duplicado (ya ocurrió vía otro proveedor o socio).
2388012	Phone number already exists	La línea que intentas migrar ya forma parte de la lista de esta cuenta comercial de WhatsApp.
2388019	Template limit exceeded	La WABA alcanzó su cuota límite de plantillas nativas (máx. 250 modelos).
2388039	Cannot change template status	Intento de editar/eliminar un modelo de mensaje que aún está en revisión previa.
2388040	Character limit exceeded	El contenido en uno de los campos de la plantilla (botón, texto, etc.) violó el margen de seguridad.
2388047	Message header format incorrect	La construcción técnica del encabezado viola reglas o envía saltos indebidos.
2388072	Message body format incorrect	El cuerpo principal presentó saltos o tipos de variables fuera del estándar requerido.
2388073	Message footer format incorrect	El bloque final de pie de página muestra contenidos bloqueados o con extrapolación técnica.
2388091	Phone not eligible	Uso incorrecto de APIs orientadas a la migración, pero el número no corresponde al escenario.
2388293	Word to parameter ratio exceeds limit	La plantilla tiene un exceso de campos variables para casi ningún texto fijo (contexto).
2388299	Starting or ending parameters not allowed	Parámetros dinámicos insertados bruscamente al inicio o al final de la frase del modelo.
2494100	Account in maintenance mode	Los recursos para esta línea comercial no están respondiendo (mantenimiento provisional).
2593085	Invalid WABA for OBO Mobility	El usuario ya activó el compartimiento en la WABA (WABA sharing) y OBO ya no funciona.
2593107	Sync request limit exceeded	Se hicieron intentos reincidentes de invocar la API de sincronización de contactos.
2593108	Sync request outside allowed window	La activación del endpoint superó el plazo obligatorio de 24 horas desde el Onboarding.
200005	Template insights unavailable	La extracción analítica de este panel de WhatsApp no está soportada/disponible en esta cuenta.
200006	Cannot disable template insights	Se envió una operación intentando deshabilitar las estadísticas, lo cual está prohibido en la plataforma.
200007	Template insights not enabled	La herramienta que extrae métricas visuales avanzadas de Meta está desactivada en esta WABA.

Estado "Éxito" y "Fallo" simultáneos: En casos raros, el estado recibido puede ser éxito y fallo. Si esto sucede, puedes considerar que el mensaje fue entregado con éxito. Esto ocurre porque el usuario está conectado con WhatsApp en dos dispositivos, entonces uno recibió el mensaje con éxito y el otro no. Lee más sobre estas particularidades en el artículo de Meta.

Estado PROCESADO: Este retorno significa que el envío fue realizado con éxito por parte de Blip y el estado de ‘entregado’, ‘recibido’ o ‘leído’, no fue actualizado por Meta basado en el usuario final.

Error no listado: En caso de que recibas un error que no fue mencionado en este artículo, por favor contacta al soporte de Blip.

Documentación Oficial: Consulta las documentaciones oficiales listadas como Mensajes de error y estados y Códigos de error de la API de Nube para obtener más información detallada.

¿Necesitas más ayuda? Explora nuestros contenidos en la Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃