Estado de entrega

GET 
/messages/status/:messageId

Último estado conocido de un mensaje que enviaste, por WAMID.

El 201 del envío solo dice que WhatsApp aceptó el mensaje: el resultado llega después, por el webhook messages. Fuera de la ventana de 24 horas, por ejemplo, un texto libre se acepta y se rechaza segundos después con el código 131047: quien trate el 201 como éxito definitivo creerá haber enviado algo que nunca llegó.

La respuesta sale del mismo espejo de GET /events, así que no gasta llamada a Meta ni cuota de envío. status: null significa que todavía no ha llegado ningún estado (suele ser cuestión de segundos) o que los webhooks de la cuenta no se están entregando.

Request

Responses

200

Estado conocido del mensaje.

401

Token ausente, mal formado, desconocido o revocado (authentication), o cuenta suspendida (tenant_inactive).

422

El payload no pasó la validación (invalid_request, detallado en issues) o fue rechazado por Meta (meta_error, con el cuerpo original en meta).

429

Límite de peticiones superado (rate_limit).

Response Headers

Retry-After

Segundos a esperar antes de reintentar.

X-RateLimit-Category

Categoría de límite aplicada — send, media o default.

X-RateLimit-Scope

Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).

X-RateLimit-Limit

Techo de peticiones de la categoría en la ventana actual.

X-RateLimit-Remaining

Peticiones restantes en la ventana actual.