CONVIRO
Engineering

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…

Conviro
15 de setembro de 20267 min de leitura
O que é um webhook? Guia para quem não é programador: ligar o chatbot às suas ferramentas
Disponível em:DEENESETFRITLTNLPLPTTR
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:

  1. Um evento: algo acontece na aplicação de origem, como um visitante deixar o email no chat.
  2. Um URL: o endereço do sistema que recebe, muitas vezes chamado endpoint. Cola-o nas definições da aplicação de origem.
  3. 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.

Partilhar:

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