Saltar al contenido principal
GET
/
api
/
chat
/
status
/
:instance
Estado de entrega del mensaje
curl --request GET \
  --url https://api.example.com/api/chat/status/:instance
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Devuelve el estado de entrega de un mensaje enviado, equivalente a los checks (gris, doble, azul) que muestra WhatsApp. El estado se actualiza en tiempo real a medida que los eventos de WhatsMeow informan que el mensaje fue recibido por el servidor, entregado al destinatario, leído o reproducido.
Para recibir la evolución del estado en tiempo real, suscríbete al webhook message.status. Este endpoint es la lectura puntual del snapshot actual.

​
Mapa de status

status (string)status_codeSemántica
pending0Esperando ACK del servidor.
sent1ACK del servidor (check único).
delivered2Entregado al teléfono del destinatario (doble check).
received3Mensaje recibido (solo para direction = "received").
read4Leído por el destinatario (check azul).
played5Audio/video reproducido.
error-1Falla permanente de envío.

​
Ejemplo

curl -X GET "https://ryzeapi.cloud/api/chat/status/$Instance_Name?messageId=3EB08FCF27E532F1B0F5" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

status es el estado textual (sent, received, delivered, read, played, error, pending) y status_code lleva el código numérico equivalente de WhatsMeow (0–5). direction distingue mensajes enviados por la instancia ("sent") de los recibidos ("received"). timestamp es el momento en que el mensaje viajó.
200 OK
{
  "success": true,
  "message": "Message status retrieved successfully",
  "message_id": "3EB08FCF27E532F1B0F5",
  "status": "read",
  "status_code": 4,
  "direction": "sent",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "timestamp": "2026-04-28T14:30:00Z"
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Parámetros de consulta

​
messageId
string
requerido
ID del mensaje cuyo estado quieres consultar.

​
Cabeceras

NombreRequeridoEjemploDescripción
tokensí (o Authorization)a1b2c3d4-...TokenAccount o TokenInstance.

​
Respuestas de error

HTTPerror.messageCuándo ocurre
400Instance name is required,
400messageId query parameter is required,
401Invalid token,
404Instance not found,
404Message not foundEl messageId no existe.
404Message does not belong to this instanceEl mensaje pertenece a otra instancia.
Error 404
{
  "success": false,
  "error": { "message": "Message not found" }
}

​
Notas y precauciones

  • played (5) solo tiene sentido para audio y video, los mensajes de texto nunca alcanzan este estado.
  • Puede haber un retraso de 1–3 segundos entre la acción en el teléfono del destinatario y el estado actualizado aquí.
  • Para rastrear varios mensajes en tiempo real, prefiere el webhook message.status en lugar de polling.

​
Relacionados

Buscar mensaje

Recupera contenido y metadatos.

Marcar como leído

Indica que has leído un mensaje recibido.