Webhooks
Nesta seção, você aprende como integrar e utilizar webhooks e eventos de mensageria para conectar a aplicação aos seus projetos.
Pré-requisitos
- Ter uma conta ativa no Pingo Notify.
- Dispor de um endpoint HTTP para receber as requisições — qualquer serviço de webhook pode ser utilizado.
Criar uma conexão
1. Acessar Conexões
Entre na aba Conexões no dashboard e visualize todas as integrações criadas.
2. Criar nova conexão
Clique em Criar, escolha um nome e ajuste as configurações conforme sua necessidade.
3. Vincular ao WhatsApp
Depois de criar a conexão, clique no ícone do QR Code e escaneie-o usando o leitor de QR Code do WhatsApp. É exatamente o mesmo processo utilizado no WhatsApp Web.
4. Conexão ativada
Após a leitura do QR Code, o status será atualizado automaticamente e a conexão ficará ativa.
Mantenha o WhatsApp ativo no dispositivo vinculado.
Configurar Webhooks
Depois de criar sua conexão, você pode configurar webhooks para receber eventos em tempo real diretamente no seu endpoint HTTPS.
1. Definir a URL do Webhook
Informe a URL HTTPS do seu endpoint.
É para essa rota que o Pingo Notify enviará todos os eventos selecionados.
2. Selecionar eventos de Webhook
Escolha quais eventos deseja escutar.
A lista inclui ações como mensagens enviadas, recebidas, editadas e muito mais.
3. Ativar ou desativar o Webhook
Utilize o switch “Status do webhook” para habilitar ou pausar o envio de eventos sem precisar deletar a configuração.
4. Agrupamento de mensagens
O campo “Habilitar agrupamento de mensagens” permite reduzir a quantidade de requisições agrupando eventos durante um intervalo de tempo.
5. Simulação de digitação
A opção “Habilitar simulação de digitação” envia ao WhatsApp sinais de “digitando...” como um humano faria.
6. Tempo de agrupamento
Caso o agrupamento esteja ativo, informe o tempo (em segundos) para reunir vários eventos antes de enviá-los em um único payload.
Eventos Disponíveis
Os eventos listados representam tudo o que o sistema pode enviar para seu webhook.
Aqui está a explicação de cada um:
Mensagem enviada
Disparado quando sua integração envia uma mensagem pelo WhatsApp.
Inclui dados como ID da mensagem, conteúdo, destinatário e horário.
Mensagem recebida
Acionado quando uma mensagem chega ao WhatsApp conectado.
Inclui texto, mídia, remetente e metadados de origem.
Mensagem atualizada
Ocorre quando uma mensagem sofre alguma mudança — por exemplo, quando o WhatsApp atualiza o status interno.
Mensagem excluída
Enviado quando uma mensagem é apagada (tanto por você quanto pelo remetente).
Útil para sincronização de interfaces.
Mensagem editada
Disparado quando uma mensagem existente é alterada no WhatsApp, recurso recente da plataforma.
Presença atualizada
Indica mudanças no estado de presença do contato (digitando, gravando áudio, online etc.).
Todos os eventos são enviados via requisições POST em JSON, permitindo processamento rápido e integração com qualquer backend.