Obtener Estado de Entrega de Mensajes vía WhatChimp API

Rastrea si tus mensajes fueron enviados, entregados, leídos o fallaron.

Updated 5 February 2026

Rastrea si tus mensajes fueron enviados, entregados, leídos o fallaron, y descubre por qué un mensaje no llegó.

Antes de comenzar: Asegúrate de tener tu clave API y tu ID de número de teléfono. Consulta Primeros Pasos con WhatChimp Developer API para instrucciones de configuración.

Endpoint

GET/POST /api/v1/whatsapp/get/message-status

https://app.whatchimp.com/api/v1/whatsapp/get/message-status

Parámetros

Parámetro	Tipo	Requerido	Descripción
`apiToken`	String	Sí	Tu clave API de WhatChimp
`wa_message_id`	String	Sí	El ID del mensaje de WhatsApp (devuelto cuando enviaste el mensaje)
`whatsapp_bot_id`	Number	Sí	Tu ID de bot de WhatsApp

¿Dónde obtengo el wa_message_id? Cada envío exitoso vía la API de WhatChimp devuelve un wa_message_id en la respuesta. Guarda este valor para verificar el estado de entrega después.

¿Dónde obtengo el whatsapp_bot_id? Llama al endpoint de User Info (GET /user/myInfo): devuelve tu array whatsapp_bots_details con IDs de bot.

Ejemplos de Solicitud

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/message-status?apiToken=API-KEY&wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=&whatsapp_bot_id=123

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/message-status' \
  -d 'apiToken=API-KEY' \
  -d 'wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=' \
  -d 'whatsapp_bot_id=123'

Message Delivery Status endpoint showing parameters and response in the API console

Respuesta

{
  "status": "1",
  "message": {
    "message_status": "delivered",
    "delivery_status_updated_at": "2024-07-28 13:21:03",
    "read_time": null,
    "failed_time": null,
    "failed_reason": ""
  }
}

Valores de Estado de Entrega

Estado	Significado
`sent`	Mensaje enviado a servidores de WhatsApp: esperando entrega
`delivered`	Mensaje entregado al dispositivo del destinatario
`read`	Mensaje leído por el destinatario (palomitas azules)
`failed`	Mensaje no pudo ser entregado: verifica `failed_reason` para detalles

Campos de Respuesta

Campo	Descripción
`message_status`	Estado de entrega actual (ver tabla arriba)
`delivery_status_updated_at`	Marca de tiempo de la última actualización de estado
`read_time`	Cuándo se leyó el mensaje (null si aún no se ha leído)
`failed_time`	Cuándo ocurrió la falla (null si no falló)
`failed_reason`	Descripción del error si el mensaje falló

Razones Comunes de Fallo

Razón	Qué Significa	Solución
Phone number not on WhatsApp	El número del destinatario no está registrado en WhatsApp	Verifica que el número sea correcto y esté activo en WhatsApp
Template not approved	La plantilla fue rechazada o aún está pendiente	Verifica el estado de la plantilla en Bot Manager > Message Template
Rate limit exceeded	Demasiados mensajes enviados en poco tiempo	Reduce tu velocidad de envío, verifica tu nivel de mensajería
Invalid phone number format	El formato del número es incorrecto	Usa código de país sin el signo `+` (ej., `919999999999`)

Casos de Uso

Recibos de entrega: confirma que los mensajes fueron entregados antes de tomar la siguiente acción en tu flujo de trabajo
Seguimiento de lectura: sabe cuándo un cliente ha visto tu mensaje
Manejo de errores: detecta mensajes fallidos y activa reintentos o alertas
Monitoreo de SLA: rastrea tiempos de entrega para mensajes sensibles al tiempo como OTPs