Al gestionar tus comunicaciones desde VENTIA, podrías encontrar códigos de error o estados específicos en tus mensajes. Es fundamental entender que estos códigos son respuestas directas de la infraestructura de Meta y no fallos de la plataforma VENTIA.
A continuación, detallamos los errores más frecuentes, su significado y qué acciones puedes tomar.
Tabla de Referencia
Código | Estado (Meta) | Traducción | Significado (¿Por qué?) | Acción Recomendada |
131049 | Healthy ecosystem | Protección Ecosistema | Meta detectó spam o baja calidad del número. | Suspende envíos masivos y revisa la relevancia de tu contenido. |
130472 | User experiment | Usuario en experimento | El destinatario es parte de un grupo de control de Meta. | No hay acción posible; el mensaje no será entregado por diseño de Meta. |
131026 | Undeliverable | Mensaje no entregable | El número no existe, te bloquearon, o el destinatario tiene una versión de WhatsApp antigua o no aceptó los nuevos términos de Meta. | 1. Verifica el número. |
131047 | 24 hours passed | Ventana vencida | Han pasado más de 24h desde el último chat del cliente. | Es obligatorio enviar una Plantilla Aprobada para retomar el contacto. |
131060 | Message unavailable | Mensaje no disponible | Fallo de sincronización en Coexistence por uso de versiones antiguas o dispositivos complementarios no compatibles. | Actualiza la App móvil y cierra sesión en WhatsApp para Windows/WearOS. |
131042 | Payment method | Error de pago | Saldo insuficiente o tarjeta rechazada en el Business Manager de Meta. | Revisa y actualiza el método de pago directamente en tu panel de Meta. |
132005 | Text too long | Texto muy largo | El mensaje de la plantilla supera los 1024 caracteres permitidos. | Reduce la extensión del texto en la plantilla y solicita nueva aprobación. |
133010 | Account not registered | Cuenta no registrada | El número fue desvinculado de la API o el registro ante Meta no se completó. | Contacta a nuestro equipo de soporte para verificar la vinculación. |
200 | Permission denied | Permiso denegado | El token de acceso caducó o VENTIA perdió permisos en tu Business Manager. | Realiza el proceso de re-vinculación en el panel de configuración de VENTIA. |
131000 | Something went wrong | Error genérico | Fallo temporal en los servidores centrales de Meta. | Espera unos minutos y reintenta el envío más tarde. |
Limitaciones de Contenido y Funcionalidades
Existen ciertos tipos de mensajes y herramientas que Meta no soporta actualmente a través de su API. Intentar utilizarlos resultará en fallas de visualización o entrega:
Contenido no compatible: No se admite el envío o recepción de Encuestas, Recordatorios, Órdenes de compra ni Productos/Items de catálogos nativos de la app de WhatsApp.
Dispositivos no compatibles (Coexistence): Para asegurar la sincronización con VENTIA, está prohibido el uso de WhatsApp para Windows y WhatsApp para WearOS. El uso de estas aplicaciones complementarias provocará la desconexión del servicio y la pérdida de visibilidad de los mensajes.
Versiones Mínimas Requeridas: Para que el modelo Coexistence funcione correctamente, los destinatarios deben contar con versiones de WhatsApp iguales o superiores a:
Android / SMBA: 2.21.15.15
iOS / SMBI: 2.21.170.4
Web: 2.2132.6
Profundización en Errores Críticos
El "Marketing Message Experiment" (Error 130472)
Meta selecciona de forma aleatoria a un pequeño porcentaje de usuarios globales para que formen parte de un "grupo de control". Si intentas enviar un mensaje a un usuario en este grupo, Meta lo bloqueará intencionalmente para medir cómo afecta la ausencia de publicidad en la experiencia del usuario.
Importante: Este bloqueo es inapelable y no depende de la configuración de VENTIA.
Protección de Ecosistema Saludable (Error 131049)
Este error actúa como una "tarjeta amarilla". Meta detecta que el contenido que estás enviando está siendo rechazado o reportado por los destinatarios.
Riesgo: Si este error persiste, Meta podría suspender tu número de forma permanente. Te recomendamos auditar tu base de datos y evitar envíos a personas que no hayan solicitado tu información.
¿Qué hacer si no encuentras el código del error aquí?
Si el sistema te devuelve un código que no figura en esta tabla, te recomendamos consultar la documentación oficial de Meta con todos los códigos, o contactar a nuestro equipo de soporte adjuntando una captura de pantalla del error para que podamos brindarte más información.