Pular para o conteúdo principal
GET
/
api
/
chat
/
getMessage
/
:instance
Buscar mensagem por ID
curl --request GET \
  --url https://api.example.com/api/chat/getMessage/:instance
Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: sim

​
Descrição

Retorna o snapshot persistido de uma mensagem (texto, mídia, caption, mimetype, tamanho, etc.) que já foi processada pela ingestão. Útil para reidratar uma mensagem a partir do messageId recebido em um webhook ou em outro endpoint da API.

​
Exemplos

​
Por id

Recupera o snapshot da mensagem usando a query ?messageId=<message-id>. Retorna o registro completo (texto, mídia, caption, mimetype, tamanho) persistido pela ingestão. 
curl -X GET "https://ryzeapi.cloud/api/chat/getMessage/$Instance_Name?messageId=3EB08FCF27E532F1B0F5" \
  -H "token: $Token_Instance"

​
Resposta de sucesso

O snapshot vem em data com type, from, to, chat, timestamp, isGroup e o status do envio. Para mensagens de texto, content traz o corpo; em mídias, o objeto media aparece com type, mimeType, size e duration (áudio/vídeo). Use messageId no envelope para citar essa mensagem em chamadas seguintes (favoritar, encaminhar, editar).
200 OK
{
  "success": true,
  "message": "Mensagem encontrada",
  "messageId": "3EB08FCF27E532F1B0F5",
  "data": {
    "content": "Olá!",
    "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 rota

​
instance
string
obrigatório
Nome da instância.

​
Query params

​
messageId
string
obrigatório
Message ID (obrigatório).

​
Headers

NomeObrigatórioExemploDescrição
tokensim (ou Authorization)a1b2c3d4-...TokenAccount ou TokenInstance.

​
Respostas de erro

HTTPerror.messageQuando ocorre
400Message ID is required (use ?messageId=<message-id>)messageId ausente.
404Instance not found,
404Message not foundID não existe na base.
503Instance is not connected to WhatsApp,
Erro 400
{
  "success": false,
  "error": { "message": "Message ID is required (use ?messageId=<message-id>)" }
}

​
Relacionados

Mídia em base64

Recuperar a mídia bruta a partir do messageId.

Status de entrega

Conferir se foi entregue/lida.