{"id":767,"date":"2026-10-29T13:24:38","date_gmt":"2026-10-29T13:24:38","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/mensaje-no-entregado-api-whatsapp\/"},"modified":"2026-10-29T13:25:14","modified_gmt":"2026-10-29T13:25:14","slug":"mensaje-no-entregado-api-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/es\/mensaje-no-entregado-api-whatsapp\/","title":{"rendered":"Mensaje enviado pero no entregado en la API de WhatsApp: checklist de diagn\u00f3stico"},"content":{"rendered":"\n

Actualizado el 29\/10\/2026<\/em><\/p>\n\n\n\n

Cuando la API de WhatsApp acepta el mensaje pero este no llega, la respuesta est\u00e1 en el webhook de estado: o el mensaje se qued\u00f3 en sent<\/code> (sali\u00f3 de los servidores de Meta, pero no lleg\u00f3 al dispositivo) o termin\u00f3 en failed<\/code> con un c\u00f3digo de error. En el primer caso, las causas m\u00e1s comunes son un cliente desconectado, un cliente que bloque\u00f3 tu n\u00famero o un pa\u00eds con restricciones; en el segundo, el c\u00f3digo indica qu\u00e9 pas\u00f3 y si conviene reenviar. Meta solo cobra los mensajes entregados, as\u00ed que un mensaje que no lleg\u00f3 no aparece en la factura.<\/p>\n\n\n\n

Este checklist parte del s\u00edntoma que ves en tu sistema y llega a la acci\u00f3n. Para la referencia completa de c\u00f3digos, consulta la gu\u00eda de errores de la API de WhatsApp<\/a>.<\/p>\n\n\n\n

Paso 1: confirma que la API acept\u00f3 el mensaje<\/h2>\n\n\n\n

Antes de hablar de entrega, revisa la respuesta s\u00edncrona del env\u00edo. Si la llamada devolvi\u00f3 un objeto error<\/code>, el mensaje ni siquiera sali\u00f3: el problema es de token, par\u00e1metro, plantilla o l\u00edmite de llamadas, no de entrega. Si devolvi\u00f3 200<\/code> con un wamid<\/code>, el mensaje fue aceptado:<\/p>\n\n\n\n

{\n  \"messaging_product\": \"whatsapp\",\n  \"contacts\": [{ \"input\": \"5215512345678\", \"wa_id\": \"5215512345678\" }],\n  \"messages\": [{ \"id\": \"wamid.HBgLNTUxMTk5OTk5OTk5...\" }]\n}<\/code><\/pre>\n\n\n\n
Guarda ese wamid<\/code>. Con \u00e9l relacionas cada evento de estado con el mensaje original. Si no est\u00e1 en tu base de datos, el diagn\u00f3stico se vuelve adivinanza.<\/p>\n\n\n\n
Paso 2: lee el estado en el webhook<\/h2>\n\n\n\n
A partir de aqu\u00ed, todo llega por el webhook messages<\/code>, en el arreglo statuses<\/code>. La referencia de estados de Meta<\/a> define cinco valores:<\/p>\n\n\n\n
Estado<\/th>Qu\u00e9 dice Meta<\/th>Qu\u00e9 significa para el diagn\u00f3stico<\/th><\/tr><\/thead>
sent<\/code><\/td>El mensaje sali\u00f3 de los servidores de Meta<\/td>Aceptado y despachado, pero a\u00fan no est\u00e1 en el dispositivo<\/td><\/tr>
delivered<\/code><\/td>Entregado en el dispositivo del usuario<\/td>Lleg\u00f3; desde aqu\u00ed es cobrable<\/td><\/tr>
read<\/code><\/td>Mostrado en un chat abierto en el dispositivo<\/td>Le\u00eddo (solo cuenta como le\u00eddo si fue entregado)<\/td><\/tr>
played<\/code><\/td>Primera reproducci\u00f3n de un mensaje de voz<\/td>Solo para notas de voz<\/td><\/tr>
failed<\/code><\/td>Falla al enviar o entregar<\/td>Revisa el arreglo errors<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Dos detalles evitan falsas alarmas. Primero, si el usuario lee el mensaje de inmediato, Meta puede no enviar el delivered<\/code>, porque el read<\/code> ya implica la entrega. As\u00ed que “no recib\u00ed delivered” no significa “no se entreg\u00f3” cuando hay un read<\/code>. Segundo, si no llega ning\u00fan webhook, el problema es otro: revisa la configuraci\u00f3n en la gu\u00eda de webhooks de la API de WhatsApp<\/a> antes de culpar a la entrega.<\/p>\n\n\n\n
El art\u00edculo sobre estado de mensajes por webhook<\/a> muestra c\u00f3mo guardar estos eventos. Aqu\u00ed nos enfocamos en qu\u00e9 hacer cuando revelan un problema.<\/p>\n\n\n\n
Paso 3: mensaje detenido en sent<\/code><\/h2>\n\n\n\n
Es el caso m\u00e1s confuso: no hay error, pero tampoco delivered<\/code>. La p\u00e1gina de soporte de la Cloud API<\/a> enumera las causas m\u00e1s comunes:<\/p>\n\n\n\n