Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Mensaje de WhatsApp API no entregado: las causas, en orden

Un mensaje aceptado por la API de WhatsApp no es un mensaje entregado: Meta informa el resultado después, en un webhook de estado: sent, delivered, read o failed, con un código de error. Revise en orden: el estado failed y su código, la ventana de 24 horas (131047), el método de pago (131042), la plantilla (132001, 132015), el destinatario (131026, 131049, 131050), y luego los límites y la conexión del número.

easyCoexistence vigila cada número conectado las 24 horas, le envía un correo cuando Meta deja de entregar, desconecta el número o baja la calidad, y reenvía los webhooks de estado de Meta sin cambios a su sistema.

4 statuses

sent (una marca de verificación), delivered (dos), read (dos azules) y failed (un triángulo rojo de error), tal como los reportan los webhooks de estado.

131047

Han pasado más de 24 horas desde la última respuesta del destinatario; Meta indica enviar una plantilla en su lugar.

131026

No se puede entregar: el número no está en WhatsApp, el destinatario no aceptó los nuevos términos o usa una versión antigua de WhatsApp.

30 days

Tiempo predeterminado en que WhatsApp reintenta una plantilla de utilidad o de marketing no entregada antes de descartarla; las plantillas de autenticación tienen 10 minutos por defecto.

20 mps

Throughput fijo de un número usado tanto en la app de WhatsApp Business como en la Cloud API.

¿Por qué un mensaje aceptado aún no llega?

Porque la respuesta de la API y la entrega son dos eventos separados. Al enviar, Meta devuelve un id de mensaje en cuanto acepta la petición; si el mensaje llega al teléfono del cliente se sabe después, en un webhook de estado sobre el campo messages. sent significa que salió de los servidores de Meta (una marca de verificación), delivered que llegó al dispositivo (dos), read que fue abierto (dos azules) y failed que no pudo enviarse ni entregarse, y se muestra con un arreglo errors: code, title y error_data.details. Por eso la primera acción nunca es adivinar: busque el estado failed de ese id de mensaje y lea su código. Si no tiene un destino para webhooks, nada lo registra.

¿Cuáles son las causas, en el orden en que conviene revisarlas?

De la más común en un número recién conectado a la más rara. Cada línea indica el código de Meta, así que el estado failed le dice en cuál está:

  • Ventana cerrada: 131047, más de 24 horas desde que el cliente escribió por última vez. Los mensajes libres necesitan una ventana abierta; envíe una plantilla.
  • Pago: 131042, o plantillas descartadas en silencio. Desde el 1 de octubre de 2026 los mensajes de servicio también se detienen una vez usados 1,000 al mes sin método de pago.
  • Plantilla: 132001 no aprobada o idioma incorrecto, 132000 número incorrecto de variables, 132012 formato incorrecto, 132015 pausada, 132016 deshabilitada.
  • Destinatario: 131026 no está en WhatsApp, versión antigua o términos no aceptados; 131050 dejó de recibir mensajes de marketing; 131049 retenido para mantener un buen nivel de interacción; las plantillas de marketing a números de EE. UU. no se entregan.
  • Límites: 131048 restringido tras señales de spam, 131056 demasiados mensajes a una misma persona, 130429 throughput, 20 mensajes por segundo en un número de Coexistencia.
  • Cuenta: 131031 o 368, la WhatsApp Business Account restringida o deshabilitada por infringir una política.
  • Conexión: el número ya no está vinculado, por ejemplo tras 14 días sin abrir la app de WhatsApp Business.

¿Cómo se manejan los códigos del lado del destinatario?

De forma distinta, porque algunos merecen un reintento y otros nunca. 131050 significa que la persona eligió dejar de recibir mensajes de marketing de usted: Meta indica no reintentar, y el webhook user_preferences le avisa cuando dejan de recibirlos o los reactivan. 131049 es Meta reteniendo un mensaje de marketing para mantener sana la interacción, a menudo un límite por usuario en plantillas de marketing: Meta aconseja esperar al menos 24 horas antes de reenviar, porque reenviar antes solo devuelve el mismo error. 131026 agrupa los números que no están en WhatsApp, los usuarios que no aceptaron los términos actuales de WhatsApp y las versiones muy antiguas de la app; revise primero el formato del número y el código de país, y luego pregunte al cliente por otro canal.

¿Cuánto tiempo sigue WhatsApp intentando entregar?

Durante el tiempo de vida (TTL) del mensaje. Cuando un teléfono está apagado o fuera de cobertura, WhatsApp reintenta la entrega en lugar de fallar de inmediato: por defecto durante 30 días en plantillas de utilidad y de marketing, y 10 minutos en plantillas de autenticación. Un negocio puede acortarlo por plantilla con message_send_ttl_seconds, de 30 segundos a 12 horas para utilidad y de 30 segundos a 15 minutos para autenticación. Un mensaje que no puede entregarse dentro de su TTL se descarta. Así, un mensaje con estado sent y sin estado delivered tras horas suele estar esperando en el teléfono del cliente, no perdido; configure un TTL corto en códigos y alertas urgentes para que una entrega tardía nunca confunda a nadie.

¿Qué significa esto para las respuestas de IA y las automatizaciones?

Lea primero la ejecución y luego el estado. En la pestaña Runs, una ejecución Skipped no envió nada y dice por qué: "Han pasado más de 24 horas desde el último mensaje del cliente", "Respondió a este chat desde su teléfono hace poco" o "Se alcanzó el límite de respuestas de IA para este chat en esta hora". Una ejecución Done significa que Meta aceptó todas las respuestas, lo que no prueba la entrega. easyCoexistence no guarda los estados de los mensajes: con automatizaciones activas, llegan a su URL de reenvío si configura una, y en modo directo van directo a su propio endpoint. Desde ChatGPT o Claude, pida a su IA que ejecute get_number_health: devuelve el estado en vivo, la calificación de calidad y los últimos 15 eventos de monitoreo, incluido un bloque sending con el código de Meta.

Cómo configurarlo

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Errores comunes

  • Reintentar un 131050. La persona dejó de recibir mensajes de marketing de usted; más intentos nunca se entregan y solo pueden sumar señales negativas.
  • Leer un id de mensaje como entregado. Meta acepta primero y reporta los fallos después, así que un flujo que se detiene en el id pierde cada mensaje rechazado.
  • Enviar una respuesta libre un día después. Tras 24 horas sin mensaje del cliente solo se acepta una plantilla.
  • Operar sin destino de webhook. Los estados fallidos llegan solo por webhook; sin uno, se pierde el motivo por el que un mensaje no llegó.
Hacerlo con EasyCoexistence

Su IA puede revisar un número desde ChatGPT o Claude con get_number_health. Desde US$ 9 hasta US$ 0.75 por número al mes, bajando a medida que agrega números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Por qué el mensaje mostró una sola marca de verificación durante horas?

Una marca de verificación es el estado sent: Meta lo envió, pero el teléfono no lo ha recibido, normalmente porque está apagado o sin conexión. WhatsApp sigue reintentando hasta que se agota el tiempo de vida de la plantilla, 30 días por defecto en utilidad y marketing.

¿Por qué llegan las respuestas pero no las plantillas?

Suele ser un problema de método de pago en la WhatsApp Business Account. Meta entrega mensajes de servicio dentro del nivel gratuito mensual del número sin uno, pero no entrega plantillas. Agregue una tarjeta en Billing & payments.

¿Puedo ver los mensajes fallidos en la app de WhatsApp Business?

No de forma confiable. En un número de Coexistencia, los mensajes enviados por la API aparecen en el hilo de chat de la app, pero el motivo del fallo solo llega en el código de error del webhook de estado.

¿Meta cobra por los mensajes que no se entregaron?

No. Meta cobra solo los mensajes entregados, y los intentos con una plantilla pausada tampoco se cobran.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el