Skip to main content

Telegram-bot для уведомлений

Раздел Telegram-bot для уведомлений используется для отправки служебных сообщений клуба в Telegram. Через эту настройку можно подключить бота, указать канал или чат для уведомлений и распределить разные типы сообщений по нужным сотрудникам или темам.

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

Когда используется Telegram-bot

Telegram-bot подключают, когда сотрудникам нужно получать уведомления не в интерфейсе домена, а в Telegram. Это удобно для управляющего, администратора смены, технического специалиста и других ответственных сотрудников, которые должны быстро видеть рабочие события клуба.

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

Что нужно подготовить перед настройкой

Перед заполнением настроек на домене подготовьте три значения:

  1. TOKEN_BOT: токен Telegram-бота, который выдает BotFather после создания бота.
  2. CHANNEL_ID: идентификатор канала, группы или темы, куда должны приходить уведомления.
  3. Телеграм-тег сотрудника: username сотрудника или ссылка на пользователя через Telegram ID, если у сотрудника нет публичного username.

Важно. Токен бота дает доступ к отправке сообщений от имени бота. Не публикуйте токен в открытых чатах, не передавайте его посторонним сотрудникам и не вставляйте его в документы, к которым есть общий доступ.

Создание бота в Telegram

Бот создается через официального Telegram-бота @BotFather.

Создание бота в Telegram

  1. Откройте Telegram и в поле поиска введите @BotFather.

    Выберите официального бота Telegram. Возле имени официального бота отображается синий знак подтверждения.

image.png

  1. Нажмите Запустить, чтобы активировать BotFather.

  2. Отправьте команду /newbot.

image.png

  1. Укажите имя бота.

    Имя отображается пользователям в Telegram. Его можно написать в свободной форме, например Уведомления клуба.

  2. Укажите username бота.

    Username должен быть уникальным и обязательно заканчиваться на bot. Например: club_notifications_bot.

  3. После создания BotFather отправит сообщение со ссылкой на бота и токеном.

    Скопируйте токен. Он понадобится для поля TOKEN_BOT на домене.

image.png

Получение CHANNEL_ID

CHANNEL_ID нужен для того, чтобы система понимала, куда отправлять уведомления. Это может быть канал, группа или отдельная тема внутри группы.

Получение CHANNEL_ID

  1. Создайте канал или группу в Telegram, куда будут приходить уведомления.

    На время настройки канал удобнее сделать публичным, чтобы получить идентификатор через ссылку. После завершения настройки канал можно снова закрыть.

image.png

  1. Добавьте созданного бота в канал или группу.

  2. Выдайте боту права администратора.

    Без прав администратора бот может не отправлять сообщения в канал.

  3. Откройте браузер и подготовьте ссылку в таком формате:

https://api.telegram.org/botTOKEN_BOT/sendMessage?chat_id=@Имя_канала&text=Любой текст

  1. Замените TOKEN_BOT на токен, который вы получили от BotFather.

  2. Замените @Имя_канала на username вашего канала. Username указывается после t.me/ в ссылке на канал.

image.png

Пример ссылки:

https://api.telegram.org/bot123456:ABCDEF/sendMessage?chat_id=@testmessage&text=Проверка

  1. Нажмите Enter.

    Если бот и канал настроены корректно, в канале появится тестовое сообщение, а в браузере откроется технический ответ Telegram.

  2. Найдите в ответе строку "id".

    Значение из этой строки и есть CHANNEL_ID. Его нужно скопировать вместе с минусом, если он есть в начале значения.

Пример:

"id": -1234567890

Для настройки в домене нужно использовать значение:

-1234567890

image.png

Примечание. Если при переходе по ссылке Telegram возвращает ошибку, проверьте токен, username канала, права бота и наличие бота в канале или группе.

Получение Telegram-тега сотрудника

Telegram-тег нужен для упоминания конкретного сотрудника в уведомлениях. Если у пользователя есть публичный username, укажите его в формате @username.

Если у сотрудника нет публичного username, можно использовать ссылку на пользователя по его Telegram ID в формате:

<a href="tg://user?id=USER_ID">Имя сотрудника</a>
Чтобы узнать USER_ID, сотрудник может открыть бота @userinfobot, нажать /start и скопировать свой ID из ответа бота.

Упоминание работает по-разному в зависимости от места отправки уведомления:

  1. В группе пользователь получит уведомление об упоминании.
  2. В канале ссылка на пользователя будет кликабельной, но отдельное уведомление об упоминании может не прийти.

Настройка Telegram-бота на домене

После создания бота, получения CHANNEL_ID и подготовки Telegram-тегов можно перейти к настройке на домене.

image.png

Сначала заполните основные настройки.

Токен

В поле Токен указывается токен бота, который вы получили от BotFather.

Это обязательное поле. Без токена система не сможет отправлять сообщения через Telegram-бота.

Фин. отчет

В поле Фин. отчет указывается CHANNEL_ID канала или группы, куда должен приходить финансовый отчет.

Заполняйте поле только в том случае, если клуб должен получать финансовые отчеты в Telegram.

Сменные отчеты

В поле Сменные отчеты указывается CHANNEL_ID канала или группы, куда должны приходить отчеты по сменам.

Эта настройка важна для управляющего и сотрудников, которые контролируют закрытие смен и рабочие итоги администраторов.

Отчет в Telegram за каждый клуб отдельно

Настройка Отчет в Telegram за каждый клуб отдельно отключает отправку общего отчета в Telegram и заменяет его отдельными файлами по каждому клубу.

Эту настройку стоит использовать для сети клубов, если ответственным сотрудникам удобнее проверять данные по каждому клубу отдельно, а не через один общий файл.

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

Ниже расположены категории уведомлений по клубам. Для каждой категории можно указать:

  1. CHANNEL_ID канала, группы или темы, куда должны приходить уведомления.
  2. Телеграм-тег сотрудника, которого нужно упоминать в уведомлении.

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

Сообщить о проблеме и уведомления о покупках

В этой категории настраиваются сообщения, связанные с обращениями гостей и покупками.

Заполните CHANNEL_ID, если такие уведомления должны приходить в Telegram. При необходимости укажите Telegram-тег сотрудника, который должен получать упоминание.

image.png

Уведомления о завершении сессии и пересадке гостя

В этой категории настраиваются уведомления о завершении сессии и пересадке гостя.

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

image.png

Уведомления о ручной разблокировке и блокировке

В этой категории настраиваются уведомления о ручной разблокировке и блокировке.

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

image.png

Разделение уведомлений по темам

Если для уведомлений используется группа с темами, сообщения можно направлять не в общий чат, а в отдельные темы.

image.png

Чтобы найти идентификатор темы, откройте нужную тему в Telegram и посмотрите ссылку. В ссылке используются два значения:

t.me/c/1234567890/5
В этом примере:
  1. 1234567890: идентификатор канала или группы.
  2. 5: идентификатор темы.

Формат ссылки можно читать так:

t.me/c/ID_канала/ID_темы
image.png

Если в интерфейсе настройки предусмотрено отдельное поле для темы, укажите в нем ID_темы. Если отдельного поля нет, используйте формат, который принят в вашем домене для отправки сообщений в темы.

Как проверить настройку

После заполнения настроек проверьте отправку уведомлений.

  1. Убедитесь, что бот добавлен в канал или группу.
  2. Проверьте, что у бота есть права администратора.
  3. Проверьте, что в основных настройках указан корректный токен.
  4. Убедитесь, что CHANNEL_ID указан вместе с минусом, если минус есть в техническом ответе Telegram.
  5. Выполните действие, которое должно вызвать уведомление. Например, сформируйте тестовое событие по выбранной категории уведомлений.
  6. Проверьте, что сообщение пришло в нужный канал, группу или тему.
  7. Если в настройке указан Telegram-тег, проверьте, что упоминание отображается корректно.
Back to top