> 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 maneira 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 o mesmo 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 de variável alterada

Usar um **evento de variável alterada** 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 uma [entidade](https://docs.chatlayer.ai/understanding-users/natural-language-processing-nlp/synonym-entities) é detectada. 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 de variável alterada ao seu bot:

1. Abra a **Eventos** página na **aba de Construtor de bot** , no lado esquerdo da tela.
2. Clique em **Criar evento.**
3. Preencha o evento com as características que você desejar. Neste exemplo, queremos acionar o bloco chamado Variable changed sempre que a `test_variable` fosse alterada.&#x20;
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 de variável alterada</p></figcaption></figure>

Isso resulta no seguinte fluxo:

<figure><img src="/files/19075263ae184c2dfb678efed1bd5a13899e0e9d" alt=""><figcaption><p>Um exemplo de fluxo em que ocorre um evento de variável alterada.</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 de variável alterada.</p></figcaption></figure>

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

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

{% hint style="success" %}
Os clientes часто usam eventos de variável alterada para realizar uma requisição de API por meio de uma [ação de API](/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations.md).&#x20;
{% endhint %}

## evento de silêncio detectado

**eventos de silêncio detectado** permitem que você conduza 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 de silêncio detectado não são o mesmo 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 de silêncio detectado ao seu bot:

1. Abra a **Eventos** página na **aba de Construtor de bot** , 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 Next block após 1 minuto.
4. Clique em **Criar**.

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

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

## evento de Fluxo do WhatsApp concluído&#x20;

**Fluxo do WhatsApp concluído** 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 de Fluxo do WhatsApp concluído ao seu bot:<br>

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

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

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

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

{% hint style="info" %}
Você só pode definir **um** evento de Fluxo do WhatsApp concluído **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.
