# Оповещения от Савви

Савви может присылать вам оповещения в различных ситуациях, таких как:

* **Закончившийся** баланс / Баланс **скоро закончится**
* Сработал определенный **файл** **/ действие** *(по указанию в личном кабинете)*
* Статус в канале был изменен
* Произошла ошибка при **выполнении действия / получении таблицы или большого файла из Google / ответе в канал**

*и других..*

В таком случае, можно подключить **оповещения от Савви** в **Telegram** и в **Max**

## Подключение в Telegram

{% stepper %}
{% step %}

### Перейдите в раздел "Интеграции" в настройках бота и выберите "Оповещения в Telegram"

<figure><img src="/files/WBFtdKX4KSOLUdnSrU1m" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выберите желаемый способ оповещений (можно подключить несколько чатов / аккаунтов)

<figure><img src="/files/pehiTn0CgvZgZ13aVPTZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Нажмите на кнопку "START BOT"

<figure><img src="/files/FD7Y6dGp9nUyNDmeCIm9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### После нажатия вы попадете в чат с ботом, где увидите сообщение

<figure><img src="/files/bf7H9mgmYYqcaJmyRfsh" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Готово!

### Как это работает?

Например, мы хотим, чтобы по требованию клиента в чат подключился живой человек.

Для этого, мы создаём файл в Базе знаний, который называется "Позвать менеджера" и включаем "**Уведомления в Telegram**".

Это нужно для того, чтобы в уведомлении пришла информация о том, что данный файл сработал.

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

{% hint style="warning" %}
**Важно**

Чтобы в чат подключился живой человек, нам нужно прервать ответы бота, иначе бот продолжит отвечать и дальше. Для этого мы включаем настройку "**Прерывать диалог**":
{% endhint %}

<figure><img src="/files/73lpJqjuag9kQtHgFb99" alt=""><figcaption></figcaption></figure>

Смотрим, как это будет выглядеть в чате:

Мы просим бота позвать менеджера

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

В это время в боте "Оповещения от Савви" нам пришло вот такое Уведомление:

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

Таким образом, Оповещения от Савви позволят Вам всегда быть в курсе, когда сработал тот или иной файл в ходе диалога с клиентом!

## Настройка шаблонов уведомлений

Каждый пользователь имеет возможность настроить текст уведомлений (при срабатывании файла базы знаний) под себя.

Для этого существуют различные переменные, вместо которых будут подставляться реальные значения.

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

Ниже описаны значения переменных:

* **bot** - обозначает название бота, может быть полезно, когда внутри учетной записи Савви существует больше 1 бота и нужно понимать от кого именно пришло уведомление.
* **source** - показывает источник или идентификатор клиента, на котором сработал файл
* **document** - показывает файл, который сработал при вызове уведомления
* **suvvy\_chat** - чат на стороне личного кабинета Савви - позволяет сразу перейти в диалог для анализа, без необходимости перехода в источник сообщений и дальнейшего поиска на стороне Савви
* **links** - ссылка на диалог на стороне источника, например, в случае использования CRM-систем, ссылка ведет на сделку и диалог внутри СРМ.
* **user\_email** - электронный адрес учетной записи на стороне Савви
* **utc\_now** - время по UTC в котором сработал вызов уведомления
* **summary** - создание короткого пересказа диалога, либо другой инструкции, котрая задана в поле **Инструкция для саммари**.

### Краткий пересказ диалога в уведомлениях

Поле **Инструкция для саммари** позволяет описать, что именно мы хотим передать в уведомлении за место переменной **summary**. По умолчанию, в поле задана следующая инструкция:

> Составь краткое изложение диалога на русском языке.

## Отключение уведомлений

Отключить уведомления от конкретного бота можно осуществить черех нажатие по кнопке **Отключить**:

<figure><img src="/files/1GE8mpg2Tg4b5EYBlnYK" alt=""><figcaption></figcaption></figure>

## Подключение в Max

{% stepper %}
{% step %}

### Перейдите в раздел "Интеграции" в настройках бота и выберите "Оповещения в Мах"

<figure><img src="/files/WG2R05YoNp5om47e5NcP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Нажимаем "Подключить в свой Мах"

<figure><img src="/files/wAPTP9NRDjeugBnLqsay" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Нажимаем "Запустить бота"

<figure><img src="/files/o2v3H7ytlf9BLJ8fzXne" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Нажимаем "Начать"

<figure><img src="/files/1ix8182O7pjoSYZCjXoA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Получаем сообение о том, что успешно привязали оповещения к боту

<figure><img src="/files/MdOh7dv3B55Eo5hvriSW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Настройки на стороне Савви

После поклчения нам оступны слеуие настройки на стороне Савви:

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

**Язык оповещений** — можем выбрать русский или английский

**Оповещения о агентах и диалогах** — отметив данный флаг Вы будете получать оповещения о событиях, которые произошли в диалоге, например вызов файла базы знаний или смена агента в случае настроенной мультиагентности

**Оповещения пользователя** — отметив этот флаг, Вы будете получать оповещения о балансе, рассылках и пр.:

<figure><img src="/files/EaCw5ACwbNeV3QlMEEFP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Настройка шаблонов уведомлений

Настраивание оповещения по индивидуальному шаблону

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

Ниже описаны значения переменных:

* **bot** - обозначает название бота, может быть полезно, когда внутри учетной записи Савви существует больше 1 бота и нужно понимать от кого именно пришло уведомление.
* **source** - показывает источник или идентификатор клиента, на котором сработал файл
* **document** - показывает файл, который сработал при вызове уведомления
* **suvvy\_chat** - чат на стороне личного кабинета Савви - позволяет сразу перейти в диалог для анализа, без необходимости перехода в источник сообщений и дальнейшего поиска на стороне Савви
* **links** - ссылка на диалог на стороне источника, например, в случае использования CRM-систем, ссылка ведет на сделку и диалог внутри СРМ.
* **user\_email** - электронный адрес учетной записи на стороне Савви
* **datetime\_now** - дата, в которую сработало уведомление
* **utc\_now** - время по UTC, в котором сработал вызов уведомления
* **summary** - создание короткого пересказа диалога, либо другой инструкции, котрая задана в поле **Инструкция для саммари**.

### Краткий пересказ диалога в оповещениях

Поле **Инструкция для саммари** позволяет описать, что именно мы хотим передать в уведомлении за место переменной **summary**. По умолчанию, в поле задана следующая инструкция:

> Make a 3-sentence summary of the dialogue in English. No more than 1500 characters.
> {% endstep %}

{% step %}

### Отключение уведомлений

Отключить уведомления от конкретного бота можно осуществить черех нажатие по кнопке **Отключить**:

<figure><img src="/files/6NojTnwvCnviY42Ox5u1" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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/opovesheniya-ot-savvi.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.