Gatilho de Webhook

⚡ GATILHO

Inicie seu fluxo quando um sistema externo enviar uma solicitação HTTP.

---

Quando Usar

• Receber eventos da sua plataforma de e-commerce
• Integrar com Zapier ou Make
• Processar notificações de sistemas externos
• Conectar-se a qualquer sistema que possa enviar solicitações HTTP
• Sincronizar dados de bancos de dados externos
• Lidar com notificações de pagamento

---

Configuração

Campo	Descrição
Rótulo do Nó	Nome personalizado para este gatilho
Descrição	Ajuda a IA a entender o que este SmartFlow faz
Variáveis do Webhook	Defina a estrutura de payload esperada

Variáveis do Webhook

Defina as variáveis que você espera receber no payload do webhook:

Campo	Descrição
Nome	Nome da variável (ex.: order_id)
Tipo	Tipo de dado: String, Number, Boolean, Object, Array
Descrição	O que esta variável representa

Clique em + Adicionar Variável para definir cada campo que você espera.

Por que Definir Variáveis?

Definir variáveis ajuda a:

• Documentar a estrutura do payload do seu webhook
• Habilitar a autocompletação ao usar variáveis em ações
• Validar dados recebidos

---

URL do Webhook

Após salvar, você receberá uma URL de webhook única:

https://aismarttalk.tech/api/webhook/{your-unique-id}

Copie esta URL para seu sistema externo.

---

Variáveis Disponíveis

Todos os dados enviados para o webhook estão disponíveis como variáveis:

Variável	Descrição
{{webhook.variableName}}	Qualquer variável definida
{{webhook.body}}	Corpo completo da solicitação (JSON)
{{webhook.headers}}	Cabeçalhos da solicitação

---

Exemplo: Pedido de E-commerce

Definir Variáveis:

• order_id (String) — Identificador do pedido
• customer_email (String) — Email do cliente
• total (Number) — Total do pedido
• items (Array) — Itens do pedido

Fluxo:

1. Webhook — Recebe dados do pedido
2. Enviar Email — Confirmação para {{webhook.customer_email}}
3. Chamada API — Notificar Slack com os detalhes do pedido
4. Criar Tarefa no JIRA — Criar tarefa de cumprimento

---

Exemplo: Integração com Zapier

1. Crie um SmartFlow com o gatilho de Webhook
2. Copie a URL do webhook
3. No Zapier, use a ação "Webhooks by Zapier"
4. Cole sua URL de webhook do SmartFlow
5. Mapeie seus dados do Zap para variáveis do webhook

---

Segurança

• Cada URL de webhook é única e imprevisível
• Opcional: Adicione cabeçalhos de autenticação em seu sistema externo
• Monitore a atividade do webhook nas Estatísticas de Uso

---

Relacionados

• Chamada API — Chamar APIs externas
• Fluxo de Trabalho Programado — Gatilhos baseados em tempo