> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Оповещения

> Сообщения о сбоях кампаний и агентов в Telegram, Slack или кабинете: как создать уведомление, подключить чат и настроить защиту от шума.

# Оповещения

Раздел **«Администрирование» → «Оповещения»** сообщает о сбоях ваших кампаний и агентов: кампания остановилась, звонки не проходят, агент не смог перевести звонок, результаты звонков не доходят до вашей системы. Сообщение приходит в Telegram, в Slack или остаётся в кабинете.

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

В разделе две вкладки:

* **«Уведомления»** — что отслеживать и куда слать. Каждое уведомление — это объект (кампания или агент), набор оповещений и чаты для отправки.
* **«Журнал отправок»** — что и когда ушло, что придержано и что не доставлено.

![Раздел «Оповещения» без уведомлений](https://mintcdn.com/hubtalk/0CLLnqL-ushSlhv0/images/v4_alerts_page.png?fit=max\&auto=format\&n=0CLLnqL-ushSlhv0\&q=85\&s=6aa6d8f92e9600dd30f2e583e50df3f3)

## Новое уведомление

Нажмите **«Новое уведомление»**. В окне пять блоков.

![Окно «Новое уведомление»: что отслеживать и оповещения кампании](https://mintcdn.com/hubtalk/0CLLnqL-ushSlhv0/images/v4_alerts_new.png?fit=max\&auto=format\&n=0CLLnqL-ushSlhv0\&q=85\&s=cb7b9ff1f626bddbc7d17c3f6d8cec2d)

1. **Название.** Подставляется само, например «Оповещения: Все кампании», его можно заменить.
2. **Что отслеживать** — **«Кампания обзвона»** (её ход и транк, через который она звонит) или **«Агент»** (его звонки и то, от чего он зависит). Ниже выберите конкретную кампанию или агента — в списке есть поиск — или **«Все кампании»** / **«Все агенты»**. «Все» включают и те, что будут созданы позже.
3. **Оповещения** — что отслеживать у выбранного объекта, список ниже. В новом уведомлении уже отмечены критичные оповещения, **«Выбрать все»** отмечает остальные. У части оповещений есть порог: поле появляется под оповещением, когда оно отмечено. Справа видно, сколько объектов оповещение отслеживает, например «Транки ваших кампаний: 1» или «Вебхуки ваших агентов: 2».
4. **Куда отправлять** — один или несколько каналов, см. [ниже](#куда-отправлять). Без канала уведомление не сохранится.
5. **Защита от шума** — повторы и тихие часы, см. [ниже](#защита-от-шума).

**«Создать уведомление»** сохраняет и включает его. Сообщения пишутся на языке вашего кабинета: язык сохраняется вместе с уведомлением.

В списке уведомлений у каждой строки есть переключатель **«Уведомление включено»** и меню с **«Изменить»** и **«Удалить»**. Удалённое уведомление сразу перестаёт приходить, журнал отправок сохраняется. Если кампанию или агента из уведомления удалили, строка подписана: «Кампания или агент удалены — уведомление ничего не отслеживает».

## Что можно отслеживать

У каждого оповещения есть уровень, он виден цветной точкой: **«Критично: звонки стоят»**, **«Предупреждение»** или **«Информация»**. Пороги можно поменять: процент — от 1 до 99, окно — от 1 до 1440 минут, количество — от 1 до 100. Свой тип оповещения добавить нельзя.

### Кампания

| Оповещение | Когда приходит | Порог по умолчанию | Уровень |
| - | - | - | - |
| **Остановка кампании** | Кампания приостановлена, завершена или отменена | — | Информация |
| **Обзвон не идёт в рабочее время** | Кампания запущена, есть контакты, готовые к звонку, но новые звонки не начинаются | Нет новых звонков 20 мин | Критично |
| **Много звонков без соединения** | Много попыток без разговора с абонентом. Считаются технические сбои: «Нет ответа», «Занято», автоответчик и отказ абонента не входят | Больше 60 % наборов за 30 мин | Предупреждение |
| **Обзвон задерживается: все линии заняты** | Звонков, отложенных из-за занятых линий, становится больше две проверки подряд | — | Предупреждение |
| **Много несуществующих номеров** | Оператор связи часто отвечает, что номер не существует | Больше 10 % наборов за час | Информация |

### Агент

| Оповещение | Когда приходит | Порог по умолчанию | Уровень |
| - | - | - | - |
| **Сбой агента во время звонка** | Агент не смог сформировать ответ или выполнить действие. Одно оповещение на звонок | — | Критично |
| **Не удалось перевести звонок на сотрудника** | По номеру для перевода никто не ответил или перевод отклонён. Одно оповещение на звонок | — | Критично |
| **Звонки агента завершаются с ошибкой** | Звонков, отмеченных платформой как ошибочные, набралось столько, сколько в пороге | 5 звонков за 15 мин | Предупреждение |
| **Звонки завершаются из-за тишины** | После соединения речь не слышна, и звонки завершаются | Больше 15 % отвеченных звонков за 60 мин | Предупреждение |
| **Возможное недовольство в разговорах** | Анализ звонков видит недовольство собеседников | Больше 20 % разобранных звонков за 60 мин | Информация |
| **Автоматическая проверка отметила звонок** | Проверка агента завела по звонку [инцидент](https://docs.hubtalk.ai/ru/v4/platform/incidents.md) с уведомлением. Одно оповещение на инцидент | — | Предупреждение |
| **Не удаётся передать результаты звонков** | Отправки вебхука агента подряд не доставлены | 5 неудачных доставок подряд | Критично |
| **Не удалось обработать файл базы знаний** | Файл или база знаний агента перешли в ошибку. Приходит один раз, при переходе в ошибку | — | Предупреждение |

![Оповещения агента с порогами по умолчанию](https://mintcdn.com/hubtalk/0CLLnqL-ushSlhv0/images/v4_alerts_agent.png?fit=max\&auto=format\&n=0CLLnqL-ushSlhv0\&q=85\&s=f6e3f15f2be00e94851a198e5b8df4e2)

### И у кампании, и у агента

| Оповещение | Когда приходит | Порог по умолчанию | Уровень |
| - | - | - | - |
| **Не удаётся совершить звонки** | Последние звонки через телефонное подключение кампании или агента — все подряд с отказом телефонии | 5 неудачных звонков подряд | Критично |
| **Не удалось применить настройки телефонии** | Изменение телефонного подключения сохранено, но не применилось. Приходит сразу, не дожидаясь неудачного звонка | — | Критично |

**Доли считаются на достаточной выборке.** Оповещения с процентом ждут минимум 10 звонков (у «Много несуществующих номеров» — 20), поэтому пара неудачных звонков тревогу не поднимает. Оповещение по доле или количеству приходит не чаще раза за своё окно.

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

## Куда отправлять

Чаты подключаются прямо в окне уведомления, в блоке **«Куда отправлять»**. Каналов может быть сколько угодно, у каждого своё название. Чат сохраняется, только если принял пробное сообщение.

![Куда отправлять и защита от шума](https://mintcdn.com/hubtalk/0CLLnqL-ushSlhv0/images/v4_alerts_send.png?fit=max\&auto=format\&n=0CLLnqL-ushSlhv0\&q=85\&s=f44f8c85e7c27801d089bf1430e2d04d)

* **HubTalk AI** — флажок. Наружу ничего не уходит: оповещение попадает в журнал отправок, а у пункта меню **«Оповещения»** появляется счётчик новых.
* **Telegram** — откройте список Telegram → **«Добавить Telegram»**:

  1. Добавьте бота в группу для оповещений. Имя бота показано в окне подключения, по клику открывается его страница в Telegram. Если используете канал, добавьте бота как администратора и разрешите ему публиковать сообщения.
  2. Откройте группу или канал в Telegram Web. В адресной строке скопируйте число после `#` вместе с минусом, например `-1001234567890`.
  3. Вставьте число в поле **«ID чата»** и нажмите **«Проверить и сохранить»**. Бот отправит тестовое сообщение.

  Свой бот и токен не нужны.
* **Slack** — откройте список Slack → **«Добавить Slack»** и вставьте Incoming Webhook URL вида `https://hooks.slack.com/services/…` (в Slack: приложение → Incoming Webhooks → Add New Webhook to Workspace). Один вебхук — один канал Slack.

Подключённый чат можно проверить кнопкой **«Отправить тест»** — результат виден в журнале отправок. **«Удалить чат»** убирает его из всех уведомлений организации, сами уведомления остаются. ID чата и адрес вебхука хранятся зашифрованными и показываются только частично.

**Telegram:**

* **Группа стала супергруппой** — у неё сменился ID, подключите чат заново.
* **Бота удалили из чата или сняли с него права** — в журнале будет «Telegram отклонил сообщение».
* **В группе с темами** сообщения идут в общую тему, выбрать тему нельзя.

## Защита от шума

* **Повторы** — пауза между одинаковыми оповещениями по одному объекту: **«Каждый раз»**, **«Не чаще раза в 5 мин»**, **10 мин** (по умолчанию), **30 мин** или **«Не чаще раза в час»**. Считается на каждое оповещение и объект; придержанные видны в журнале.
* **Тихие часы** — по умолчанию с 22:00 до 08:00 по часовому поясу организации, окно может переходить через полночь. В это время некритичные оповещения придерживаются, а когда тихие часы заканчиваются, приходят одной сводкой. В сводке до 20 строк, остальное — строкой «и ещё N».
* **«Критичные — и ночью»** — включено, когда включены тихие часы: оповещения уровня «Критично: звонки стоят» уходят сразу.

На HubTalk AI тихие часы не действуют — он никого не будит. Повторы действуют.

Одно событие — одно оповещение, даже если проверка прочитала тот же период ещё раз.

## Сообщение

В сообщении заголовок, две-три строки фактов и ссылка в кабинет. Номер абонента в сообщение не попадает. Ссылка ведёт к месту, где видна проблема:

| Оповещение | Что открывается по ссылке |
| - | - |
| Возможное недовольство в разговорах | Звонки агента с отрицательным настроением |
| Звонки завершаются из-за тишины | Звонки агента, завершённые из-за тишины |
| Звонки агента завершаются с ошибкой | Звонки агента с отметкой «ошибка» |
| Много звонков без соединения | Звонки кампании без соединения |
| Много несуществующих номеров | Звонки кампании с неверным номером |
| Сбой агента, неудачный перевод, отметка проверки | Сам звонок |
| Остановка кампании, обзвон не идёт, обзвон задерживается | Карточка кампании |
| Телефония | Раздел **«Телефония»** |
| Не удаётся передать результаты звонков | Редактор агента |
| Не удалось обработать файл базы знаний | Раздел **«Базы знаний»** |

История звонков фильтрует целыми днями, поэтому по ссылке открываются такие звонки за весь день.

## Журнал отправок

Вкладка **«Журнал отправок»** — таблица со столбцами **«Время»**, **«Уведомление и оповещение»**, **«Канал»** и **«Статус»**, с фильтром по статусу. Журнал хранится 30 дней.

* **«Доставлено»** — сообщение принято. Пометка «Включено в сводку за тихие часы» — оно ушло в утренней сводке.
* **«Придержано»** — не отправлено сейчас: «Повторное оповещение не отправлено: ещё не прошёл заданный интервал» или «Отправка отложена на время тихих часов».
* **«Не доставлено»** — с причиной: «Канал для оповещений не подключён», «Telegram отклонил сообщение» (бот не в чате, неверный ID, нет права публиковать), «Slack отклонил сообщение» (вебхук отозван или адрес неверный), «Не удалось отправить сообщение из-за ошибки сети».

**«Показать сообщение»** в строке открывает текст сообщения. Для неотправленного — текст, который ушёл бы.

Если оповещение не пришло, первым делом смотрите его строку в журнале: причина там.

## Кто что может

* **Администратор и разработчик** создают, изменяют и удаляют уведомления, подключают и удаляют чаты, отправляют тест.
* **Менеджер и участник** видят уведомления и журнал с пометкой «Только просмотр. Создавать, изменять и удалять уведомления могут разработчик и администратор».

Каждая организация видит только свои уведомления, чаты и журнал. Подробнее о ролях — [«Роли»](https://docs.hubtalk.ai/ru/v4/platform/roles.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.