Saltar al contenido principal
GET
/
api
/
chat
/
getMessage
/
:instance
Buscar mensaje por ID
curl --request GET \
  --url https://api.example.com/api/chat/getMessage/:instance
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Devuelve el snapshot persistido de un mensaje (texto, media, leyenda, mimetype, tamaño, etc.) que ya fue procesado por la ingestión. Útil para rehidratar un mensaje a partir del messageId recibido en un webhook o en otro endpoint de la API.

​
Ejemplos

​
Por id

Recupera el snapshot del mensaje usando la query ?messageId=<message-id>. Devuelve el registro completo (texto, media, leyenda, mimetype, tamaño) persistido por la ingestión. 
curl -X GET "https://ryzeapi.cloud/api/chat/getMessage/$Instance_Name?messageId=3EB08FCF27E532F1B0F5" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

El snapshot viene en data con type, from, to, chat, timestamp, isGroup y el status de envío. Para mensajes de texto, content lleva el cuerpo; para media, aparece el objeto media con type, mimeType, size y duration (audio/video). Usa messageId del envoltorio para referenciar este mensaje en llamadas posteriores (favorito, reenviar, editar).
200 OK
{
  "success": true,
  "message": "Message found",
  "messageId": "3EB08FCF27E532F1B0F5",
  "data": {
    "content": "Hi!",
    "type": "text",
    "from": "5511999999999@s.whatsapp.net",
    "to": "5511888888888@s.whatsapp.net",
    "chat": "5511999999999@s.whatsapp.net",
    "timestamp": "2026-04-28T14:30:00Z",
    "isGroup": false,
    "status": "delivered"
  },
  "status": "found"
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Parámetros de consulta

​
messageId
string
requerido
ID del mensaje (requerido).

​
Cabeceras

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

​
Respuestas de error

HTTPerror.messageCuándo ocurre
400Message ID is required (use ?messageId=<message-id>)Falta messageId.
404Instance not found,
404Message not foundEl ID no existe en la base de datos.
503Instance is not connected to WhatsApp,
Error 400
{
  "success": false,
  "error": { "message": "Message ID is required (use ?messageId=<message-id>)" }
}

​
Relacionados

Media en base64

Recupera el media bruto a partir del messageId.

Estado de entrega

Verifica si fue entregado/leído.