Análisis de errores de envío de mensajes whatsapp (plantillas y texto)

General
1

1. CONTEXTO GENERAL

En el envío masivo de mensajes mediante WhatsApp (tanto plantillas como mensajes de texto), se presenta un comportamiento inconsistente:

  • Algunos usuarios reciben correctamente los mensajes

  • Otros usuarios no los reciben

  • En algunos casos falla incluso enviando texto plano

Esto indica que el problema no es único ni completamente técnico, sino que depende de múltiples factores, principalmente del lado de Meta y del estado del usuario receptor.

2. ERRORES IDENTIFICADOS

2.1 ERROR 131009 – PARAMETER VALUE IS NOT VALID (PHONE NUMBER MALFORMED)

Descripción
El número telefónico enviado no cumple con el formato esperado por WhatsApp.

Causa principal

  • Formato incorrecto del número

  • Presencia de caracteres inválidos (espacios, guiones, paréntesis, símbolos)

  • Prefijo mal estructurado

  • Datos sucios provenientes de CRM o Excel

Ejemplos

  • Correcto: 5491123456789

  • Incorrecto: +54 9 11 2345-6789

  • Incorrecto: (54) 9 11 2345 6789

Impacto

  • Falla únicamente en ciertos usuarios

  • Comportamiento inconsistente en envíos masivos

Solución

  • Validar que el número contenga solo dígitos

  • Usar formato internacional sin símbolos

  • Limpiar datos antes de enviar

  • Validar longitud (10 a 15 dígitos)

2.2 ERROR 131047 – RE-ENGAGEMENT MESSAGE

Descripción
El mensaje se envía fuera de la ventana de 24 horas sin usar correctamente una plantilla.

Causa principal

  • Sesión de conversación cerrada

  • Mensaje enviado como texto plano en lugar de template

  • Estructura incorrecta en la API

Importante
Aunque el contenido sea de una plantilla aprobada, si se envía como “type”: “text”, WhatsApp lo rechaza.

Solución

  • Usar “type”: “template”

  • Enviar name y language exactos

  • Asegurar que los parámetros coincidan con la plantilla aprobada

2.3 ERROR 131049 – MESSAGE NOT DELIVERED (HEALTHY ECOSYSTEM)

Descripción
Meta bloquea el mensaje para mantener una interacción saludable en el ecosistema.

Causa principal

  • El usuario ha recibido demasiados mensajes de marketing

  • Bajo nivel de interacción del usuario

  • Límites dinámicos por usuario (no solo por empresa)

Características

  • Aplica específicamente a plantillas de marketing

  • El límite es global (incluye otras empresas)

  • Puede variar día a día

Impacto

  • Mensajes se envían correctamente desde el sistema pero no se entregan

  • Comportamiento inconsistente (a veces llega, a veces no)

Solución

  • No reenviar inmediatamente

  • Esperar entre 12 y 48 horas

  • Reducir frecuencia de campañas

  • Priorizar usuarios con interacción reciente

  • Usar plantillas de utilidad cuando sea posible

2.4 ERROR 131026 – MESSAGE UNDELIVERABLE

Descripción
Meta rechaza el mensaje antes de la entrega.

Posibles causas

  • Número inválido o no registrado

  • Usuario bloqueó la cuenta

  • Usuario no aceptó condiciones

  • Límite de mensajes alcanzado

  • Aplicación desactualizada

Análisis importante
Cuando el error es intermitente:

  • No suele ser número inválido

  • No suele ser problema técnico fijo

Interpretación
Indica una restricción parcial del usuario, donde:

  • Algunos mensajes pasan

  • Otros son bloqueados

Causa más probable

  • Bajo engagement del usuario

  • Señales negativas (ignorar mensajes, no interactuar)

2.5 ERROR 130472 – USER’S NUMBER IS PART OF EXPERIMENT

Descripción
El usuario forma parte de un experimento de Meta que restringe mensajes de marketing.

Causa principal

  • Meta limita mensajes a ciertos usuarios para evaluar impacto en la experiencia

Condiciones
El usuario no recibirá mensajes de marketing a menos que:

  • Exista una ventana de 24 horas abierta

  • El usuario haya iniciado la conversación

Características

  • No es error técnico

  • No depende de la plantilla

  • No depende del formato

  • No se puede evitar

Impacto

  • El mensaje no se entrega

  • No se cobra el envío

  • Reintentos generan el mismo error

Solución

  • Esperar

  • Contactar al usuario por otro canal

  • Solicitar que el usuario inicie conversación

3. CONCLUSIÓN GENERAL

El comportamiento inconsistente en el envío de mensajes (a veces se entregan y a veces no) no es un problema único ni completamente técnico.

Se debe a una combinación de:

  • Validación de datos (números telefónicos)

  • Uso correcto de la API (estructura de templates)

  • Restricciones dinámicas de Meta

  • Límites por usuario

  • Nivel de interacción del usuario

Punto clave:

Cuando los errores son intermitentes, la causa principal suele ser la lógica de entrega de Meta basada en el comportamiento del usuario, no fallas del sistema.

4. CONTROL DEL SISTEMA

4.1 Elementos bajo control

  • Formato correcto del número telefónico

  • Uso correcto de templates

  • Estructura de la API

  • Frecuencia de envío

  • Tipo de contenido enviado

  • Segmentación de usuarios

4.2 Elementos fuera de control

  • Límites por usuario definidos por Meta

  • Experimentos activos (como error 130472)

  • Decisión final de entrega

  • Nivel de interacción del usuario

  • Saturación del usuario con mensajes de otras empresas

5. RECOMENDACIONES GENERALES

  • Validar y limpiar números antes del envío

  • No reenviar mensajes inmediatamente tras un fallo

  • Reducir envíos masivos agresivos

  • Priorizar usuarios activos

  • Diseñar mensajes que generen respuesta

  • Aprovechar ventanas de conversación abiertas

  • Alternar entre plantillas de marketing y utilidad