# Conexão com um temporizador (por enquanto, pulamos os temporizadores; o André disse que eles estão desativados no MAVI)

#### **Atraso antes da resposta**

<div data-with-frame="true"><figure><img src="/files/a6f5b6aae9500890f3b32828f8cce238da8c3726" alt="" width="563"><figcaption></figcaption></figure></div>

A transição para o próximo bloco ocorrerá após o intervalo de tempo especificado no **Atraso antes da resposta** campo. O tempo pode ser medido em segundos, minutos, horas, dias ou meses. Essa funcionalidade é usada para enviar mensagens automáticas que não exigem resposta do usuário.

Deixe o **Atraso antes da resposta** campo vazio se a transição deve ocorrer em resposta a uma ação ou mensagem do usuário.

Você pode verificar se uma mensagem está agendada na **Clientes** seção. Para isso, abra a conversa com o cliente, vá para a **Sobre o cliente** aba — **Mensagens agendadas:**

<div data-with-frame="true"><figure><img src="/files/8f7a49b42270b71f22642482d5d5ac28e7b375c9" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/0809ce18ca8cf443986174b6a961e229401a4be0" alt="" width="563"><figcaption></figcaption></figure></div>

Uma mensagem agendada também pode ser encontrada nas variáveis do cliente:

<figure><img src="/files/41aed015d44757be7be07a7a34799619af292815" alt=""><figcaption></figcaption></figure>

Clicar em **"Mensagem agendada"** abrirá uma janela com informações sobre a mensagem:

<figure><img src="/files/10422650b972397c4b637f822d909e50573b3f8e" alt=""><figcaption><p>Conversa com o cliente: verificando mensagens agendadas</p></figcaption></figure>

### **Cancelar ao sair do bloco (botão de alternância)**

Ative este botão se precisar interromper a sequência de mensagens automáticas quando o usuário realizar qualquer ação e avançar para outro bloco.

<figure><img src="/files/4c8221df335720368b463fd33b1719870a239c21" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Observe que, para essa configuração entrar em vigor, a posição do cliente no funil deve mudar. Ele precisa passar para um bloco de estado diferente.
{% endhint %}

**Exemplo:**\
\
O cliente recebe a Mensagem 1 com um botão. Se ele pressionar o botão, receberá a Mensagem 2. A posição dele no funil será alterada, e a mensagem agendada com um temporizador de 10 minutos será cancelada.\
Se o cliente não pressionar o botão dentro de 10 minutos, ele receberá uma nova mensagem com o botão dizendo: "Você ainda não pressionou o botão."

<figure><img src="/files/d25faab1dbc8f1965d6723fd035410a93a32b0d6" alt=""><figcaption><p>Opção 1</p></figcaption></figure>

<figure><img src="/files/7ebf5366a2ac28f58ebd8c37bca403a4a742010f" alt=""><figcaption><p>Opção 2</p></figcaption></figure>

*<mark style="color:vermelho;">**Vamos considerar o cenário de erro**</mark>*\
\
Ao transitar para o bloco Mensagem 1, uma seta de temporizador de 10 minutos com a configuração "Cancelar ao sair do bloco" ativada é agendada para o usuário. Também há uma seta com a condição "Botão pressionado" definida com um temporizador de 5 minutos.\
\
Nessa situação, quando o botão é clicado, a Mensagem 2 será agendada e enviada 5 minutos após o clique no botão. O cliente NÃO muda sua posição no funil até receber a Mensagem 2 (ou seja, até fazer a transição para o bloco Mensagem 2).\
\
Se a posição no funil não tiver mudado, o cliente receberá a mensagem "Você ainda não pressionou o botão" após 10 segundos. Então, de acordo com o temporizador, o texto do bloco "Mensagem 2" será exibido em seguida.

<figure><img src="/files/d6a1f43502af305564394e5525fa9afc4195626a" alt=""><figcaption><p>Erro: com as configurações atuais, o cliente receberá a mensagem de lembrete após 3 minutos, mesmo que tenha pressionado o botão.</p></figcaption></figure>

*<mark style="color:vermelho;">**Segundo cenário de erro**</mark>*\
\
O cliente também receberá a mensagem do bloco "Você ainda não pressionou o botão", mesmo se conseguir pressionar o botão. O motivo: **"Não é um estado"** blocos NÃO alteram a posição do cliente no funil.

<figure><img src="/files/25c7fcc6516900ed7773674efabc70ad1d428a70" alt=""><figcaption><p>Erro: o bloco Não é um estado NÃO ALTERA a posição no funil do cliente</p></figcaption></figure>

### &#x20;Cancelar mensagens com temporizador (botão de alternância)

Se o botão estiver ativado, todas as mensagens temporizadas agendadas serão canceladas ao fazer a transição pela seta, exceto aquelas em que **"setas Não cancelar"** estiver ativado.

<figure><img src="/files/92db488bc901fbb1173a6d4147590bf5840843ff" alt=""><figcaption></figcaption></figure>

### **Não cancelar** (botão de alternância)

Mensagens agendadas por meio de uma seta com o **"setas Não cancelar"** botão ativado permanecerão agendadas, mesmo que o cliente transite por setas com o **"Cancelar mensagens temporizadas"** botão ativado.

<figure><img src="/files/05d1626c3d6455783d1f7f618d1e5bc7f1bf0ecf" alt=""><figcaption></figcaption></figure>

### Campo de data e hora de envio

Para agendar uma mensagem para um horário específico, insira o horário de envio no formato **HH:MM** ou selecione-o usando os controles deslizantes.

<figure><img src="/files/cb33118d2a44eef0ac0ef51ab9d7464c2098789e" alt="" width="563"><figcaption><p>Configurações de horário de envio</p></figcaption></figure>

Para agendar uma mensagem para uma data específica, insira-a no formato **DD.MM.AAAA** ou selecione-a usando o calendário.

<figure><img src="/files/d12d481f106b6d988b7b3bd11faf18037336133a" alt=""><figcaption><p>Configurações de data de envio</p></figcaption></figure>

{% hint style="info" %}
É melhor especificar o horário de envio no campo **"Hora do envio"** junto com este campo de data.
{% endhint %}

\
Se o horário de envio não for especificado, a mensagem será enviada **1 minuto antes do início da data especificada** (às 23:59).<br>

Se um atraso for definido no campo **"Atraso antes da resposta"** ele será adicionado ao horário agendado.

<figure><img src="/files/7b285bed09c240bbb57a663219d505800358d208" alt=""><figcaption></figcaption></figure>

A mensagem será enviada na data e hora especificadas.<br>

Se um valor numérico for inserido no **"Atraso antes da resposta"** campo, esse atraso será adicionado ao horário agendado.

<figure><img src="/files/c63bdc4f9cabe18c2ef2ee8fe5f259a47b0fd253" alt=""><figcaption><p><strong>Configurações da seta: Horário de envio + Atraso antes da resposta</strong><br>A mensagem será enviada <strong>30 minutos depois</strong> do horário agendado de <strong>08:28</strong>, ou seja, às <strong>08:58 em 17 de junho</strong>.</p></figcaption></figure>

<figure><img src="/files/74b6305229c0d16cfbd9b7f77bf845dd1cbcbb78" alt=""><figcaption><p>No cartão do cliente, você pode ver a <strong>data e hora</strong> da mensagem agendada, levando em conta o atraso.</p></figcaption></figure>

Você pode usar variáveis para especificar o horário.

Uma variável de horário pode ser definida na **constantes do projeto** ou definida no **Calculadora**.

<figure><img src="/files/0ba184e1f9dd5e5a826ab8911601e13abe71b938" alt=""><figcaption><p>Vamos definir uma variável no <strong>Calculadora</strong>.</p></figcaption></figure>

Da mesma forma, você pode usar uma **data de envio** especificando-a no formato **DD.MM.AAAA**.

<figure><img src="/files/4de7229ab7619957de3b2d0e7d5fd9754cfefa48" alt=""><figcaption><p>Na <strong>"Hora do envio"</strong> da seta, especifique a variável.</p></figcaption></figure>

### **Enviar se a data já tiver passado** (botão de alternância)

Se o horário agendado da mensagem já tiver passado na data especificada, e o **botão "Enviar se a data já tiver passado"** estiver ativado, a mensagem será agendada para o dia seguinte.&#x20;

<figure><img src="/files/cf8b44249fd8f8a6b8faf5cea904b4c95984dac5" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
O **botão "Enviar se a data já tiver passado"** O botão funciona SOMENTE quando usado junto com uma data de envio da mensagem.
{% endhint %}

**Cenário 1:** A seta tem um horário de envio definido para 10:00 e o **botão "Enviar se a data já tiver passado"** botão está DESATIVADO.\
Se o cliente entrar no funil e receber **Mensagem 1** às 16:34, a próxima mensagem será **agendada para o dia seguinte**.

Nas mensagens agendadas, elas terão o texto de **Mensagem 2** definida para ser enviada no dia seguinte às 10:00.

<figure><img src="/files/31bdeffc050cc296bda069d7f2012be08180798c" alt="" width="563"><figcaption><p>A Mensagem 2 NÃO será enviada com essas configurações se o cliente entrou no bloco Mensagem 1 após as 10:00.</p></figcaption></figure>

**Cenário 2:** A seta tem um horário de envio definido para 10:00 e o **botão "Enviar se a data já tiver passado"** botão está ATIVADO.

O cliente entra no funil e recebe **Mensagem 1** às 16:34 de 23 de fevereiro.

A mensagem será **agendada para o dia seguinte**.

Nas mensagens agendadas, elas terão o texto de **Mensagem 2** definida para ser enviada no dia seguinte às 10:00.

<figure><img src="/files/dfad7482405a7ceffdc7e374da71d6902de0a72c" alt="" width="544"><figcaption><p>Configurações da seta: Horário + Enviar se a data já tiver passado</p></figcaption></figure>

<div align="center"><figure><img src="/files/f7fafc054d890c2ef08dbda05315c0c4cd053248" alt="" width="563"><figcaption><p><strong>Cenário 2:</strong> O cliente entra no <strong>Mensagem 1</strong> bloco em 23 de fevereiro após as 10:00, com o <strong>botão "Enviar se a data já tiver passado"</strong> botão ativado na seta.</p></figcaption></figure></div>

**Cenário 3:** A seta tem uma **data de envio** especificada e um horário de envio de 10:00. O **botão "Enviar se a data já tiver passado"** botão está DESATIVADO.

Se o cliente entrar no funil e receber **Mensagem 1** às 16:34, a próxima mensagem **NÃO será agendada para o dia seguinte**.

O cliente permanecerá no **Mensagem 1** bloco, e não haverá mensagens agendadas na conversa.

<figure><img src="/files/baff0dec419ac14e6335c4b0025a39d3f6f7dba1" alt=""><figcaption><p>O <strong>data de envio</strong> campo contém a variável interna <code>current_date</code> = o dia atual.</p></figcaption></figure>

### **Exemplo**

Uma seta de temporizador é uma seta em que a transição ocorre após um atraso especificado. Elas são mostradas como linhas tracejadas, com o tempo de atraso exibido.

No nosso diagrama, há várias dessas setas. A primeira vem do bloco verde-vivo **"Boa tarde"** Essa seta tem um atraso definido de 0 segundos.

Como funciona: depois que o bot responde ao cliente com **"Boa tarde"**, a próxima pergunta **"Você gostaria de fazer um pedido?"** vem imediatamente em seguida.

<figure><img src="/files/7abebce9d28d0cebb6b79bf617bd0cb4afe29508" alt=""><figcaption></figcaption></figure>

Portanto, para definir um atraso antes da resposta, preencha o campo correspondente no formulário de configurações.\
Da mesma forma, você pode especificar a data e a hora exatas de envio de uma mensagem preenchendo o **"Hora do envio"** .

{% hint style="info" %}
À direita do campo **"Atraso antes da resposta"** você pode selecionar a unidade de medida: **segundos, minutos, horas, dias**.
{% endhint %}

{% hint style="warning" %}
Se você usar atrasos junto com condições de comparação de variáveis e tiver **"Cancelar mensagens temporizadas"** desativado, então insira **#{question}** no campo **"Strings a ignorar"** .
{% endhint %}

<figure><img src="/files/30e3a636d289b1315863cac2d1ae938b68ed9937" alt=""><figcaption></figcaption></figure>

### **Ir uma vez**

<div data-with-frame="true"><figure><img src="/files/4fb3bfa1980117d78699d20638855e245e0f7b7e" alt="" width="563"><figcaption></figcaption></figure></div>

Se este botão estiver ativado, o usuário poderá fazer a transição pela conexão apenas uma vez durante a conversa com o bot. Ao mesmo tempo, a mensagem será agendada tantas vezes quantas a condição para agendar a mensagem vinculada à seta for atendida.

{% hint style="warning" %}
**"Ir uma vez"** estiver <mark style="color:vermelho;">NÃO é o mesmo</mark> que **agendar** a transição pela seta apenas uma vez.
{% endhint %}

Vamos analisar cenários de acionamento da seta com o **botão "Transição uma vez"** ativado:

**Ir uma vez** + **Cancelar mensagens com temporizador**

<div data-with-frame="true"><figure><img src="/files/2fe2bf9835237114906e673146ff3fc7c561d3ac" alt="" width="563"><figcaption></figcaption></figure></div>

Se o **Cancelar mensagens com temporizador** botão está ativado na seta, então quando o cliente reentrar no **Mensagem 1** bloco, as mensagens agendadas anteriormente serão canceladas, e apenas a mensagem agendada mais recentemente permanecerá.

O **Transição uma vez** botão também está ativado. Isso significa que, uma vez que a transição pela seta para **Mensagem 2** ocorra, ela não será agendada novamente.

**Transição apenas uma vez (outros botões desativados).**

Se apenas o **Transição uma vez** botão estiver ativado nas configurações da seta, novas mensagens continuarão sendo agendadas **até que a transição real** pela seta ocorra.

<figure><img src="/files/78aa12bc4d247b8ca13bdc1b5da4acccde8cc2ac" alt=""><figcaption></figcaption></figure>

O cliente entra no **Mensagem 1** bloco, e uma transição para **Mensagem 2** é agendada.\
Enquanto o usuário não tiver recebido o texto de **Mensagem 2**, as transições continuarão sendo agendadas.

O **botão "Transição uma vez"** botão é acionado **APENAS NA TRANSIÇÃO REAL**.\
Após fazer a transição para **Mensagem 2**, futuras entradas em **Mensagem 1** não irão **agendar mais** a transição por esta seta.&#x20;

{% hint style="success" %}
Tenha cuidado com suas configurações e sempre teste diferentes cenários de comportamento do usuário no bot.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.mavibot.ai/doc/pt/chatbot/builder/conexoes/conexao-com-um-temporizador-por-enquanto-pulamos-os-temporizadores-o-andre-disse-que-eles-estao-desa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.