Webhook

Um webhook é um mecanismo de notificação HTTP que permite a uma aplicação enviar dados em tempo real a outra quando ocorre um evento. Na mensagem empresarial, os webhooks notificam o sistema externo sobre mensagens recebidas, entregas confirmadas ou alterações de estado de conversa.

O que é um webhook?

Um webhook é uma chamada HTTP inversa: em vez de a sua aplicação consultar periodicamente uma API para saber as novidades (polling), o serviço externo notifica-a automaticamente em tempo real quando ocorre um evento relevante. Esta abordagem é muito mais eficiente e reduz a latência das notificações a milissegundos.

No contexto da mensagem empresarial, os webhooks são fundamentais para integrar plataformas de mensagem como o WhatsApp, o Telegram ou SMS com sistemas CRM, ERP ou aplicações próprias. Sem webhooks, seria impossível reagir em tempo real às mensagens dos clientes.

Como funcionam os webhooks

O funcionamento é simples: o programador regista um URL (endpoint) na plataforma de mensagem. Quando ocorre um evento (mensagem recebida, entrega confirmada, etc.), a plataforma faz um pedido HTTP POST a esse URL com os dados do evento em formato JSON. O sistema recetor processa o payload e responde com um código HTTP 200 para confirmar a receção.

Eventos comuns em mensagem

• Mensagem recebida – Notifica quando um cliente envia uma mensagem
• Confirmação de entrega – Confirma que a mensagem chegou ao dispositivo do destinatário
• Confirmação de leitura – Notifica quando o destinatário abre a mensagem
• Alteração de estado – Atualiza quando uma conversa é aberta, encerrada ou reatribuída
• Opt-out – Notifica quando um contacto cancela a subscrição

Os webhooks são essenciais para a automatização com chatbots e para manter os seus sistemas sincronizados em tempo real.

Segurança nos webhooks

Os webhooks devem ser devidamente protegidos: verificação de assinatura digital (HMAC-SHA256) para garantir a autenticidade do payload, utilização exclusiva de HTTPS, validação do IP de origem sempre que possível, e tempo de resposta inferior a 10 segundos para evitar retentativas.

Webhooks com SendSeven

A SendSeven oferece webhooks para todos os canais suportados da sua plataforma de funcionalidades: mensagens recebidas, confirmações de entrega, alterações de estado de conversa e eventos de opt-out. Siga o nosso guia de configuração de webhooks para começar – a configuração é feita a partir do painel de controlo sem necessidade de código. Cada webhook inclui verificação de assinatura e retentativas automáticas em caso de erro.