Webhook
Um webhook é um mecanismo de callback HTTP em que um sistema envia uma requisição HTTP automatizada para uma URL especificada sempre que um evento definido ocorre, permitindo notificações em tempo real e integração entre serviços sem necessidade de polling.
Entendendo Webhook
Webhooks são frequentemente chamados de "APIs reversas". Em vez de seu aplicativo perguntar periodicamente a um serviço "algo mudou?" (polling), o serviço chama seu aplicativo proativamente quando algo muda. Esse modelo orientado a eventos é mais eficiente e mais em tempo real.
Um webhook é configurado fornecendo uma URL ao serviço do qual você deseja receber eventos. Quando o evento ocorre (chegada de novo e-mail, pagamento aprovado, tarefa concluída, formulário enviado), o serviço envia uma requisição HTTP POST à sua URL com um payload descrevendo o evento. Seu servidor processa o payload e toma uma ação.
Os webhooks viabilizam a maioria das integrações modernas. Quando um PR do GitHub é mesclado, o GitHub envia um webhook para o seu sistema de CI. Quando um pagamento no Stripe é aprovado, webhooks do Stripe disparam o atendimento do pedido. Quando um evento é agendado no Calendly, webhooks do Calendly podem acionar atualizações no CRM.
A confiabilidade dos webhooks depende do tratamento de falhas: reintentos quando o servidor receptor estiver fora do ar, verificação de assinatura para confirmar a autenticidade do webhook, idempotência para lidar com entregas duplicadas e processamento baseado em fila para grandes volumes de eventos.
Como GAIA usa Webhook
O GAIA usa webhooks para receber eventos em tempo real de ferramentas conectadas. Quando um novo e-mail chega no Gmail, uma tarefa é atualizada no Linear ou um evento é agendado no Calendly, os webhooks notificam o GAIA imediatamente para que ele possa agir — criando uma tarefa, enviando uma notificação ou disparando um fluxo de trabalho — sem a latência ou sobrecarga da verificação periódica.
Conceitos relacionados
Integração de API
Integração de API é o processo de conectar diferentes aplicativos por meio de suas Interfaces de Programação de Aplicações, permitindo que compartilhem dados e funcionalidades de forma transparente.
Automação Orientada a Eventos
Automação orientada a eventos (também chamada de automação baseada em eventos) roda um fluxo de trabalho no momento em que algo acontece, como a chegada de um email novo, a criação de uma issue ou uma linha nova em uma planilha, em vez de em um horário fixo. Cada automação liga um evento gatilho às ações que devem ser feitas, e o sistema onde o evento aconteceu avisa a plataforma de automação, geralmente por um webhook.
Automação de Fluxos de Trabalho
A automação de fluxos de trabalho é o uso da tecnologia para executar automaticamente processos e tarefas repetitivas de negócios, reduzindo o esforço manual e o erro humano.
Automação de Gatilho e Ação
Automação de gatilho e ação é um padrão em que um evento definido (o gatilho) inicia automaticamente uma ou mais ações subsequentes, permitindo fluxos de trabalho orientados por eventos que funcionam sem intervenção humana.
API REST
Uma API REST (Representational State Transfer) é uma interface de serviço web que utiliza métodos HTTP padrões (GET, POST, PUT, DELETE, PATCH) para acessar e manipular recursos identificados por URLs, seguindo um conjunto de convenções arquiteturais que tornam as APIs previsíveis e interoperáveis.
Idempotência
Idempotência é uma propriedade de uma operação cujo resultado não muda se ela for executada múltiplas vezes — tornando seguro repetir sem causar efeitos colaterais indesejados.
