# Gatilhos: quando o seu fluxo dispara

O **Gatilho** é o primeiro nó de todo fluxo: ele define **quando** a automação dispara. Escolher o gatilho certo é a decisão mais importante do seu fluxo — este guia apresenta cada tipo e quando usar.

Para trocar o tipo, clique no nó de **Gatilho** no editor e selecione a opção em **Tipo de Gatilho**.

## Conversa Criada (padrão)

Dispara **uma vez** quando uma nova conversa é aberta — ideal para boas-vindas, menus de atendimento e triagem inicial.

![Gatilho Conversa Criada](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMUVtQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--35383eb86f0e63ac7a60c997284edeb547b63c42/tutorial-gatilhos-01-gatilho-conversa-criada.jpg)

Em **Tipo de Canal** você limita o disparo a um canal específico (ex.: só WhatsApp) ou mantém **Todos os canais**.

## Mensagem Criada

Dispara **a cada mensagem recebida** do contato. Use para responder palavras-chave ou reagir durante a conversa.

![Gatilho Mensagem Criada](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMVFtQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--e946af2006591ea534554f62d76d7c551de3252e/tutorial-gatilhos-04-gatilho-mensagem-criada.jpg)

> ⚠️ Como dispara a cada mensagem, ative **"Ignorar conversas já atribuídas a um agente"** para o fluxo não interferir em atendimentos humanos em andamento.

## Webhook (HTTP POST)

Permite que **um sistema externo** dispare o fluxo por uma chamada HTTP — e faz muito mais: se o contato do payload não existir, **ele é cadastrado automaticamente** (telefone/e-mail), a conversa é aberta no canal escolhido e todos os campos enviados viram variáveis (`{{variables.campo}}`) para usar nas mensagens.

![Gatilho Webhook](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMUltQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ca983155e370fba576107a211ae5f4d513b2bfe5/tutorial-gatilhos-02-gatilho-webhook.jpg)

Recursos do painel:
- **URL do Webhook**: o endereço que o sistema externo vai chamar (trate como senha; dá para regenerar o token).
- **Capturar exemplo**: receba um POST de teste e mapeie os campos do payload com cliques.
- **Canal**: onde a conversa será criada — obrigatório se o fluxo envia mensagens.
- **Mapeamento de campos**: grava dados do payload direto no cadastro do contato.

Ideal para: integrar formulários do site, CRMs e sistemas próprios que cadastram contatos e já iniciam a jornada.

## Disparo agendado (diário)

Executa o fluxo **1× por dia** no horário e nos dias da semana escolhidos (fuso de Brasília) — para rotinas como lembretes de agendamento, cobranças e follow-ups diários.

![Gatilho Disparo agendado](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMU1tQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2a4d4b20e88246d83698f06df411c61b187790f4/tutorial-gatilhos-03-gatilho-agendado.jpg)

Combine com um nó **"Fonte de contatos"** logo após o gatilho: é ele que busca os registros do dia (consultas, cobranças, listas) e abre uma conversa para cada contato.

## Outros gatilhos

- **Conversa Aberta / Conversa Resolvida** — reagem à mudança de status da conversa (ex.: mensagem de pesquisa de satisfação ao resolver).
- **Entrada por Sub-fluxo** — o fluxo não dispara sozinho; ele é chamado por outro fluxo (nó "Chamar Fluxo"). Use para modularizar jornadas grandes.
- **Evento de integração** — dispara a partir de eventos das integrações nativas (ex.: ligação recebida no PABX), com os dados do evento disponíveis como variáveis.

## Dicas

- **Um fluxo, um gatilho**: cada fluxo tem um único gatilho. Precisa de dois comportamentos? Crie dois fluxos.
- **Campanhas também disparam fluxos**: ao criar uma Campanha de WhatsApp, você pode escolher um fluxo como conteúdo — o disparo em massa fica por conta da campanha.
- Depois de mudar o gatilho, **salve o fluxo** e confira se ele está **Ativo**.