# Динамические Фоллоу-апы

**Динамические фоллоу-апы** служат для того, чтобы автоматически подстраивать время отправки сообщения под конкретную ситуацию клиента, делая напоминания более **персонализированными**. Помимо шаблонных интервалов система теперь может учитывать важные даты и события из диалога, отправляя сообщения именно тогда, когда они наиболее уместны.

Например, если клиент записался на определённое время, напоминание придёт именно перед визитом, а не через фиксированный интервал времени.

## Добавление и формирование Динамического фоллоу-апа

{% hint style="success" %}
Рассмотрим создание **динамических фоллоу-апов** на примере напоминаний клиента о записи на сеанс.
{% endhint %}

Чтобы добавить возможность формирования динамического фоллоу-апа в диалоге, необходимо создать новое Действие.

1. Перейдите во вкладку **Действия** и нажмите **Добавить**

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

2. Выберите тип шага **Установить фоллоу-ап**

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

3. Заполните поля общих настроек во вкладке **Условия срабатывания**

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

4. Добавьте **Аргументы во вкладке Переменные действия**

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

{% hint style="success" %}
В нашем случае напоминаний клиенту будет 3. Поэтому, прописываем 3 аргумента — каждый аргумент будет отвечать за отправку напоминания по своему собственному сценарию:

* **datetime\_now** — уведомление в момент записи
* **datetime\_one\_days\_before** — уведомление за 1 день до события
* **datetime\_two\_hour\_before** — уведомление за 2 часа до события
  {% endhint %}

5. Переходим в раздел **Шаги действий, н**ажимаем **Добавить шаг** и выбираем из списка **Установить фоллоу-ап**:

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

Заполняем нужный аргумент в поле **Дата-Время запуска фоллоу-апа** нажав на **шестеренку**⚙️ справа.

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

{% hint style="danger" %}
Так как у нас в примере 3 напоминания, создаем 3 шага. Для каждого напоминания (**аргумента**) необходимо добавить свой шаг. **Нельзя** в один шаг добавлять сразу **все** три аргумента.
{% endhint %}

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

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

6. Теперь в каждом шаге нужно **настроить сообщение**, которое будет отправлено **пользователю**:

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

{% hint style="success" %}
*Значение флагов:*

* **Никакой флаг не включен** — текст из поля **Сообщение** будет отправлен пользователю именно так, как он прописан.
* **Вызвать бота** — позволяет прописать инструкции боту, какие действия он должен совершить в момент выполнения данного действия. (например, сгенерировать сообщение и вызвать файл базы знаний)
* **Сгенерировать сообщение** — позволяет прописать инструкцию для бота, какое он должен сгенерировать текстовое сообщение для отправки пользователю.
  {% endhint %}

В нашем случае мы будем использовать функцию **Вызвать бота:**

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

Нажимаем Сохранить

7. Аналогично **Настраиваем шаг 2 и шаг 3** и формируем отправку сообщения **для каждого** из намеченных напоминаний. Нам необходимо в конечном итоге добавить в это действие **Три отдельных шага**:

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

8. Нажимаем на **шестеренку**⚙️ справа от кнопки **Добавить шаг** и выбираем **Правила ответа боту** — **Все:**

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

Нажимаем **Сохранить.**

9. В качестве **аргументов** может быть передано не только **дата - время**, но и любые другие аргументы, которые можно использовать в качестве шаблона для генерации сообщения.

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

*Для того, чтобы добавить аргумент к шаблону отправляемого напоминания, перейдите в настройку шага и вставьте в нужном месте текста сформированный аргумент:*

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

{% hint style="success" %}
Вы можете сформировать **любой** необходимый аргумент, прописав Боту необходимые **инструкции**.
{% endhint %}

10. Далее в промпте надо добавить инструкции, по которым Бот будет добавлять динамические фоллоу-апы к диалогу и формировать необходимые аргументы.

{% tabs %}
{% tab title="Инструкция для бота под наш пример" %}
{% code overflow="wrap" %}

```
При успешной записи клиента вызови функцию notify_customer и передай в неё три даты: текущую дату и время, дату и время за 1 день до назначенной встречи (события), дату и время за 2 часа до назначенной встречи (события).
```

{% endcode %}
{% endtab %}

{% tab title="Инструкция для формирования аргумента" %}
{% code overflow="wrap" %}

```
При успешной записи клиента сформируй аргумент {service_description}, используя название и описание услуги, на которую записался клиент, и вызови функцию notify_customer, передав в неё три даты: текущую дату и время, дату и время за 1 день до назначенной встречи (события), дату и время за 2 часа до назначенной встречи (события) и аргумент {service_description}.
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Где смотреть запланированные напоминания

Увидеть полный список запланированных напоминаний в рамках конкретного диалога можно перейдя в раздел Чаты:

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

{% hint style="success" %}
Так как у нас по сценарию **первое уведомление** отправляется сразу после успешной записи клиента на сеанс, то, открыв список запланированных **фоллоу-апов**, мы видим два оставшихся запланированных напоминания.

**Первое уведомление** уже успешно отправлено в чат.
{% endhint %}

## Отмена и изменение Динамического фоллоу-апа

{% hint style="info" %}
В процессе работы с динамическими фоллоу-апами может возникнуть необходимость отменить уже запланированные напоминания — например, при переносе события, изменении даты встречи или отмене услуги. Для этого предусмотрены два основных способа:
{% endhint %}

1. **Встроенная опция удаления старых фоллоу-апов при их установке.**

В настройках шага «Установить фоллоу-ап» можно включить параметр\
\&#xNAN;**«Удалить все напоминания, связанные с шагом в диалоге при активации шага»**.\
При повторном вызове этого шага все ранее установленные напоминания будут автоматически удалены и заменены новыми.

{% hint style="warning" %}
Включить эту настройку нужно только в первом шаге, иначе при установке, будут удаляться все напоминания, кроме последнего.
{% endhint %}

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

**Плюсы подхода:**

* Упрощает сценарий — не нужно отдельного действия для отмены.
* Полезно при сценариях с регулярным переносом даты (автоматическая замена).
* Меньше шагов в настройке.

**Минусы:**

* Меньше гибкости — удаляются все напоминания, связанные с шагом, без возможности частичного выбора.
* Нельзя отменить напоминания, без установки новых, работает больше, как функция переноса напоминаний

2. **Использование отдельного действия «Отменить фоллоу-ап»**

В этом случае создаётся отдельное действие в разделе **Действия**, которое полностью отвечает за удаление ранее установленных напоминаний.

<figure><img src="/files/01GhjEvSzGukLcHcU5eI" alt=""><figcaption></figcaption></figure>

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

Включаем функцию **Отменить все фолоу-апы (Напоминания) диалога.**

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

#### Заполняем название и описание функции.

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

#### Нажимаем Сохранить.

{% hint style="info" %}
В главной инструкции прописываем следующее:

При отмене напоминаний вызови функцию cancel\_follow\_ups().
{% endhint %}

**Плюсы подхода:**

* Полный контроль: можно явно вызывать отмену только тогда, когда это необходимо.
* Чёткая структура сценария — отмена не смешивается с логикой установки.

**Минусы:**

* Требуется дополнительный шаг в сценарии и отдельная логика вызова.
* Неудобно при частых переносах — придётся вызывать два действия (отмена + установка).

{% 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.suvvy.ai/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki/dinamicheskie-follou-apy.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.