POST (JSON) para a URL que você configurar sempre que o dispositivo recebe ou envia uma mensagem ou interação. Assim seu sistema reage na hora, sem precisar ficar consultando a API.
Como configurar (pelo painel)
1
Abra 'Gerenciar Webhook'
No painel, vá em Dispositivos, localize o dispositivo e clique em Gerenciar Webhook.
2
Informe a URL
Preencha a URL do Webhook com o endereço que vai receber os eventos. (Deixe em branco para remover.)
3
Habilite os eventos — passo essencial
Ligue o que deseja receber:
- Chat → mensagens recebidas dos seus contatos.
- Me → mensagens enviadas pelo próprio dispositivo.
4
Salve e responda com 200
Salve as configurações. Seu endpoint deve responder rápido com
200 OK — deixe o processamento pesado para depois (de forma assíncrona).Campos comuns
Todo webhook — independente do evento — inclui estes campos base:string
Chat = mensagem recebida pelo dispositivo · Me = mensagem enviada pelo próprio dispositivo.string
Nome de exibição do remetente.
string
Número de quem enviou a mensagem.
string
Número de quem recebeu a mensagem.
string
Identificador único da mensagem — útil para responder, reagir ou apagar depois.
string
Data do evento, no formato
DD/MM/AAAA.string
Horário do evento, no formato
HH:MM:SS.string
Tipo técnico do WhatsApp (ex.:
conversation, imageMessage, interactiveResponseMessage).string
Tipo amigável do evento (ex.:
texto, multimidia, localizacao, reagida, botao).Arquivos de mídia (imagem, vídeo, áudio, documento, sticker) chegam no campo
arquivo em base64, com o formato (MIME type) e, quando disponível, o filename.Eventos disponíveis
Texto
Mensagem de texto.
Imagem
Foto com legenda opcional.
Vídeo
Vídeo com legenda opcional.
Áudio
Áudio ou mensagem de voz.
Documento
PDF, DOCX e outros.
Sticker
Figurinha.
Localização
Coordenadas + link do mapa.
Contato
Cartão de contato (vCard).
Enquete
Enquete criada.
Botão / Lista
Clique em botão ou menu.
Responder
Resposta citando uma mensagem.
Reação
Reação com emoji.
Editada
Mensagem editada.
Deletada
Mensagem apagada para todos.