Документация /Telegram-оповещения

Telegram-оповещения

Уведомления о сообщениях ИИ-агента в вашей Telegram-группе — командный мониторинг.

Обзор

Telegram-оповещения позволяют получать уведомления о новых сообщениях ИИ-агента прямо в Telegram-группу. Каждое сообщение от клиента или ответ агента будет дублироваться в вашу группу, чтобы вы могли контролировать работу без захода в Leadarr.

Не путайте с Telegram-коннектором. Коннектор — канал для общения агента с клиентами. Telegram-оповещения — односторонние уведомления для вас о событиях в системе.

Где найти

Настройки → Оповещения в боковом меню, вкладка Telegram. Рядом — вкладка MAX: оба вида оповещений можно включить одновременно.

Страница «Оповещения» с секциями Telegram и MAX
Страница «Оповещения», вкладка Telegram: имя бота с кнопкой «Скопировать», статус подключения, поле Chat ID. Справа — пошаговая инструкция по настройке.

Что отображается на странице

ЭлементОписание
СтатусПодключено (зелёный) или Не подключено (серый)
ГруппаНазвание подключённой Telegram-группы
Bot«Бот активен» (зелёный) или «Бот недоступен» (оранжевый)

Пошаговая настройка

1

Создайте Telegram-супергруппу

  1. Откройте Telegram и создайте новую группу.
  2. Перейдите в Настройки группы.
  3. Включите «Темы» (Topics) — это превратит группу в супергруппу.

Темы нужны для структурирования уведомлений — каждый диалог агента может создавать отдельную тему.

2

Добавьте бота Leadarr в группу

Leadarr предоставляет готового бота — создавать своего не нужно. Его имя показано на странице оповещений (это @velocity_alert_bot, рядом есть кнопка «Скопировать»).

  1. Откройте вашу Telegram-группу.
  2. Перейдите в Управление группой → Администраторы → Добавить администратора.
  3. Найдите @velocity_alert_bot и добавьте его.
  4. Убедитесь, что у бота есть права управления темами (Manage Topics).
Бот должен быть добавлен именно как администратор с правами на управление темами. Без этих прав уведомления не будут приходить.
3

Узнайте Chat ID группы

Подробная инструкция — в следующем разделе.

4

Подключите в Leadarr

  1. Перейдите в Настройки → Оповещения, вкладка Telegram.
  2. Вставьте Chat ID в поле «Chat ID группы».
  3. Нажмите «Подключить».

При успешном подключении появится зелёный статус «Подключено» и название группы.

Как узнать Chat ID группы

Chat ID — числовой идентификатор вашей группы. Как его получить:

  1. Отправьте любое сообщение в вашу группу.
  2. Перешлите это сообщение боту @raw_data_bot в Telegram.
  3. Бот пришлёт техническую информацию о сообщении — найдите среди неё строку "chat": и в ней значение "id":.
  4. Скопируйте это число (например, -1001234567890).
Chat ID супергруппы — отрицательное число, начинается с -100. Копируйте его целиком, вместе с минусом.

Что приходит в уведомлениях

  • Новые входящие сообщения от клиентов;
  • Ответы ИИ-агентов;
  • Ошибки доставки сообщений;
  • Информация о новых диалогах.

Устранение проблем

ПроблемаРешение
Уведомления не приходятПроверьте, что бот добавлен как администратор с правами
Статус «Бот недоступен»Повторно добавьте бота в группу как администратора
Ошибка подключенияПроверьте Chat ID через @raw_data_bot и убедитесь, что бот в группе
Бот не может управлять темамиВключите Topics в настройках группы и дайте боту право Manage Topics

Частые вопросы

Чем это отличается от MAX-оповещений?
Telegram-оповещения — одна супергруппа на всю организацию. MAX — отдельный чат под каждого агента, можно гибко разделить уведомления по командам.
Можно ли подключить несколько групп?
Нет, в текущей версии поддерживается одна Telegram-группа на организацию.
Нужно ли создавать своего бота?
Нет. Leadarr предоставляет готового бота — вам нужно только добавить его в вашу группу.
← Предыдущее Тестирование