> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.leadzy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Gatilhos

> Crie respostas automáticas com palavras-chave e condições

## Vídeo Tutorial

*Aprenda a criar gatilhos e automatizar respostas no WhatsApp.*

<iframe width="100%" height="400" src="https://www.youtube.com/embed/Ddyxk4GV4Wk" title="Como criar gatilhos no Leadzy" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />

***

## O que são Gatilhos

Gatilhos enviam scripts automaticamente quando o cliente escreve determinadas palavras.

**Exemplo:** Cliente escreve "preço" → Leadzy envia automaticamente o script de vendas.

<Warning>
  **Importante antes de usar**

  * O funcionamento dos gatilhos depende da sua **conexão com a internet** e do **WhatsApp Web estar aberto e conectado**
  * Gatilhos mal configurados podem enviar mensagens indesejadas — leia a aba **Condições** com atenção
  * O Leadzy não se responsabiliza por gatilhos mal configurados que resultem em envios indesejados
</Warning>

<Tabs>
  <Tab title="Condições">
    ## Entendendo as Condições

    A condição é a "regra" que define **quando** o gatilho vai disparar.

    ### Tipos de condição

    | Condição        | Quando dispara?                             | Exemplo prático                                                                 |
    | --------------- | ------------------------------------------- | ------------------------------------------------------------------------------- |
    | **é igual a**   | Só se a mensagem for **exatamente** essa    | "oi" dispara com `oi` — mas **não** dispara com `oi, tudo bem?`                 |
    | **contém**      | Se a palavra **aparecer** em qualquer lugar | "preço" dispara com `qual o preço?`, `me fala o preço`, `preço`                 |
    | **não contém**  | Se a palavra **não aparecer**               | "cancelar" dispara com qualquer mensagem que **não** tenha a palavra "cancelar" |
    | **começa com**  | Se a mensagem **começar** com essa palavra  | "quero" dispara com `quero saber mais`, `quero comprar`                         |
    | **termina com** | Se a mensagem **terminar** com esse texto   | "?" dispara com qualquer pergunta                                               |

    ### Adicionando várias palavras (OU)

    Dentro de **uma mesma condição**, você pode adicionar várias palavras. O gatilho dispara se **qualquer uma** delas aparecer.

    **Exemplo:**

    ```
    Condição: a mensagem contém
    Palavras: "preço" ou "valor" ou "quanto custa"
    ```

    ✅ Dispara com: "qual o preço?" ou "me passa o valor" ou "quanto custa isso?"

    Isso funciona como **OU** — qualquer uma das palavras ativa o gatilho.

    ***

    ### Adicionando várias condições (E)

    Quando você cria **mais de uma condição**, o gatilho só dispara se **todas** forem verdadeiras ao mesmo tempo.

    **Exemplo:**

    ```
    Condição 1: a mensagem contém "preço"
                        E
    Condição 2: a mensagem não contém "cancelar"
    ```

    ✅ Dispara com: "qual o preço do plano?"

    ❌ **Não** dispara com: "quero cancelar, qual o preço da multa?"

    Isso funciona como **E** — todas as condições precisam ser verdadeiras.

    ***

    ### Resumo visual

    ```
    DENTRO de uma condição = OU (qualquer palavra)
    ENTRE condições        = E  (todas precisam bater)
    ```

    ***

    ### Cuidados importantes

    <Warning>
      **Evite palavras genéricas!**

      Palavras muito comuns vão fazer seu gatilho disparar o tempo todo. Evite:

      * Palavras curtas: "a", "e", "o", "de", "da", "do"
      * Respostas comuns: "sim", "não", "ok", "tá", "beleza"
      * Saudações com "contém": "oi", "olá"

      **Exemplo de erro:** `contém "oi"` dispara com "oitocentos", "oito", "coisa"

      **Solução:** Use `é igual a "oi"` para disparar apenas com a mensagem exata "oi"
    </Warning>

    <Warning>
      **Não crie condições contraditórias!**

      Exemplo errado: `contém "preço"` **E** `não contém "preço"`

      Isso nunca vai disparar — é impossível a mensagem ter e não ter a mesma palavra.
    </Warning>
  </Tab>

  <Tab title="Criar">
    ## Criar Gatilho

    <Steps>
      <Step title="Abrir Gatilhos">
        No menu, vá em **Gatilhos → Adicionar novo gatilho**.

        <img src="https://mintcdn.com/leadzy/DHqfJkjULHZNEijR/images/button_create_gatilho.png?fit=max&auto=format&n=DHqfJkjULHZNEijR&q=85&s=6320baab4fa8ba6448b94010d7203214" alt="Criar Gatilho" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/button_create_gatilho.png" />
      </Step>

      <Step title="Preencher informações">
        * **Nome do gatilho** (só você vê, para organização)
        * **Script associado** (qual script será enviado)
        * **Restrições** (opcional): não enviar para grupos e/ou contatos salvos
        * **Tempo de espera** (opcional): aguardar X segundos antes de disparar

        <img src="https://mintcdn.com/leadzy/U-V-SMMVfR2XtiVl/images/name_script.png?fit=max&auto=format&n=U-V-SMMVfR2XtiVl&q=85&s=925ac2b88a64ab572105bba8c16275e3" alt="Nome Script" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/name_script.png" />
      </Step>

      <Step title="Adicionar condição">
        Clique em **Adicionar condição** e escolha o tipo:

        * é igual a
        * contém / não contém
        * começa com / termina com

        <img src="https://mintcdn.com/leadzy/hXEgTBGbS_Hz4Omw/images/condicoes_gatilho.png?fit=max&auto=format&n=hXEgTBGbS_Hz4Omw&q=85&s=4c841dcefa57ee6a27270e1d56d1c4c6" alt="Condições" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/condicoes_gatilho.png" />
      </Step>

      <Step title="Inserir palavras-chave">
        Digite a palavra e clique em **+** para adicionar mais palavras (funciona como OU).

        <img src="https://mintcdn.com/leadzy/U-V-SMMVfR2XtiVl/images/palavra_chave_gatilho.png?fit=max&auto=format&n=U-V-SMMVfR2XtiVl&q=85&s=f0eff3c993284c220734b31ad00b8cc3" alt="Palavra-chave" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/palavra_chave_gatilho.png" />
      </Step>

      <Step title="Testar antes de salvar">
        Use a **Área de Testes** no lado direito da tela:

        1. Digite uma mensagem de exemplo
        2. Clique em **Testar Gatilho**
        3. Veja se aparece ✅ "Gatilho seria ativado"

        <img src="https://mintcdn.com/leadzy/DHqfJkjULHZNEijR/images/area_teste_gatilho.png?fit=max&auto=format&n=DHqfJkjULHZNEijR&q=85&s=1d78d20ec2d2e6d9c58697ecf964f8f6" alt="Área de Teste" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/area_teste_gatilho.png" />

        <Note>
          Sempre teste antes de salvar, principalmente se usar várias condições.
        </Note>
      </Step>

      <Step title="Salvar">
        Clique em **Salvar gatilho**. Ele já estará ativo.

        <img src="https://mintcdn.com/leadzy/U-V-SMMVfR2XtiVl/images/salvar_gatilho.png?fit=max&auto=format&n=U-V-SMMVfR2XtiVl&q=85&s=1530df6cce7d26001ee022a9068537d7" alt="Salvar" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/salvar_gatilho.png" />
      </Step>
    </Steps>
  </Tab>

  <Tab title="Gerenciar">
    ## Gerenciar Gatilhos

    ### Ativar ou Desativar

    <Steps>
      <Step title="Abrir lista de gatilhos">
        No menu, clique em **Gatilhos** para ver todos os gatilhos criados.
      </Step>

      <Step title="Localizar o gatilho">
        Use a busca para encontrar pelo nome.

        <img src="https://mintcdn.com/leadzy/DHqfJkjULHZNEijR/images/buscar_gatilho.png?fit=max&auto=format&n=DHqfJkjULHZNEijR&q=85&s=9cd2e02d7a8900523939892ea845a727" alt="Buscar Gatilho" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/buscar_gatilho.png" />
      </Step>

      <Step title="Ligar ou desligar">
        Clique no botão **Ativo** para alternar entre ligado e desligado.

        <img src="https://mintcdn.com/leadzy/DHqfJkjULHZNEijR/images/ativar_desativar_gatilho.png?fit=max&auto=format&n=DHqfJkjULHZNEijR&q=85&s=f86dd976eb28753e2e29a804cd341b52" alt="Ativar/Desativar" height="300" className="rounded-xl border-4 border-gray-300" data-path="images/ativar_desativar_gatilho.png" />
      </Step>
    </Steps>

    ***

    ### Editar gatilho

    Clique nos **três pontos (...)** ao lado do gatilho e selecione **Editar** para:

    * Alterar as condições
    * Trocar o script associado
    * Ajustar restrições

    ***

    ### Excluir gatilho

    Clique nos **três pontos (...)** e selecione **Excluir**.

    <Warning>
      A exclusão é permanente. Se precisar apenas pausar, use o botão **Ativo** para desligar.
    </Warning>

    ***

    ### Dicas importantes

    * **Evite gatilhos duplicados**: Dois gatilhos com a mesma palavra podem disparar dois scripts ao mesmo tempo
    * **Teste sempre**: Use a Área de Testes antes de salvar alterações
    * **Use nomes descritivos**: "Gatilho Preço Vendas" é melhor que "Gatilho 1"
  </Tab>
</Tabs>

***

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="Meu gatilho não está disparando. O que fazer?">
    Verifique:

    1. O gatilho está **Ativo**?
    2. Você usou "é igual a" quando deveria usar "contém"?
    3. Testou na **Área de Testes**?
    4. Tem restrições ativas (ex: não enviar para grupos)?
    5. As condições se contradizem?
  </Accordion>

  <Accordion title="Como fazer o gatilho disparar com várias palavras diferentes?">
    Adicione todas as palavras **dentro da mesma condição**. Isso funciona como OU.

    Exemplo: `contém` → "preço" ou "valor" ou "quanto custa"

    Qualquer uma dessas palavras vai ativar o gatilho.
  </Accordion>
</AccordionGroup>

***

## Precisa de Ajuda?

* **WhatsApp:** (11) 97190-7976
* **Email:** [contato@leadzy.com.br](mailto:contato@leadzy.com.br)