Estado de entrega del mensaje

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_code`	Semántica
`pending`	0	Esperando ACK del servidor.
`sent`	1	ACK del servidor (check único).
`delivered`	2	Entregado al teléfono del destinatario (doble check).
`received`	3	Mensaje recibido (solo para `direction = "received"`).
`read`	4	Leído por el destinatario (check azul).
`played`	5	Audio/video reproducido.
`error`	-1	Falla permanente de envío.

Ejemplo

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

await fetch(`https://ryzeapi.cloud/api/chat/status/${process.env.Instance_Name}?messageId=3EB08FCF27E532F1B0F5`, {
  method: "GET",
  headers: {
    "token": process.env.Token_Instance
  }
});

import os, requests

requests.get(
    f"https://ryzeapi.cloud/api/chat/status/{os.environ['Instance_Name']}?messageId=3EB08FCF27E532F1B0F5",
    headers={"token": os.environ["Token_Instance"]}
)

package main

import (
    "net/http"
    "os"
)

func main() {
    req, _ := http.NewRequest("GET", "https://ryzeapi.cloud/api/chat/status/"+os.Getenv("Instance_Name")+"?messageId=3EB08FCF27E532F1B0F5", nil)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    http.DefaultClient.Do(req)
}

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

string

requerido

Nombre de la instancia.

Parámetros de consulta

string

requerido

ID del mensaje cuyo estado quieres consultar.

Cabeceras

Nombre	Requerido	Ejemplo	Descripción
`token`	sí (o `Authorization`)	`a1b2c3d4-...`	TokenAccount o TokenInstance.

Respuestas de error

HTTP	`error.message`	Cuándo ocurre
400	`Instance name is required`	,
400	`messageId query parameter is required`	,
401	`Invalid token`	,
404	`Instance not found`	,
404	`Message not found`	El `messageId` no existe.
404	`Message does not belong to this instance`	El 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.

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Estado de entrega del mensaje

Descripción

Mapa de `status`

Ejemplo

Respuesta exitosa

Parámetros de ruta

Parámetros de consulta

Cabeceras

Respuestas de error

Notas y precauciones

Relacionados

Buscar mensaje

Marcar como leído

​Descripción

​Mapa de status

​Ejemplo

​Respuesta exitosa

​Parámetros de ruta

​Parámetros de consulta

​Cabeceras

​Respuestas de error

​Notas y precauciones

​Relacionados

Buscar mensaje

Marcar como leído

Descripción

Mapa de `status`

Ejemplo

Respuesta exitosa

Parámetros de ruta

Parámetros de consulta

Cabeceras

Respuestas de error

Notas y precauciones

Relacionados