Skip to Content
Wazend

Receber mensagens

Como receber mensagens de WhatsApp na Wazend: ler o histórico e receber mensagens em tempo real mediante webhooks.

Você pode receber mensagens de WhatsApp de duas formas: lendo o histórico de mensagens de um chat e recebendo mensagens em tempo real mediante Eventos.

Ler histórico de mensagens

Obtenha o histórico de mensagens de um chat:

GET /api/{session}/chats/{chatId}/messages?limit=100
Resposta
[
  {
    "id": "false_5215551234567@c.us_ABC123",
    "timestamp": 1723456789,
    "from": "5215551234567@c.us",
    "fromMe": false,
    "body": "Olá",
    "hasMedia": false
  }
]

Obter uma mensagem específica

GET /api/{session}/chats/{chatId}/messages/{messageId}?downloadMedia=true

Baixar arquivos de mídia

Baixe o conteúdo de mídia (imagem, áudio, vídeo, documento) de uma mensagem:

Cada mensagem com mídia traz media.url no evento: é a URL completa do arquivo no seu servidor. Baixe-o com um GET nessa URL, enviando o header X-Api-Key.

curl -H "X-Api-Key: SUA_API_KEY" -o arquivo "$MEDIA_URL"

Receber mensagens em tempo real

Para receber mensagens instantaneamente, configure Eventos na sessão. Os eventos de mensagens disponíveis são:

  • message — mensagem recebida.
  • message.any — qualquer evento de mensagem.
  • message.reaction — reação a uma mensagem.
  • message.ack — confirmação de entrega/leitura.
  • message.ack.group — confirmação de um participante num grupo.
  • message.waiting — mensagem na fila.
  • message.edited — mensagem editada.
  • message.revoked — mensagem excluída.

Informação

Consulte a página de Eventos para ver como configurar a URL, os eventos e o formato dos payloads.