> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md).

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

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

* **Закончившийся** баланс / Баланс **скоро закончится**
* Сработал определенный **файл** **/ действие** *(по указанию в личном кабинете)*
* Статус в канале был изменен
* Произошла ошибка при **выполнении действия / получении таблицы или большого файла из 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.