Webhooks assinados: como validar as chamadas do Krivo Forms
Entenda o cabeçalho X-Krivo-Signature, as tentativas automáticas e como verificar a assinatura no seu servidor.
Muita empresa tem boas ferramentas que não conversam entre si, e alguém acaba sendo a “ponte”: copia, cola, avisa. Webhooks e plataformas como n8n e Make servem justamente para fechar essa lacuna.
O que é um webhook
Um webhook é um aviso automático: quando algo acontece em um sistema (uma resposta de formulário, um pagamento, um novo cadastro), ele envia uma chamada com os dados para um endereço que você definiu. Quem recebe pode reagir na hora.
Onde n8n e Make entram
São ferramentas visuais para montar fluxos. Em geral, um fluxo tem:
- Gatilho: o webhook que recebe os dados.
- Etapas: validar, consultar uma API, criar um registro, enviar uma mensagem.
- Saída: um resultado registrado e, se preciso, um aviso de erro.
Primeira integração: formulário → CRM → equipe
- Crie um fluxo com gatilho de webhook e copie a URL.
- Cole a URL na integração do formulário e envie um teste.
- Mapeie os campos (nome, e-mail, origem) para o CRM.
- Adicione um aviso para a equipe.
- Faça um teste completo com dados reais.
Boas práticas
- Valide a origem da chamada com assinatura (HMAC), para ninguém enviar dados falsos.
- Evite duplicidade: use uma chave única, como o e-mail.
- Trate erros: defina o que acontece quando uma etapa falha e quem é avisado.
- Guarde um registro do que foi processado.
- Envie só o necessário, respeitando a privacidade.
Quando considerar código sob medida
Ferramentas visuais atendem a maioria dos casos. Se o fluxo exige regras muito específicas, alto volume ou uma interface própria, vale conversar sobre um plugin ou web app dedicado, com as automações cuidando dos bastidores.
Comece com um fluxo simples e útil. A segunda automação sempre sai mais rápido do que a primeira.