> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/bot-builder/events.md).

# Eventos

**Eventos** são uma forma versátil de acionar um fluxo sempre que:

* uma variável foi alterada
* um silêncio foi detectado

{% hint style="info" %}
Observe que Eventos não são a mesma coisa que [Eventos de rastreamento,](/chatlayer-documentation-pt-br/bot-answers/track-events-for-analytics.md) que são usados para fins de análise.
{% endhint %}

## evento Variáveis alteradas

Usar um **evento Variáveis alteradas** permitirá que você acione um bloco sempre que o valor de uma variável for alterado. Isso pode acontecer, por exemplo, dentro de um [Condição](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins.md) bloco, um [botão](https://docs.chatlayer.ai/bot-answers/dialog-state/message-components#next-bot-dialog), ou até mesmo quando um [entidade](https://docs.chatlayer.ai/understanding-users/natural-language-processing-nlp/synonym-entities) é detectado. Em outras palavras, o bot continuará para o próximo bloco definido para acontecer quando essa alteração de variável for detectada.

Para adicionar um evento Variáveis alteradas ao seu bot:

1. Abra a **Eventos** página na **Construtor de bots** aba, no lado esquerdo da tela.
2. Clique em **Criar evento.**
3. Preencha o evento com os recursos que você gostaria. Neste exemplo, queremos acionar o bloco chamado Variável alterada sempre que o `test_variable` for alterada.
4. Clique em **Criar.**

{% hint style="info" %}
Observe que, se você quiser criar um evento acionado quando uma variável for alterada, essa variável precisa ter sido criada antes; caso contrário, você não a encontrará no menu suspenso.
{% endhint %}

<figure><img src="/files/29cde598e514eea6bdae6bb967d42eb7c2a08ebb" alt="" width="274"><figcaption><p>Criar um evento Variáveis alteradas</p></figcaption></figure>

Isso resulta no seguinte fluxo:

<figure><img src="/files/19075263ae184c2dfb678efed1bd5a13899e0e9d" alt=""><figcaption><p>Um exemplo de fluxo em que um evento Variáveis alteradas ocorre.</p></figcaption></figure>

E esse fluxo resultará neste tipo de conversa:

<figure><img src="/files/a150e18deeceaa7d82e0dcd22b59801030275de1" alt=""><figcaption><p>Um exemplo de conversa usando um evento Variáveis alteradas.</p></figcaption></figure>

As variáveis alteradas também são armazenadas na sessão do usuário, na sua **Depurador** aba, onde você pode acessá-las na `events.variablesChanged` array.

![Acesse as variáveis alteradas na sua aba Depurador.](/files/c2681744b18c00058421e3fd1aca0cb177e2ea0a)

{% hint style="success" %}
Os clientes geralmente usam eventos Variáveis alteradas para realizar uma solicitação de API por meio de uma [ação de API](/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations.md).
{% endhint %}

## evento Silêncio detectado

**Eventos Silêncio detectado** permitem direcionar a conversa para um novo bloco quando o usuário não responde por um período de tempo definido. A duração do silêncio pode variar de 1 minuto até um máximo de 1440 minutos (24 horas).

{% hint style="info" %}
Eventos Silêncio detectado não são a mesma coisa que Atrasos, que são uma forma de esperar antes que o bot vá para o próximo bloco. Saiba mais sobre Atrasos [aqui](https://docs.chatlayer.ai/bot-answers/dialog-state/action-bot-dialog#delay).
{% endhint %}

Para adicionar um evento Silêncio detectado ao seu bot:

1. Abra a **Eventos** página na **Construtor de bots** aba, no lado esquerdo da tela.
2. Clique em **Criar evento**.
3. Preencha o nome, o gatilho e a duração (em minutos) que você gostaria de esperar antes do próximo bloco. Neste exemplo, acionamos o bloco chamado Próximo bloco após 1 minuto.
4. Clique em **Criar**.

<figure><img src="/files/f8599ee9d79d91b41b962e3c84eeec44fdccc42a" alt=""><figcaption><p>Criar um evento Silêncio detectado.</p></figcaption></figure>

{% hint style="info" %}
Você pode criar **vários eventos Silêncio detectado** em um único bot. Todos eles começarão a contar ao mesmo tempo, ou seja, seu bot irá solicitar algo ao usuário em vários intervalos. A melhor prática é não criar vários eventos Silêncio detectado com a mesma duração, para que os usuários não sejam enviados com várias mensagens em sequência.
{% endhint %}

## evento Conclusão do fluxo do Whatsapp

**Conclusão do fluxo do Whatsapp** eventos permitem que você trate os eventos criados pelo whatsapp quando um usuário conclui um [fluxo do whatsapp](https://business.whatsapp.com/products/whatsapp-flows) . Para adicionar um evento Conclusão do fluxo do Whatsapp ao seu bot:<br>

1. Abra a **Eventos** página na **Construtor de bots** aba, no lado esquerdo da tela.
2. Clique em **Criar evento**. E escolha **conclusão do fluxo do Whatsapp** como gatilho
3. Preencha o nome, a variável de destino e o diálogo do bot a visitar
4. Clique em **Criar**.

<figure><img src="/files/a50b3e19d59bad4830b4f2d9c935c8b30991afb8" alt=""><figcaption></figcaption></figure>

Os dados que o usuário forneceu ao concluir o fluxo serão salvos na **variável de destino** escolhida e o bot continuará a partir do diálogo escolhido em **Diálogo do bot a visitar** campo.<br>

<figure><img src="/files/5b3ae4be53033f346fd7bd3b2dc9afd53e968723" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Você só pode definir **um** evento Conclusão do fluxo do Whatsapp **por versão do bot.** Se a sua conversa incluir vários fluxos do whatsapp, você deve garantir que trate as possíveis diferenças no diálogo de destino do bot
{% endhint %}


---

# 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.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/bot-builder/events.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.
