Skip to main content

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

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

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

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

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

а,
  1. Создать бота в Telegram
    2. Telegram.
  2. Это удобно для управляющего, администратора смены, технического специалиста и других ответственных сотрудников, которые должны быстро видеть рабочие события клуба.

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

  3. Нуказан в настройках конкретного типа уведомлений.

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

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

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

    Важно.

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

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

    Бот создается вчерез официальнутри самого телеграма, с помощью Telegram-бота @BotFather.

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

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

      и в

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

      галочки.)

    image.pngimage.png

    1. 2. Нажмите Запустить, длячтобы активировациить бота BotFatherBotFather.

    2. 3. Выберите или напечатайте и оОтправьте команду  /newbot.

    image.pngimage.png

    1. 4. ДУкайжите имя ботуа.

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

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

      никнейм. Никнейм

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

    3. 5. После того как вы выберите подходящее имя бот будет создан.ия ВыBotFather отполучравите сообщение со ссылкой на бота t.me/и токеникнейом_бота,.

      ре

      Скомпируйте токендации. Он по надобитстройке аватарки, описание бота и список командя для настройки бота, так же секретныйтокен который необходимо будет далее вставить в полея TOKEN_BOT на домене.

    image.pngimage.png

    Получение CHANNEL_ID

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

    Получение CHANNEL_ID

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

      н

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

    image.pngimage.png

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

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

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

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

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

    1. Замяените каTOKEN_BOT нала

      И редактируем ее, токен, чкоторый идётвы послеучили “t.me/”от вписывBotFather.

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

      image.png

      То есть, ссылке на будканал.

    image.png

    Приметр вссыглядеть таки:

    https://api.telegram.org/botТОКЕНБОТА/bot123456:ABCDEF/sendMessage?chat_id=@tetmessage@testmessage&text=ЛюбПройверка

    1. Нажмитекст Enter.

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

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

      Значение оиз этом что текст отправлен, а в группе будет сообщение которое вы вписали в конце Любойтекст и ID канала который нам нужен, во второй строки и есть "id":-1234567890CHANNEL_ID. дЕго нужно скопированные цифрыть вместе с МИНУСОМминусом, если он есть в начале значения.

    Пример:

    "id": -1234567890

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

    -1234567890

    image.png

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

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

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

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

    <a href="tg://user?id=USER_ID">Имя сотрудника</a>

    Чтобы узнайтиь USER_ID, псолтрудник может открытьзователя в Telegram, найдите бота @userinfobot, напишижате емуь /start и сконпировать свой ID из ответит,а указав ваш ID

    • В группах ботакое.
    у

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

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

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

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

    image.pngimage.png

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

    П
    Токервн

    В поле Токеначально необходимо в указываетегорию Основные, вписатья токен бота, чкотобрый вы всеполучили работало: BotFather.

    • Токен -

      Этокен бота Обязательно!

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

      Фин. отчет

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

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

      Сменнуюые графуотчеты
      CHANNEL_ID

      В

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

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

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

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

    .

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

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

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

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

      Кинатегорииь для настройки Telegramв уведомлении.

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

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

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

      Заполните CHANNEL_ID

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

    image.pngimage.png

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

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

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

    image.pngimage.png

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

    image.png

    В
    Разделениеэтой категории налстра по топикам

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

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

    image.png

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

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

    image.pngimage.png

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

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

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

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

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

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

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

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