webhooks

webhooks permitem que sistemas externos disparem a execução de um pipeline via uma simples chamada HTTP — sem precisar de agendamento, sem depender de alguém clicar em "executar" manualmente.

por que isso importa

muitos processos de negócio já geram um evento em algum outro sistema — um formulário preenchido, um pedido criado, um arquivo disponibilizado. em vez de esperar um agendamento periódico rodar o pipeline, um webhook permite reagir ao evento no instante em que ele acontece.

disparando um pipeline via webhook (trigger de entrada)

qualquer workflow pode ser configurado para iniciar via webhook. o fluxo é:

1. gere (ou recupere) o token de webhook do pipeline — a plataforma cria automaticamente uma URL única e um token de segurança na primeira vez que isso é solicitado.
2. configure o sistema externo para fazer uma chamada POST para essa URL sempre que o evento relevante ocorrer.
3. o corpo (body) json enviado na chamada fica disponível dentro do workflow como uma variável do pipeline — permitindo que o próprio payload recebido seja usado nas etapas seguintes do processamento.

cada chamada bem-sucedida ao endpoint de trigger inicia uma nova execução do pipeline, com o tipo de disparo registrado como "webhook" — visível na linhagem de execução e no histórico de runs.

proteja o token

o token do webhook funciona como uma credencial de acesso: qualquer chamada com o token correto dispara uma execução. trate a URL gerada com o mesmo cuidado que uma senha, e gere um novo token caso suspeite que o atual foi exposto.

webhook da integração com github

a integração com github usa, internamente, um webhook para saber quando um pull request de publicação foi mergeado (ou fechado) — é esse evento que dispara a importação automática do pipeline para produção. essa configuração faz parte do processo de conexão com o github e não requer nenhuma configuração manual adicional além da própria integração.