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

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

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

Обзор

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

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

Где найти

НастройкиTelegram оповещения в боковом меню.

Страница «Оповещения» с секциями Telegram и MAX
Страница «Оповещения». Сверху — секция Telegram-оповещений со статусом, группой и полем Chat ID. Справа — пошаговая инструкция по настройке. Ниже — секция MAX-оповещений.

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

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

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

1

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

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

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

2

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

Leadarr предоставляет готового бота — создавать своего не нужно.

  1. Откройте вашу Telegram-группу.
  2. Перейдите в Управление группойАдминистраторыДобавить администратора.
  3. Найдите бота Leadarr и добавьте его.
  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. Бот ответит JSON-данными, где будет поле chat.id.
  4. Скопируйте числовое значение (например, -1001234567890).
Chat ID супергруппы всегда начинается с -100 и содержит 13 цифр.

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

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

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

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

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

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