Webhooks e integrações: como conectar suas ferramentas
Quando uma tarefa muda de status, o time todo precisa ficar sabendo — de preferência no canal onde já conversa, sem ninguém ter que ficar atualizando a tela. É exatamente isso que os webhooks resolvem. Neste guia você vai entender o que é um webhook, como ele funciona, os principais casos de uso, como mantê-lo seguro com assinatura HMAC e como o Pulsar usa webhooks para se conectar a Slack, Discord, Teams e Zapier.
O que é um webhook?
Um webhook é um mecanismo que faz um sistema avisar outro sobre um evento assim que ele ocorre. Em vez de o sistema interessado ficar perguntando "já mudou alguma coisa?", o sistema de origem envia, por conta própria, uma requisição HTTP com os dados do evento para um endereço (URL) que você configurou. Pense nele como uma notificação push, só que entre softwares.
O nome ajuda a entender a ideia: é um "gancho" (hook) na web que dispara uma ação em outro lugar. Quando um card é movido, um pagamento é confirmado ou um formulário é enviado, o webhook leva essa informação imediatamente para onde ela é útil.
Webhook vs API vs polling
As três abordagens trocam dados entre sistemas, mas de formas bem diferentes. Entender a distinção é o que faz o conceito de webhook "cair a ficha".
- API (pull) — você faz uma chamada e pede os dados quando quiser. O controle é seu, mas você só sabe de algo se perguntar.
- Polling — você repete a chamada de API em intervalos ("e agora? e agora?"). Funciona, mas desperdiça requisições e sempre tem atraso entre o evento e a descoberta.
- Webhook (push) — o sistema de origem te chama no instante do evento. Sem desperdício de requisições e em tempo quase real. Por isso webhooks são chamados de "API ao contrário".
Quando usar cada um
Como um webhook funciona na prática
Por baixo do capô, um webhook é uma sequência curta e previsível. Do evento até a sua ferramenta, o caminho é este:
- 1
Um evento acontece
Algo muda no sistema de origem — um card é criado, movido ou comentado, por exemplo. Esse é o gatilho. - 2
O sistema monta o payload
É gerado um pacote de dados, quase sempre em JSON, descrevendo o evento: o tipo, os dados envolvidos, o autor e um timestamp. - 3
Uma requisição HTTP POST é enviada
O sistema faz um POST com o payload para a URL (endpoint) que você cadastrou, normalmente por HTTPS. - 4
Seu endpoint recebe e processa
O receptor lê o payload, valida a assinatura e executa a ação: postar no Slack, criar um registro, disparar uma automação. - 5
O receptor responde com um status
Um 2xx confirma o recebimento. Um erro 5xx ou timeout faz o emissor reenviar mais tarde (retry).
Casos de uso: para que servem webhooks
Webhooks são a cola entre as ferramentas do dia a dia. Alguns dos usos mais comuns em gestão de projetos e colaboração:
Notificar o Slack
Avise um canal sempre que um card mudar de coluna ou ganhar um comentário, sem ninguém precisar abrir a ferramenta.
Avisar o Discord ou Teams
Leve os eventos do board para onde a comunidade ou a equipe já conversa, como mensagens formatadas.
Conectar via Zapier
Aponte um Catch Hook do Zapier para receber os eventos e encadear ações em milhares de outros apps.
Disparar automações
Use o payload para acionar pipelines, atualizar planilhas, abrir tickets ou alimentar dashboards externos.
Sincronizar sistemas
Mantenha um CRM, um ERP ou um data warehouse atualizado em tempo quase real conforme o trabalho avança.
Auditoria e logs
Encaminhe eventos para um serviço de observabilidade e mantenha um histórico do que aconteceu e quando.
Para um panorama de como regras e gatilhos reduzem trabalho manual no dia a dia, vale ler também o guia de automação de processos.
Segurança: como confiar em um webhook
Como um webhook é só um endpoint HTTP aberto na internet, ele precisa de proteção. A combinação de boas práticas garante que você só processe disparos legítimos.
Assinatura HMAC
A defesa central é a assinatura HMAC (Hash-based Message Authentication Code). O emissor e o receptor compartilham um segredo; a cada disparo, o emissor gera uma assinatura a partir do conteúdo do payload e desse segredo, e a envia em um header (por exemplo, X-Webhook-Signature). No recebimento, você recalcula a assinatura com o mesmo segredo e compara: se baterem, a mensagem é autêntica e não foi alterada no caminho.
Verifique sempre a assinatura
Retries e idempotência
Redes caem e endpoints ficam indisponíveis. Por isso um bom emissor faz retries: reenvia os disparos que falharam, geralmente com backoff (esperas crescentes entre tentativas). Como um reenvio pode entregar o mesmo evento mais de uma vez, o seu endpoint deve ser idempotente — processar o mesmo evento duas vezes sem causar efeito duplicado, usando, por exemplo, um identificador único do evento para detectar repetições.
Como o Pulsar implementa webhooks e integrações
O Pulsar é uma plataforma brasileira de gestão de projetos e colaboração em tempo real com IA (CIVITRIA). Ele usa webhooks de saída para conectar o seu board às ferramentas externas: o Pulsar envia, o seu canal recebe — sem instalar app e sem OAuth. Você só cola a URL de webhook do destino.
Slack
Conecte por Incoming Webhook e receba os eventos do board formatados, com título, quadro e autor.
Discord e Teams
Use o webhook do canal e receba cada evento como mensagem ou card, onde a equipe já conversa.
Zapier
Aponte um Catch Hook para o Pulsar e leve os eventos do board a milhares de apps via automações.
Webhook genérico
Envie um POST com JSON estruturado para qualquer endpoint HTTP seu — o canal mais flexível.
Por baixo, a entrega é confiável de verdade. Cada disparo é assinado com HMAC-SHA256 nos headers, falhas de rede e erros 5xx são reenviados com retries e backoff, e você acompanha tudo pelos logs de disparo. Além dos webhooks, o Pulsar tem automações nativas (regras de gatilho e ação que agem dentro da plataforma), tarefas recorrentes e formulários públicos para alimentar o board sem trabalho manual.
Assinatura HMAC-SHA256
Defina um segredo e cada disparo vem assinado, para você verificar a origem do evento.
Retries com backoff
Disparos que falham são reenviados automaticamente, com esperas crescentes entre as tentativas.
Logs de disparo
Veja os últimos disparos por webhook, com status, resposta e horário — retries incluídos.
Eventos sob medida
Escolha exatamente quais eventos do board viram notificação, por workspace.
Disponível a partir do Pro
Resumo
Webhooks são a forma mais eficiente de fazer suas ferramentas conversarem: em vez de consultar (pull) ou ficar perguntando (polling), o sistema de origem empurra os dados (push) no exato momento do evento. Com assinatura HMAC, HTTPS, retries e endpoints idempotentes, eles são tão seguros quanto confiáveis. No Pulsar, isso se traduz em conectar seu board ao Slack, Discord, Teams ou Zapier em minutos — com a entrega cuidada nos bastidores.
Perguntas frequentes
O que é um webhook?▾
Um webhook é uma forma de um sistema avisar outro sobre um evento assim que ele acontece, enviando um pacote de dados (payload) por uma requisição HTTP. Em vez de você perguntar repetidamente "tem novidade?", o próprio sistema dispara a mensagem no momento certo.
Qual a diferença entre webhook e API?▾
Numa API tradicional você faz a chamada e pede os dados (você puxa). No webhook é o contrário: o sistema de origem te chama e empurra os dados quando o evento ocorre. Por isso webhooks costumam ser descritos como "API ao contrário" ou notificações em tempo quase real.
Webhook é seguro?▾
Sim, quando bem implementado. A prática padrão é assinar cada disparo com HMAC: o emissor gera uma assinatura com um segredo compartilhado e o receptor recalcula para confirmar que a mensagem é autêntica e não foi alterada. Também ajuda usar HTTPS e validar a origem.
O que é HMAC em webhooks?▾
HMAC (Hash-based Message Authentication Code) é um código gerado a partir do conteúdo do payload e de um segredo que só emissor e receptor conhecem. Ele vem em um header (como X-Webhook-Signature) e prova que o webhook veio de quem deveria e não foi adulterado no caminho.
Por que um webhook precisa de retries e idempotência?▾
Redes falham e endpoints ficam fora do ar, então um bom emissor reenvia (retries) os disparos que não chegaram. Como um reenvio pode duplicar um evento, o receptor deve ser idempotente: processar o mesmo evento duas vezes sem causar efeito duplicado.
O Pulsar precisa de plano pago para usar webhooks?▾
Os webhooks e integrações ficam disponíveis a partir do plano Pro (R$ 49/mês). O plano Free (R$ 0) permite usar o Pulsar sem custo para gestão e colaboração, e o upgrade é cobrado em Reais via Pix quando o time precisar conectar ferramentas externas.
Comece a usar o Pulsar hoje
Crie sua conta gratuita e, quando precisar, faça upgrade pagando em Reais via Pix.