Mensajes No Entregados
Diagnóstico de mensajes que no se entregan, códigos de error de WhatsApp y limitaciones de envío.
Mensajes No Entregados
Si los mensajes que envía desde Trochai no llegan a sus contactos, esta guía le ayudará a identificar la causa y resolverla.
Estados de entrega
Cada mensaje enviado desde Trochai pasa por una serie de estados:
| Estado | Significado |
|---|---|
| Enviando | El mensaje fue enviado al servidor de Meta y está en proceso. |
| Enviado | Meta recibió el mensaje y lo envió al número del contacto. |
| Entregado | El mensaje llegó al teléfono del contacto. |
| Leído | El contacto abrió y leyó el mensaje (si las confirmaciones de lectura están activas). |
| Fallido | Meta no pudo entregar el mensaje. Se muestra un código de error. |
Mensaje atascado en "Enviando"
Si un mensaje queda en estado "Enviando" por más de 30 segundos, puede deberse a:
- Problema de conexión a internet: Verifique que su conexión está activa recargando la página.
- Token expirado: Si el token de acceso de WhatsApp expiró, el mensaje no puede enviarse. Consulte Problemas de Conexión para reconectar.
- Canal inactivo: El canal de WhatsApp asociado puede haberse desactivado.
Solución: Recargue la página. Si el mensaje sigue en "Enviando", verifique la conexión del canal en Configuración > Canales de WhatsApp.
Mensaje fallido con error
Cuando Meta rechaza un mensaje, Trochai muestra el estado "Fallido". Los códigos de error más comunes de la API de WhatsApp son:
Códigos de error frecuentes
| Código | Problema | Solución |
|---|---|---|
| 131047 | El mensaje fue enviado fuera de la ventana de 24 horas sin usar una plantilla aprobada. | Envíe una plantilla de mensaje para reabrir la ventana. |
| 131026 | El mensaje no se pudo entregar (número no existe, o el contacto no tiene WhatsApp). | Verifique que el número de teléfono del contacto es correcto y tiene WhatsApp activo. |
| 131053 | La foto, video o documento excede el tamaño máximo permitido por Meta. | Imágenes: max 5 MB. Videos: max 16 MB. Documentos: max 100 MB. Reduzca el tamaño del archivo. |
| 130429 | Límite de frecuencia alcanzado (rate limiting). Meta limita la cantidad de mensajes por segundo. | Espere unos minutos y reintente. Esto ocurre cuando se envían muchos mensajes en poco tiempo. |
| 131031 | La cuenta de WhatsApp Business no puede enviar mensajes a este número (bloqueado por el contacto o restricción regional). | El contacto puede haber bloqueado su número. No hay acción disponible. |
| 132000 | El número de parámetros de la plantilla no coincide con la definición. | Edite la plantilla o ajuste los parámetros antes de reenviar. |
| 132015 | La plantilla fue rechazada o pausada por Meta. | Revise el estado de la plantilla en la sección de Plantillas. |
| 132012 | La plantilla no existe o no está aprobada para el idioma especificado. | Verifique que la plantilla está aprobada en el idioma que está usando. |
Si ve un código de error que no está en esta lista, tome nota del número completo y del mensaje de error, y contacte al equipo de soporte.
Limitación de frecuencia (Rate Limiting)
Meta aplica límites de envío basados en la calificación de calidad de su número de WhatsApp Business. Si envía demasiados mensajes en poco tiempo, Meta puede limitar temporalmente la capacidad de envío.
Niveles de envío
Meta clasifica los números de WhatsApp Business en niveles:
| Nivel | Límite de envío |
|---|---|
| Nivel 1 | 1,000 conversaciones únicas en 24 horas |
| Nivel 2 | 10,000 conversaciones únicas en 24 horas |
| Nivel 3 | 100,000 conversaciones únicas en 24 horas |
| Ilimitado | Sin límite de conversaciones |
Si acaba de conectar su número, probablemente comience en el Nivel 1. Meta aumenta el nivel automáticamente a medida que envía mensajes con buena calificación de calidad.
Calificación de calidad
Meta evalúa la calidad de los mensajes que envía. Si muchos contactos reportan sus mensajes como spam o lo bloquean, la calificación de calidad baja. Una calificación baja puede resultar en:
- Reducción del límite de envío
- Restricciones temporales en el envío de mensajes
- En casos extremos, desactivación de la cuenta
Recomendaciones para mantener una buena calificación:
- Solo envíe mensajes a contactos que hayan iniciado una conversación con usted.
- No envíe mensajes masivos no solicitados.
- Mantenga el contenido de las plantillas relevante y útil para el destinatario.
- Respete los horarios razonables para enviar mensajes.
Fallas en envío de multimedia
Si puede enviar mensajes de texto pero no multimedia (imágenes, videos, documentos), verifique:
- Tamaño del archivo: Las imágenes deben ser menores a 5 MB. Los videos menores a 16 MB. Los documentos menores a 100 MB.
- Formato del archivo: Meta soporta formatos comunes: JPEG, PNG para imágenes; MP4 para videos; PDF, DOC, DOCX, XLS, XLSX para documentos.
- Conexión estable: Los archivos multimedia requieren una conexión estable para subirse correctamente. Si la subida falla, intente de nuevo.
Trochai sube el archivo multimedia a los servidores de Meta antes de enviarlo. Si la subida falla pero su conexión a internet funciona, el problema puede estar en los servidores de Meta. Intente de nuevo en unos minutos.
El mensaje dice "Enviado" pero el contacto no lo recibe
Si el estado del mensaje es "Enviado" pero el contacto dice que no lo recibió:
- El teléfono del contacto puede estar apagado o sin internet. El mensaje se entregará cuando el dispositivo se reconecte.
- El contacto puede haber bloqueado su número. En este caso el mensaje nunca se entregará, pero Meta no siempre reporta este estado.
- Revise que el número del contacto sea correcto. Un dígito incorrecto puede causar que el mensaje se envíe a un número equivocado o inexistente.
Siguientes pasos
- Si el error está relacionado con la ventana de 24 horas (código 131047), consulte Problemas con la Ventana de 24h.
- Si sospecha que el problema es la conexión del canal, consulte Problemas de Conexión.
- Para aprender a enviar plantillas, consulte la sección de Plantillas.