¿Por qué aparece “Message undeliverable” al enviar un mensaje por WhatsApp desde Vixiees?

Creado por Joan Sánchez, Modificado el Jue, 18 Sep a 4:36 P. M. por Joan Sánchez

¿Por qué aparece “Message undeliverable” al enviar un mensaje por WhatsApp desde Vixiees?

Si al enviar un mensaje de WhatsApp desde Vixiees aparece el aviso “Message undeliverable”, significa que WhatsApp no pudo entregar el mensaje al usuario final. Este error puede deberse a diversas causas, tanto relacionadas con el usuario como con la configuración de tu cuenta o mensaje.

Causas comunes del error “Message undeliverable”

Estas son las razones más frecuentes por las que WhatsApp puede marcar un mensaje como no entregable:

Número no registrado en WhatsApp o con versión antigua: El teléfono de destino no tiene una cuenta activa o utiliza una versión de WhatsApp que no es compatible con la API (caso común en versiones desactualizadas o modificadas).
El usuario bloqueó a tu empresa: No es posible enviar mensajes a usuarios que te han bloqueado.
Falta de consentimiento (opt-in): WhatsApp requiere que los usuarios acepten recibir mensajes de empresas.
Mensaje enviado fuera de la ventana de 24h: Si el cliente no respondió dentro de las últimas 24 horas, solo se pueden enviar plantillas previamente aprobadas.
Error en la plantilla: La plantilla puede no estar aprobada, tener errores de formato o no coincidir con el idioma del usuario.
Formato del número incorrecto: Asegúrate de usar el formato internacional E.164 (por ejemplo: +34600111222).
Problemas con tu cuenta de WhatsApp Business: La cuenta puede estar sin verificar, restringida o suspendida temporalmente.

Cómo verificar o resolver el problema

Aquí te dejamos pasos prácticos para diagnosticar y resolver el error:

Revisa los códigos de error devueltos por la API:
- 131026: El destinatario no tiene cuenta de WhatsApp.
- 131047: El usuario bloqueó tu número.
- 470: Intento de envío fuera de la ventana de 24h.
- 131021: Plantilla no aprobada.
Valida el número de teléfono usando el endpoint de validación de WhatsApp.
Verifica la plantilla:
- Asegúrate de que esté aprobada.
- Que coincida con el idioma configurado del contacto.
- Que las variables estén correctamente completadas.
Confirma el consentimiento (opt-in) del usuario antes de enviar mensajes.

Tabla de códigos de error de WhatsApp API

Código	Significado	Explicación / Solución
131026	Número no registrado	El número no tiene cuenta de WhatsApp o usa una versión no compatible con la API.
131047	Usuario bloqueó tu empresa	No se pueden enviar mensajes.
131021	Plantilla no aprobada	Usa solo plantillas aprobadas.
131022	Idioma no soportado	La plantilla no está disponible en el idioma del usuario.
131023	Parámetros inválidos	Revisa las variables de la plantilla.
131024	Plantilla no encontrada	La plantilla no existe o no coincide el nombre.
131025	Mensaje no permitido	Intento de envío sin plantilla fuera de la ventana de 24h.
131048	Número de destino inválido	Formato incorrecto. Usa el formato internacional E.164.
470	Fuera de la ventana de 24h	Usa una plantilla aprobada si ya pasó ese plazo.
1000	Error genérico	Intenta reenviar más tarde.
1006	Error de red o timeout	Reintenta la petición.
4700	Limitación de cuenta	Puede haber restricciones temporales por volumen u otras razones.

? Fuente oficial: Consulta la documentación de códigos de error de WhatsApp Cloud API para obtener la lista completa y actualizada directamente desde Meta.

Consejo práctico

Guarda siempre los logs de respuesta de la API. Estos contienen los códigos que te ayudarán a identificar rápidamente el motivo del error.
Como regla general:
- Los errores que comienzan con 1310XX suelen estar relacionados con problemas de número, plantilla o restricciones del usuario.
- Los errores 100X y 4700 suelen ser problemas técnicos o restricciones de cuenta.

Conclusión

Los errores de tipo “Message undeliverable” en WhatsApp pueden parecer confusos, pero suelen tener causas identificables. Verifica el estado del número, el tipo de mensaje enviado, el consentimiento del usuario y las condiciones de tu cuenta para resolverlos rápidamente. Si continúas teniendo problemas, puedes contactar a nuestro equipo de soporte con los detalles del error.