# З’єднання з таймером (поки таймери пропускаємо, Андрій сказав, що вони вимкнені в МАВІ)

#### **Затримка перед відповіддю**

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

Перехід до наступного блоку відбудеться після проміжку часу, вказаного в **Затримка перед відповіддю** полі. Час може вимірюватися в секундах, хвилинах, годинах, днях або місяцях. Ця функція використовується для надсилання автоматизованих повідомлень, які не потребують відповіді користувача.

Залиште **Затримка перед відповіддю** поле порожнім, якщо перехід має відбуватися у відповідь на дію або повідомлення користувача.

Ви можете перевірити, чи заплановано повідомлення, у **Клієнти** розділі. Для цього відкрийте діалог із клієнтом, перейдіть на **Про клієнта** вкладку — **Заплановані повідомлення:**

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

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

Заплановане повідомлення також можна знайти у змінних клієнта:

<figure><img src="/files/02d280ce6e80dfaca76cb8c4bc4ff443bf310927" alt=""><figcaption></figcaption></figure>

Натискання на **"Повідомлення заплановано"** відкриє вікно з інформацією про повідомлення:

<figure><img src="/files/9e69e6f5fa1a3a4f0b2aba8d7d68331c69bf91dc" alt=""><figcaption><p>Діалог із клієнтом: перевіряємо заплановані повідомлення</p></figcaption></figure>

### **Скасувати при виході з блоку (перемикач)**

Увімкніть цей перемикач, якщо потрібно перервати послідовність автоматизованих повідомлень, коли користувач виконає будь-яку дію та перейде до іншого блоку.

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

{% hint style="warning" %}
Зверніть увагу: щоб це налаштування почало діяти, позиція клієнта у воронці має змінитися. Йому потрібно перейти до іншого станового блоку.
{% endhint %}

**Приклад:**\
\
Клієнт отримує Повідомлення 1 з кнопкою. Якщо він натисне кнопку, то отримає Повідомлення 2. Його позиція у воронці зміниться, і повідомлення, заплановане на 10 хвилин, буде скасовано.\
Якщо клієнт не натисне кнопку протягом 10 хвилин, він отримає нове повідомлення з кнопкою "Ви досі не натиснули кнопку."

<figure><img src="/files/8e32f3fa1f0ab6b2e327377cbcf65ca4c575f46b" alt=""><figcaption><p>Варіант 1</p></figcaption></figure>

<figure><img src="/files/04e448a0bb06e358998682839836062c7c3cab26" alt=""><figcaption><p>Варіант 2</p></figcaption></figure>

*<mark style="color:red;">**Розгляньмо сценарій помилки**</mark>*\
\
Під час переходу до блоку Повідомлення 1 для користувача планується стрілка-таймер на 10 хвилин із увімкненим налаштуванням "Скасувати при виході з блоку". Також є стрілка з умовою "Кнопку натиснуто" з таймером на 5 хвилин.\
\
У цій ситуації, коли кнопку натиснуто, Повідомлення 2 буде заплановано та надіслано через 5 хвилин після натискання кнопки. Клієнт НЕ змінює свою позицію у воронці, доки не отримає Повідомлення 2 (тобто доки не перейде до блоку Повідомлення 2).\
\
Якщо позиція у воронці не змінилася, клієнт отримає повідомлення "Ви досі не натиснули кнопку" через 10 секунд. Потім, згідно з таймером, буде надіслано текст із блоку "Повідомлення 2".

<figure><img src="/files/8a683ad3a4b88088e6c3c55eec5d23a39ddafb76" alt=""><figcaption><p>Помилка: з поточними налаштуваннями клієнт отримає нагадування через 3 хвилини, навіть якщо він натиснув кнопку.</p></figcaption></figure>

*<mark style="color:red;">**Другий сценарій помилки**</mark>*\
\
Клієнт також отримає повідомлення з блоку "Ви досі не натиснули кнопку", навіть якщо йому вдасться натиснути кнопку. Причина: **"Не стан"** блоки НЕ змінюють позицію клієнта у воронці.

<figure><img src="/files/7779cccfae23bd8db7f4bd3ebcf3b3542cb8a14b" alt=""><figcaption><p>Помилка: блок Не стан НЕ ЗМІНЮЄ позицію у воронці у клієнта</p></figcaption></figure>

### &#x20;Скасувати повідомлення за таймером (перемикач)

Якщо перемикач увімкнено, всі заплановані повідомлення за таймером буде скасовано під час переходу за стрілкою, окрім тих, для яких **"Не скасовувати"** увімкнено.

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

### **Не скасовувати** (перемикач)

Повідомлення, заплановані через стрілку з увімкненим **"Не скасовувати"** перемикачем, залишаться запланованими, навіть якщо клієнт перейде через стрілки з **"Скасувати повідомлення за таймером"** увімкненим перемикачем.

<figure><img src="/files/587b801067bdd2dffc8b548f831f0e01a5c21c90" alt=""><figcaption></figcaption></figure>

### Поле дати й часу надсилання

Щоб запланувати повідомлення на конкретний час, введіть час надсилання у форматі **ГГ:ХХ** або виберіть його за допомогою повзунків.

<figure><img src="/files/bf181fea717eed7ea0f15e601fc9913fb7404d08" alt="" width="563"><figcaption><p>Налаштування часу надсилання</p></figcaption></figure>

Щоб запланувати повідомлення на конкретну дату, введіть її у форматі **ДД.ММ.РРРР** або виберіть її в календарі.

<figure><img src="/files/56806b5aee1d9352a2f3f40853e219e54ba6317f" alt=""><figcaption><p>Налаштування дати надсилання</p></figcaption></figure>

{% hint style="info" %}
Найкраще вказувати час надсилання у **"Час надсилання"** полі разом із цим полем дати.
{% endhint %}

\
Якщо час надсилання не вказано, повідомлення буде надіслано **за 1 хвилину до настання вказаної дати** (о 23:59).<br>

Якщо в **"Затримка перед відповіддю"** полі задано затримку, вона буде додана до запланованого часу.

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

Повідомлення буде надіслано у вказану дату й час.<br>

Якщо в **"Затримка перед відповіддю"** полі введено числове значення, ця затримка буде додана до запланованого часу.

<figure><img src="/files/51582375afa8a697ac49eff371ffa64743f02fb8" alt=""><figcaption><p><strong>Налаштування стрілки: Час надсилання + Затримка перед відповіддю</strong><br>Повідомлення буде надіслано <strong>через 30 хвилин після</strong> запланованого часу <strong>08:28</strong>, тобто о <strong>08:58 17 червня</strong>.</p></figcaption></figure>

<figure><img src="/files/b346b5de73417b2d72108ac2b7504ed1b907b8b7" alt=""><figcaption><p>У картці клієнта ви можете переглянути <strong>дату й час</strong> запланованого повідомлення з урахуванням затримки.</p></figcaption></figure>

Для вказання часу можна використовувати змінні.

Змінну часу можна задати або в **константах проєкту** або визначити в **Калькуляторі**.

<figure><img src="/files/114fe18c72abc5907d9b36b7d9b0cc637ff5959a" alt=""><figcaption><p>Давайте визначимо змінну в <strong>Калькуляторі</strong>.</p></figcaption></figure>

Так само можна використати **дату надсилання** вказавши її у форматі **ДД.ММ.РРРР**.

<figure><img src="/files/5958b79d2e1f93e1f716a94f70430b7e2e93d257" alt=""><figcaption><p>У <strong>полі "Час надсилання"</strong> вкажіть змінну.</p></figcaption></figure>

### **Надсилати, якщо дата вже минула** (перемикач)

Якщо запланований час повідомлення на вказану дату вже минув, і **перемикач "Надсилати, якщо дата вже минула"** увімкнено, повідомлення буде заплановано на наступний день.&#x20;

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

{% hint style="warning" %}
Поле **перемикач "Надсилати, якщо дата вже минула"** перемикач працює ЛИШЕ у поєднанні з датою надсилання повідомлення.
{% endhint %}

**Сценарій 1:** На стрілці встановлено час надсилання 10:00, а **перемикач "Надсилати, якщо дата вже минула"** перемикач ВИМКНЕНО.\
Якщо клієнт входить у воронку та отримує **Повідомлення 1** о 16:34, наступне повідомлення буде **заплановано на наступний день**.

У запланованих повідомленнях буде текст із **Повідомлення 2** запланованого на наступний день о 10:00.

<figure><img src="/files/d7c856d726a9b5e436879d2baba23b19f5380d78" alt="" width="563"><figcaption><p>Повідомлення 2 НЕ БУДЕ надіслано з такими налаштуваннями, якщо клієнт увійшов у блок Повідомлення 1 після 10:00.</p></figcaption></figure>

**Сценарій 2:** На стрілці встановлено час надсилання 10:00, а **перемикач "Надсилати, якщо дата вже минула"** перемикач УВІМКНЕНО.

Клієнт входить у воронку та отримує **Повідомлення 1** о 16:34 23 лютого.

Повідомлення буде **заплановано на наступний день**.

У запланованих повідомленнях буде текст із **Повідомлення 2** запланованого на наступний день о 10:00.

<figure><img src="/files/20d84895d5ad2a1a643514d38ccaca742d7678ea" alt="" width="544"><figcaption><p>Налаштування стрілки: Час + Надсилати, якщо дата вже минула</p></figcaption></figure>

<div align="center"><figure><img src="/files/b9b5641326cb9c93688a848f1a00f96c1028474c" alt="" width="563"><figcaption><p><strong>Сценарій 2:</strong> Клієнт входить у <strong>Повідомлення 1</strong> блок 23 лютого після 10:00, із <strong>перемикач "Надсилати, якщо дата вже минула"</strong> увімкненим перемикачем на стрілці.</p></figcaption></figure></div>

**Сценарій 3:** На стрілці вказано **дату надсилання** і час надсилання 10:00.  **перемикач "Надсилати, якщо дата вже минула"** перемикач ВИМКНЕНО.

Якщо клієнт входить у воронку та отримує **Повідомлення 1** о 16:34, наступне повідомлення **НЕ буде заплановано на наступний день**.

Клієнт залишиться в **Повідомлення 1** блоці, і в діалозі не буде запланованих повідомлень.

<figure><img src="/files/8594e80e33e37be52c179cd8daf6638674130a19" alt=""><figcaption><p>Поле <strong>дату надсилання</strong> поле містить вбудовану змінну <code>current_date</code> = поточний день.</p></figcaption></figure>

### **Приклад**

Стрілка-таймер — це стрілка, перехід по якій відбувається після вказаної затримки. Вони відображаються як пунктирні лінії, а час затримки показується поруч.

На нашій схемі є кілька таких стрілок. Перша виходить із яскраво-зеленого **"Добрий день"** блоку. Для цієї стрілки встановлено затримку 0 секунд.

Як це працює: після того, як бот відповість клієнту **"Добрий день"**, наступне запитання **"Бажаєте оформити замовлення?"** одразу слідує далі.

<figure><img src="/files/21ed79c4e13171fe5015b6df951c4affbf3c4682" alt=""><figcaption></figcaption></figure>

Отже, щоб встановити затримку перед відповіддю, заповніть відповідне поле у формі налаштувань.\
Аналогічно, можна вказати точну дату й час надсилання повідомлення, заповнивши **"Час надсилання"** поля.

{% hint style="info" %}
Праворуч від **"Затримка перед відповіддю"** поля ви можете вибрати одиницю виміру: **секунди, хвилини, години, дні**.
{% endhint %}

{% hint style="warning" %}
Якщо ви використовуєте затримки разом з умовами порівняння змінних і **"Скасувати повідомлення за таймером"** вимкнули **#{question}** у полі **"Рядки, які ігнорувати"** .
{% endhint %}

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

### **Йти один раз**

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

Якщо цей перемикач увімкнено, користувач зможе пройти через зв’язок лише один раз під час розмови з ботом. Водночас повідомлення буде заплановано стільки разів, скільки виконується умова для запланування повідомлення, пов’язана зі стрілкою.

{% hint style="warning" %}
**"Йти один раз"** є <mark style="color:red;">НЕ те саме</mark> що **планування** переходу за стрілкою лише один раз.
{% endhint %}

Розгляньмо сценарії спрацьовування стрілки з увімкненим перемикачем **"Перехід один раз"** розгляньмо:

**Йти один раз** + **Скасувати повідомлення з таймером**

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

Якщо **Скасувати повідомлення з таймером** перемикач увімкнено на стрілці, то під час повторного входу клієнта до **Повідомлення 1** блоку раніше заплановані повідомлення буде скасовано, і залишиться лише останнє заплановане повідомлення.

Поле **Перехід один раз** перемикач також увімкнено. Це означає, що після того, як перехід через стрілку до **Повідомлення 2** відбудеться, його більше не буде заплановано.

**Лише один перехід (інші перемикачі вимкнено).**

Якщо в налаштуваннях стрілки увімкнено лише **Перехід один раз** перемикач, нові повідомлення й надалі будуть заплановуватись **доти, доки фактичний перехід** через стрілку не відбудеться.

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

Клієнт входить у **Повідомлення 1** блок, і перехід до **Повідомлення 2** заплановано.\
Поки користувач не отримає текст із **Повідомлення 2**, переходи й надалі будуть заплановуватись.

Поле **"Перехід один раз"** перемикач спрацьовує **ЛИШЕ ПІД ЧАС ФАКТИЧНОГО ПЕРЕХОДУ**.\
Після переходу до **Повідомлення 2**, майбутні входи до **Повідомлення 1** більше не будуть **планувати перехід** за цим стрілкою.&#x20;

{% hint style="success" %}
Будьте уважні з налаштуваннями та завжди тестуйте різні сценарії поведінки користувача в боті.
{% 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/uk/chatbot/builder/zyednannya/zyednannya-z-taimerom-poki-taimeri-propuskayemo-andrii-skazav-sho-voni-vimkneni-v-mavi.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.