# 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,](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/bot-answers/track-events-for-analytics) 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins) 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. 
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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FIPGu9wyvPDUMN9pJSbh1%2FScreenshot%202023-10-13%20at%2016.43.49.png?alt=media&#x26;token=6a71f3f1-9bb9-45e0-9e99-0185cfbf48ba" alt="" width="274"><figcaption><p>Criar um evento de variável alterada</p></figcaption></figure>

Isso resulta no seguinte fluxo:

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F6PdUvF1zaSgEVilfcZRI%2FScreenshot%202023-10-13%20at%2016.46.46.png?alt=media&#x26;token=16628471-ff1a-4931-8103-eeb3f679ad4a" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fe9sE9d4mHkpJZTIP0RDs%2FScreenshot%202023-10-13%20at%2016.48.15.png?alt=media&#x26;token=30a50995-d584-49e4-b9a2-95e3521fa63d" 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.](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-M0bNdk-aEhqurz6mg5T%2F-M0bQiQqeNniGa3Sgll7%2Fimage.png?alt=media\&token=2cf5a36e-0f5b-4101-9cc9-475fa294365a)

{% 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/custom-back-end-integrations).&#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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F7bOmjqNgRZ0D3i6w2zlc%2FScreenshot%202023-10-13%20at%2017.08.40.png?alt=media&#x26;token=c5c75c58-d4d3-4d24-a148-437409754987" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FdVmxmHpvbFK3rUhZShWg%2FScreenshot%202026-04-01%20at%2015.51.14.png?alt=media&#x26;token=58f67c91-7696-495b-86ea-e15e6baef33e" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F8I9JJy93JAOgncWJ7TWd%2FScreenshot%202026-04-01%20at%2016.11.32.png?alt=media&#x26;token=4a6f2f15-fbbd-46e7-b7ab-5ecefb7c19ed" 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 %}