Skip to main content
GET
Buscar mensagem por ID
Auth: TokenAccount ou TokenInstanceRate-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.

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

Parâmetros de rota

string
obrigatório
Nome da instância.

Query params

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

Headers

Respostas de erro

Erro 400

Relacionados

Mídia em base64

Recuperar a mídia bruta a partir do messageId.

Status de entrega

Conferir se foi entregue/lida.