Atende Direito · Docs

Appearance

Trigger Webhook ​

Para que serve

Imagine uma campainha na porta dos fundos: sistemas externos (outros softwares, integrações, scripts) tocam essa campainha enviando uma requisição HTTP, e o seu fluxo acorda imediatamente para atendê-los.

Quando usar
  • Quando um sistema externo precisa iniciar um fluxo automaticamente (ex.: um ERP que dispara uma notificação quando uma fatura vence).
  • Quando você quer receber dados de fora (payload JSON, parâmetros de URL) e processá-los dentro do fluxo.
  • Quando outra plataforma oferece webhooks de saída e você quer reagir a eles (Stripe, HubSpot, formulários, etc.).
Passo a passo
  1. Arraste o bloco **Trigger Webhook** para o canvas a partir da categoria **Gatilhos**.
    CAPTURAR: bloco Trigger Webhook no canvas recém-adicionado

    CAPTURAR: bloco Trigger Webhook no canvas recém-adicionado

  2. Clique no bloco para abrir o painel de configuração. Você vai ver a URL gerada automaticamente — copie-a.
    CAPTURAR: URL do webhook destacada no painel de configuração

    CAPTURAR: URL do webhook destacada no painel de configuração

  3. Escolha o **método HTTP** permitido (GET, POST, PUT, DELETE, PATCH ou HEAD). Para enviar dados no corpo da requisição, use POST ou PUT.
    CAPTURAR: seletor de método HTTP com as opções disponíveis

    CAPTURAR: seletor de método HTTP com as opções disponíveis

  4. Cole a URL copiada no sistema externo que vai disparar o webhook.
    CAPTURARCAPTURAR: campo de URL num sistema externo hipotético sendo preenchido
  5. Conecte a saída do Trigger Webhook ao próximo nó do fluxo.
    CAPTURAR: Trigger Webhook conectado a um nó de processamento

    CAPTURAR: Trigger Webhook conectado a um nó de processamento

Campos
CampoO que faz
URL do WebhookGerada automaticamente; é o endereço que o sistema externo vai chamar
Método HTTPDefine qual verbo a requisição deve usar (GET / POST / PUT / DELETE / PATCH / HEAD)
TítuloNome interno do nó no canvas

Aliases técnicos: este nó pode aparecer internamente como trigger_webhook ou webhook_trigger — é o mesmo nó.

Exemplo

Seu sistema de e-commerce envia um POST para a URL do webhook quando um pedido é aprovado. O payload chega com { "cliente": "Maria", "pedido": "001", "valor": 250.00 }. O fluxo usa esses dados para enviar uma mensagem no WhatsApp confirmando o pedido.

CAPTURAR: painel do Trigger Webhook com URL e método POST configurados; canvas mostrando o fluxo completo de confirmação de pedido

CAPTURAR: painel do Trigger Webhook com URL e método POST configurados; canvas mostrando o fluxo completo de confirmação de pedido

Dica
Os dados do corpo (body) da requisição ficam disponíveis como variáveis no fluxo. Por exemplo, se o JSON enviado tem `{"cliente": "Maria"}`, você acessa `body.cliente` nos nós seguintes.