¿Por qué algunos mensajes de WhatsApp no se entregan?

Cuando se envía un mensaje utilizando plantillas aprobadas por Meta a través de WhatsApp desde Sagicc, puede ocurrir que el mensaje no llegue al destinatario. En la mayoría de los casos, esto se debe a validaciones automáticas, políticas de calidad y controles de entrega aplicados directamente por Meta antes de permitir que el mensaje sea distribuido al usuario final. Estas validaciones forman parte de las reglas oficiales de la API de WhatsApp Business Platform y están completamente fuera del control de Sagicc como plataforma de experiencia al cliente.

Es importante tener en cuenta que Sagicc actúa como intermediario técnico para el envío, pero la decisión final de entrega siempre depende de los sistemas y políticas de Meta. A continuación, se detallan las categorías de error más comúnmente reportadas por la API de WhatsApp Business Platform, junto con sus posibles causas y recomendaciones de solución.

Mensajes de error más comunes

Error 131026 – Message Undeliverable

• Descripción: Meta no pudo entregar el mensaje al destinatario.

• Posibles Causas:

  • El número de teléfono no está registrado en WhatsApp.

  • Se intenta enviar una plantilla de autenticación a un usuario con código de país +91 (India). Actualmente, este tipo de plantilla no está permitido en India.

  • El destinatario no ha aceptado los Términos de Servicio y la Política de Privacidad más recientes de WhatsApp.

  • El usuario utiliza una versión antigua de WhatsApp, inferior a:

    • Android: 2.21.15.15

    • iOS: 2.21.170.4

    • KaiOS: 2.2130.10

    • Web: 2.2132.6

• Soluciones o Alternativas:

  • Contactar al cliente por un canal alternativo (llamada, SMS, correo electrónico, etc.).

  • Solicitar al cliente que confirme que puede enviar un mensaje al número de WhatsApp de la empresa.

  • Verificar que haya aceptado los últimos Términos y Políticas de la aplicación de WhatsApp (Configuración > Ayuda o Información de la aplicación).

  • Pedirle que actualice la aplicación de WhatsApp a la versión más reciente.

Error 130472 – User’s number is part of an experiment

• Descripción: El número del usuario forma parte de un experimento activo de Meta.

• Posibles Causas: Periódicamente, Meta realiza experimentos controlados sobre un porcentaje reducido de usuarios para evaluar el impacto y la calidad de los mensajes de marketing. Si el número pertenece a uno de estos experimentos, es posible que el mensaje no sea enviado. En caso de no enviarse, el mensaje no será cobrado. Estos experimentos no tienen una fecha de finalización fija.

• Soluciones o Alternativas:

  • Intentar el envío nuevamente más adelante si el caso lo requiere.

  • Contactar al cliente por un canal alternativo y solicitarle que envíe un mensaje a la empresa para abrir una ventana de conversación.

  • Enviar una plantilla de categoría “Utility” en lugar de una de “Marketing”, ya que la restricción aplica únicamente a esta última categoría.

Error 131049 – Message not delivered by Meta

• Descripción: Meta decidió no entregar el mensaje para mantener la calidad del ecosistema. Este error suele estar relacionado con los límites de envío de plantillas de marketing por usuario.

• Posibles Causas: Meta aplica restricciones dinámicas para evitar la sobreexposición de mensajes promocionales a un mismo usuario. Si se supera el límite permitido, el mensaje puede ser bloqueado temporalmente. Esto se rige por la política oficial de Límite de Mensajes de Plantillas de Marketing por Usuario.

• Soluciones o Alternativas:

  • Una vez fallido, no reintentar el envío inmediatamente.

  • Reintentar progresivamente en intervalos de tiempo mayores.

  • Revisar la frecuencia de envíos de marketing a ese contacto.

  • Optimizar la segmentación para evitar impactar repetidamente a los mismos usuarios.

  • Enviar una plantilla de categoría “Utility” en lugar de “Marketing”, ya que la restricción aplica únicamente a esta última categoría.

Buenas prácticas recomendadas por Meta

Para reducir la probabilidad de fallos en la entrega:

• Mantener una base de datos de clientes y contactos limpia y validada.

• Enviar mensajes únicamente a usuarios que hayan otorgado consentimiento (opt-in).

• Evitar envíos repetitivos o excesivos.

• Supervisar las métricas de calidad del número en WhatsApp Manager.

• Utilizar plantillas aprobadas y correctamente categorizadas (Marketing, Utility, Authentication).

Consideraciones adicionales en Sagicc

• Si el envío se realiza mediante un proceso de Mensajería Masiva, el error puede afectar solo a algunos contactos, no necesariamente a todos.

• Los errores reportados no dependen de la infraestructura de Sagicc, sino de validaciones realizadas directamente por Meta a través de la API oficial de WhatsApp Business Platform.

• Se recomienda revisar el detalle del error en el log del mensaje para identificar el código exacto antes de tomar acciones.