O que é um webhook? Guia para quem não é programador: ligar o chatbot às suas ferramentas
Um webhook é uma mensagem automática que uma aplicação envia a outra no momento em que algo acontece. Veja como funcionam os webhooks de um chatbot, em que diferem de uma API e…

Neste artigo
Afinal, o que é um webhook? Um webhook é uma mensagem automática que uma aplicação envia a outra no momento em que algo acontece, como o seu chatbot captar um novo lead. Em vez de as suas outras ferramentas perguntarem "há novidades?" de poucos em poucos minutos, o chatbot avisa-as de imediato.
Pense na diferença entre ir à caixa do correio de hora a hora e ter uma campainha. A campainha só toca quando está realmente alguém à porta.
Neste artigo: como funcionam os webhooks de um chatbot, como se comparam com uma API, que eventos vale a pena enviar e como os manter seguros.
Pontos-chave
- Um webhook envia dados para outro sistema quando acontece um evento; uma API é normalmente algo que se chama para ir buscar dados.
- Os webhooks de chatbot úteis disparam com eventos de negócio, como um novo lead, uma transferência para um humano ou uma conversa encerrada.
- As assinaturas HMAC provam que uma mensagem é genuína e as novas tentativas garantem que uma falha breve não faz perder dados.
O que é um webhook, em linguagem simples?
Um webhook tem três partes:
- Um evento: algo acontece na aplicação de origem, como um visitante deixar o email no chat.
- Um URL: o endereço do sistema que recebe, muitas vezes chamado endpoint. Cola-o nas definições da aplicação de origem.
- Um payload: um pequeno pacote de dados, normalmente em JSON, que descreve o que aconteceu.
Quando o evento ocorre, a aplicação de origem envia o payload para esse URL. O sistema que recebe lê-o e faz algo útil: cria um contacto, publica um alerta, acrescenta uma linha a uma folha de cálculo. Ninguém tem de carregar num botão nem escrever um script que verifique se houve alterações.
Também não precisa de construir o lado que recebe. Plataformas de automação como o Zapier, o Make e o n8n geram um URL de webhook em poucos cliques, e é por isso que quem não é programador consegue usar webhooks.
Webhook vs. API: qual é a diferença?
Muitas vezes são vistos como rivais, mas funcionam em conjunto. Uma API (interface de programação de aplicações) é um conjunto de portas de entrada numa aplicação, às quais se bate para ler ou alterar dados. Um webhook é a aplicação a bater à sua porta quando algo acontece.
Sem webhooks, a única forma de saber de novos eventos é o polling: perguntar à API, vezes sem conta, se alguma coisa mudou.
| Webhook (push) | Polling da API (pull) | |
|---|---|---|
| Quem inicia | A aplicação de origem, quando acontece um evento | O seu sistema, segundo um calendário |
| Velocidade | Quase em tempo real | Tão rápido quanto o intervalo de polling |
| Mais indicado para | Alertas, sincronização de novos registos, arranque de fluxos de trabalho | Exportações em massa, relatórios, consultas a pedido |
| Configuração | Colar um URL, escolher os eventos | Escrever um script ou uma tarefa agendada |
| Principal risco | Mensagens perdidas se o recetor estiver em baixo (resolvido com novas tentativas) | Atrasos, pedidos desperdiçados, limites de pedidos |
Muitas integrações usam os dois. Um webhook diz "a conversa 123 acabou de ser transferida" e o sistema que recebe chama depois a API se precisar de mais pormenores.
Webhooks de chatbot: eventos de exemplo que vale a pena enviar
Os melhores webhooks de chatbot correspondem a momentos que já importam à sua equipa. Três exemplos comuns:
Novo lead captado
Um visitante partilha os dados de contacto e responde a uma ou duas perguntas de qualificação. Usos habituais: criar ou atualizar um contacto no CRM, alertar o canal da equipa comercial ou acrescentar o lead a uma lista de nutrição (com consentimento). Como responder depressa a novos leads fecha mais negócios, este costuma ser o primeiro webhook que as equipas configuram.
Conversa transferida para um humano
O assistente decidiu que uma pessoa deve assumir a conversa, ou o cliente pediu para falar com uma. Usos habituais: notificar o agente de serviço, abrir um ticket no help desk ou assinalar uma conta prioritária. O payload deve levar o contexto de que depende o seu processo de transferência do chatbot para um humano, como a intenção, as etiquetas e os dados de contacto.
Conversa encerrada
Uma conversa terminou, resolvida pela IA ou por um agente. Usos habituais: registá-la para relatórios, atualizar um painel ou criar uma tarefa de seguimento.
Uma regra simples: subscreva apenas os eventos sobre os quais vai agir. Cada webhook que ativa é mais uma coisa a monitorizar.
Segurança dos webhooks: assinaturas, novas tentativas e acompanhamento das entregas
Um URL de webhook é apenas um endereço na internet. O que impede alguém de lhe enviar mensagens falsas de "novo lead"? E o que acontece se o seu servidor estiver em baixo durante dez minutos? Três salvaguardas respondem a estas perguntas.
Assinaturas HMAC. O remetente e o recetor partilham uma chave secreta. O remetente calcula uma assinatura a partir do payload e do segredo e inclui-a em cada pedido. O recetor volta a calculá-la e rejeita tudo o que não coincida, por isso as mensagens falsificadas ou adulteradas falham.
Novas tentativas. Se o recetor não confirmar a entrega, o remetente volta a tentar mais tarde, normalmente com intervalos cada vez maiores entre tentativas. Uma falha breve não significa dados perdidos.
Disjuntores e acompanhamento das entregas. Se um endpoint falha repetidamente, um disjuntor (circuit breaker) suspende as entregas durante algum tempo em vez de sobrecarregar um servidor avariado. Os registos de entrega mostram o que foi enviado e se chegou, para que possa depurar sem adivinhar.
Do lado de quem recebe, alguns hábitos evitam a maioria dos problemas:
- Verifique a assinatura antes de usar os dados.
- Responda depressa com um código de sucesso e faça o trabalho pesado em segundo plano.
- Conte com duplicados: uma nova tentativa pode entregar o mesmo evento duas vezes, por isso use o ID do evento para ignorar repetições.
- Use apenas endpoints HTTPS.
- Reencaminhe apenas os dados pessoais de que a ferramenta recetora precisa; as regras do RGPD para chatbots de IA continuam a aplicar-se quando os dados saem do chat.
Como a Conviro trata os webhooks em tempo real
A Conviro disponibiliza webhooks em tempo real. Os eventos chegam ao seu endpoint à medida que acontecem, assinados com HMAC para que possa verificar cada pedido, reenviados automaticamente se a entrega falhar e protegidos por um disjuntor. O acompanhamento das entregas mostra o que foi enviado e se chegou.
Aponte esses webhooks para o seu próprio código ou para uma ferramenta no-code: a Conviro também se liga ao Zapier, ao Make e ao n8n, e oferece uma API REST com autenticação por bearer token e chaves com âmbito definido para ir buscar dados a pedido. Tudo isto está disponível a partir do plano Pro. A documentação para programadores explica os payloads e a verificação de assinaturas, e a página de integrações de automação mostra os caminhos sem código.
Perguntas frequentes
O que é um webhook, em termos simples?
Um webhook é uma notificação automática que uma aplicação envia a outra quando acontece um evento específico. Indica um URL à aplicação de origem, escolhe os eventos e, sempre que um acontece, ela envia um pequeno pacote de dados para esse URL. Funciona como uma campainha para software: o sistema que recebe fica a saber das alterações de imediato, em vez de as verificar repetidamente.
Preciso de um programador para usar webhooks?
Nem sempre. Plataformas de automação como o Zapier, o Make e o n8n geram um URL de webhook e permitem associar os dados recebidos a ações num editor visual. Um programador passa a ser útil quando constrói o seu próprio endpoint, verifica assinaturas em código ou liga um sistema interno sem um conector pronto a usar.
Um webhook é mais rápido do que uma API?
Para saber de novos eventos, sim. Um webhook chega instantes depois do evento, enquanto o polling de uma API só é tão rápido quanto a frequência com que verifica. Para dados históricos ou mais pormenores, a API é a ferramenta certa. A maioria das integrações bem construídas usa webhooks para notificar e a API para consultar.
O que acontece se o meu endpoint de webhook estiver em baixo?
Depende do remetente. Os bons sistemas de webhooks voltam a tentar as entregas falhadas durante algum tempo, para que as falhas breves não façam perder dados, e alguns suspendem as entregas a um endpoint que falha repetidamente. Confirme se o seu fornecedor faz novas tentativas e garanta que o seu endpoint consegue lidar sem problemas com o mesmo evento a chegar duas vezes.
Próximos passos
Escolha um evento sobre o qual agiria hoje, normalmente os novos leads, e ligue-o à ferramenta onde a sua equipa já trabalha. Quando isso funcionar de forma fiável, acrescente as transferências e as conversas encerradas. Comece grátis com a Conviro para configurar o seu assistente e passe para o plano Pro quando estiver pronto para ligar webhooks.
Publicado por
Conviro
Partilha insights sobre suporte ao cliente com IA, automação de chatbots e estratégias de crescimento SaaS.
Construa sobre o Conviro
Ligue fluxos conversacionais aos seus sistemas
Consulte os recursos para programadores e os padrões de integração antes de desenhar a implementação.
Artigos relacionados
Mais publicações
Engineering
IMAP ou POP3 (e SMTP): como ligar uma caixa de correio de apoio a um assistente de IA
7 min de leitura
Ler artigo

Engineering
7 formas de usar uma API de chatbot: tirar partido das conversas de apoio ao cliente
7 min de leitura
Ler artigo