> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/triggers-and-http/gatilho.md).

# Gatilho

### Visão Geral

O **Gatilho de Eventos do Sistema** é o ponto de partida padrão para fluxos de automação que dependem de mudanças de estado em registros internos (como no CRM) ou de comandos de redirecionamento do próprio ecossistema. Sua função principal é escutar eventos específicos associados ao ciclo de vida de dados ou receber instruções de "ponte" vindas de réguas de relacionamento externas e de outros fluxos de automação concorrentes.

### Parâmetros de Configuração

A parametrização do gatilho define a natureza da entrada do fluxo. Ele é gerenciado através dos seguintes controles principais:

* **Seleção do Evento Base:** Define qual mutação de dado disparará a automação. Os eventos nativos incluem:
  * `Conversão`: Disparado quando um lead ou contato realiza uma ação de conversão (ex: preenchimento de formulário, download de material).<br>
  * `Pessoa criada`: Disparado imediatamente após a inserção de um novo registro de contato no banco de dados.<br>
  * `Pessoa atualizada`: Ativado quando qualquer campo ou propriedade de um contato existente sofre modificação.<br>
  * `Pessoa excluída`: Disparado quando um registro é removido do sistema.<br>
  * `Pessoa mesclada`: Executado quando dois registros duplicados são unificados.<br>
  * `Pessoa bloqueada`: Disparado quando restrições de comunicação ou privacidade são aplicadas ao contato.<br>

### Construtor Visual de Condicionais

O componente possui um motor de regras visual estruturado em blocos para filtrar quais registros que geraram o evento de fato iniciarão o fluxo:

* **Bloco E (AND):** Agrupa critérios que devem ser obrigatoriamente verdadeiros de forma simultânea. É utilizado para nichar o evento (ex: Evento = `Pessoa criada` **E** Estado = `SP`).<br>
* **Bloco OU (OR):** Agrupa critérios alternativos. O fluxo será iniciado se qualquer uma das linhas inseridas for correspondida (ex: Canal = `WhatsApp` **OU** Canal = `Telegram`).<br>
* **Botão Adicionar Condição:** Permite aninhar múltiplos blocos lógicos complexos para segmentações avançadas.<br>

### Operadores Especiais e Fontes de Acionamento

Além dos eventos manuais e automáticos de cadastro, este gatilho responde a duas origens operacionais especiais dentro da arquitetura de automação:

* **Acionamento via Régua de Automação (CRM):** O gatilho atua como o nó receptor de campanhas ou réguas de relacionamento externas. Quando o lead atinge uma determinada etapa no funil do CRM, o próprio CRM injeta o contato diretamente neste gatilho para iniciar a automação secundária.<br>
* **Redirecionamento via Componente de Desvio (`goTo`):** Funciona como um ponto de ancoragem para reutilização de processos. Um fluxo "A" pode utilizar um componente do tipo `goTo` (Ir Para) apontando para este gatilho para transferir a jornada do cliente para o fluxo atual, sem a necessidade de duplicar blocos de código.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários comuns de utilização deste gatilho no ecossistema:

| **Evento Selecionado**       | **Condicional Configurada**        | **Caso de Uso Prático**                                                                        |
| ---------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Pessoa criada**            | `Nenhuma`                          | Disparar uma mensagem de boas-vindas imediata para leads vindos de anúncios.                   |
| **Cartão ganho**             | `Nenhuma`                          | Iniciar o fluxo de onboarding e liberação de acessos após a compra.                            |
| **Pessoa atualizada**        | `Etapa do Funil` igual a `Perdido` | Mover o contato para uma régua de repescagem ou enviar pesquisa de satisfação.                 |
| *(Nenhum - Chamada externa)* | Acionado via componente `goTo`     | Centralizar o envio de notas fiscais vindo de 3 fluxos de vendas diferentes em um único lugar. |

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/triggers-and-http/gatilho.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.