---
title: Gatilho por Webhook
description: Inicie um fluxo a partir de uma chamada HTTP de um sistema externo — dados chegam em JSON ou nos parâmetros da URL.
---

<NoCard kind="trigger_webhook" categoria="Gatilhos" />

# Gatilho por Webhook

<Secao icon="info">Para que serve</Secao>

Imagine uma campainha na porta dos fundos do seu fluxo: um sistema externo — outro software, uma integração, um script — aperta essa campainha enviando uma chamada pela internet, e o seu fluxo acorda na hora para atender esse aviso. Esse tipo de "campainha entre sistemas" é conhecido pelo nome técnico **webhook**, e é dele que vem o nome deste gatilho.

<Secao icon="clock">Quando usar</Secao>

- Quando um sistema externo precisa **iniciar um fluxo** automaticamente (ex.: um ERP que avisa quando uma fatura vence).
- Quando você quer receber dados de fora — em **JSON** (um formato de texto simples para organizar informação, tipo uma lista de "campo: valor") ou como parâmetros na própria URL — e usá-los dentro do fluxo.
- Quando outra plataforma oferece avisos automáticos desse tipo e você quer reagir a eles (Stripe, HubSpot, formulários, etc.).

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>Arraste o bloco **Gatilho por Webhook** para o canvas a partir da categoria **Gatilhos**. <Captura legenda="Painel de busca de blocos aberto no canvas, com as categorias e a lista de nós disponíveis para arrastar" src="/img/flowbuilder-paleta-aberta.png" /></Passo>
  <Passo>Clique no bloco para abrir o painel de configuração. Você vai ver o endereço (URL) gerado automaticamente — copie-o.</Passo>
  <Passo>Escolha o **método** permitido para a chamada (GET, POST, PUT, DELETE, PATCH ou HEAD) — é o "tipo" de chamada que o sistema externo vai usar. Para enviar dados junto, use POST ou PUT.</Passo>
  <Passo>Cole o endereço copiado no sistema externo que vai disparar o webhook.</Passo>
  <Passo>Conecte a saída do Gatilho por Webhook ao próximo nó do fluxo. <Captura legenda="Blocos conectados no canvas, com a seta de ligação entre o gatilho e o próximo passo do fluxo" src="/img/flow-exemplo-inicio.png" /></Passo>
</Passos>

<Secao icon="sliders-horizontal">Campos</Secao>

| Campo | O que faz |
|-------|-----------|
| URL do Webhook | Gerada automaticamente; é o endereço que o sistema externo vai chamar |
| Método HTTP | Define qual tipo de chamada é aceito (GET / POST / PUT / DELETE / PATCH / HEAD) |
| Título | Nome interno do nó no canvas |

<Secao icon="circle-check">Exemplo</Secao>

Seu sistema de e-commerce envia uma chamada do tipo POST para o endereço do webhook quando um pedido é aprovado. Os dados chegam assim:

```
{ "cliente": "Maria", "pedido": "001", "valor": 250.00 }
```

O fluxo usa essas informações para enviar uma mensagem no WhatsApp confirmando o pedido.

<Dica>
Os dados enviados na chamada ficam disponíveis como variáveis no fluxo. Por exemplo, se o sistema externo manda `{"cliente": "Maria"}`, você acessa esse valor nos nós seguintes como `body.cliente`.
</Dica>

<Cuidado>
O endereço do webhook é público — qualquer pessoa que tiver esse endereço pode disparar o fluxo. Se precisar de mais segurança, peça para o sistema externo enviar um token de validação junto com a chamada e confira esse token num nó Se/Senão (condição) logo após o gatilho.
</Cuidado>

## Saiba mais

- [Start (Início do fluxo)](/guia/flow-builder/gatilhos/start) — outra forma de iniciar um fluxo
- [Trigger Agenda (Agendamento)](/guia/flow-builder/gatilhos/agenda) — iniciar um fluxo em um horário programado
- [Se / Senão (condição)](/guia/flow-builder/logica/if-else) — validar um token recebido no webhook