Skip to main content

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

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

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

К

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

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

ПосДлея настройки потребуются:

  • учётная запистемаь Telegram с доступом к @BotFather;
  • Telegram-божт, который будет отправлять сообщения;
    • в
  • токен укэтого ботаз;
  • чанный каналт, группуа или тему.канал Пдля получатель завнисит от того, какой CHANNEL_ID указан в настройках конкретного типая уведомлений.

    ;
    • Ч
  • права на добавление ботоа в выбранный чат;
  • Channel ID нужного чата;
  • message_thread_id, если уведомления должны подгостовиупать в опеределённую настройкой
    • ему;

    Перед

  • имя заполньзователя с символом @, если в сообщениях требуется упом инастроек на домение подготовьлучателя.

Как создатри значения:

  1. TOKEN_BOT: токень Telegram-бота,

  1. Откройте Telegram и найдите @BotFather.
  2. Проверьте имя пользователя. Официальный бот должен называться @BotFather и иметь отметку подтверждённой учётной записи.
  3. Запустите бота и отправьте команду /newbot.
  4. Укажите отобрый выдажаемое имя нового бота.
    5. BotFather
  5. Укажите имя пользователя бота. Оно должно быть уникальным и оканчиваться на bot, например club_notifications_bot.
  6. После создания бскота.
  7. CHANNEL_ID: пидентификатор канала, группы или темы, куда должны приходить уведомления.
  8. Телеграм-тег сотрудника: username сотрудника или ссылка на пользователя через Telegram ID, если у сотрудника нет публичного username.

Важно. Токен бота дает доступ к отправке сообщений от имени бота. Не публикуйте токен из сообщения @BotFather.

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

Создание бота в 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.

Как отовки Telegram-рытегов можно перейти кь настройки в LANGAME

Перейдите нв раздел дДомен → Рассылки → Настройка Telegram для уведомлений.

image.pngimage.png

СНа странице началаходятся заполните оснодвные настройки.:

  • «Токен
»;

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

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

Фин. отчет

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

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

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

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

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

  • «Отчеёт в Telegram за каждый клуб отдельно
    • ».

    Настройки каналов отправки перенесены в раздел «Настройка системных оповещений».

    Как указать токен бота

    1. Нажмите значок карандаша в строке «Токен».
    2. Вставьте токен, полученный от @BotFather.
    3. Нажмите галочку, чтобы сохранить значение.

    Чтобы закрыть поле без сохранения, нажмите крестик.

    image.png

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

    Отчёт по каждому клубу отдельно

    Переключатель «Отчеёт в Telegram за каждый клуб отдельно» определяет, как формируются отчёты для сети клубов:

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

    Изменение применяется сразу после нажатия переключателя.

    Э

    Как подготовить чат или канал

    1. Создайте группу, канал или выберите существующий чат.
    2. Добавьте созданного бота.
    3. Разрешите боту отправлять сообщения. Для канала добавьте его в число администратойкуров с правом публикации сообщений.
    4. Отправьте сообщение в чат. Если использовауеть длся стети клубовма, если отправьтетственным сообщение внутри неё.
    5. Получите идентификамторы удобнее проверячать данные по каждому клубу отдельно, а не через один общий файл.

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

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

      1. CHANNEL_ID канала, группы или темы,.
        2. куда
      д

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

      Как получить Channel ID

      Для нового бота без настроенного webhook идентификатор можно получить через метод getUpdates Telegram Bot API.

      1. Добавьте бота в нужный чат и отправьте в чат сообщение.
      2. Откройте в браузере адрес https://api.telegram.org/bot<ТОКЕН_БОТА>/getUpdates, заменив <ТОКЕН_БОТА> на токен.
      3. Найдите последнее сообщение или публикацию из нужного чата.
      4. Для группы найдите значение result → message → chat → id.
      5. Для канала найдите значение result → channel_post → chat → id.
      6. Скопируйте найденное значение целиком, включая знак минус.

      Нег пересылайте ссылку с токеном и закройте страницу после копирования идентификатора.

      Как получить message_thread_id

      Парам-етр message_thread_id нужен только для группы с включёнными темами.

      1. Добавьте бота в группу.
      2. Отправьте сообщение внутри нуджниой темы.
      3. Откаройте getUpdates тем же способом, который испогльзовался для получения Channel ID.
      4. Найдите сообщение из нужной темы.
      5. Скопирупомийте знать в уведомлчениие result → message → message_thread_id.

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

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

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

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

      Как указать упоминание пользователя

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

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

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

      1. Перейдите в раздел Рассылки → Настройка системных оповещений.
      2. Выберите «Все клубы» или конкретный клуб.
      3. Найдите нужное событие и нажмите «Редактировать» в столбце Telegram.
      4. Укажите Channel ID.
      5. При необходимости укзажполните Telegram-тег сотрудника, который должен получать упоминание.

        image.png

        Уведомления о завершении сессииmessage_thread_id и пересадtag_name.
      6. Включите гостя

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

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

        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. Проверьте, что увключены само событие и канал Telegram в заголовке таблицы.
          3. е

        Настьройки конкретного клуба имеют праваиоритет над общиминистратора.

      7. Проверьте, что в основных настройками для всех клубов.

        Как проверить отпразвку

        После нанстройки кдорректный токен.

      8. Убеждитесь, что CHANNEL_ID указан вместе с минусом, если минус есть в техническом ответствующего Telegram.
        9. события
      9. Выи пролниверьте дсообщействние, в Telegram. Результат отправки также отоброажается в разделе д«Рассылки → Лолжнг о тправызватьки уведомленией».

        Напр

        Еслимер, сформируйте тестовое сообытщение не поступило, проверьте:

        1. сохранён ли действующий токен бота;
        2. добавлен ли бот в нужный чат;
        3. разрешена ли боту отправка сообщений;
        4. правильно ли указан Channel ID, включая знак минус;
        5. соответствует ли message_thread_id выбранной теме;
        6. включены ли событие, канал Telegram и маршрут события;
        7. не переопределена ли общая настройка на уровне клуба;
        8. нет ли ошибки в логе отприавки уведомлений.
        9. Проверьте,
        ч

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

      10. Если вего на странице «Настройка Telegram для уведомлений».

        Безопасность

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

    Back to top