Настройка вебхука Telegram

Для получения вебхук-уведомлений в Telegram требуется создать бота через BotFather, получить его токен и идентификатор чата, затем указать эти данные в настройках репозитория GitVerse: Настройки → Вебхуки.

Создание бота и получение токена через BotFather

BotFather — это официальный бот Telegram для создания других ботов. Чтобы создать нового бота и получить его токен, выполните следующие шаги:

  1. Откройте Telegram и найдите официальный бот @BotFather (с синей галочкой верификации).
  2. В диалоговом окне введите команду /start или нажмите кнопку «Запустить», чтобы запустить сервис BotFather.
  3. Из списка доступных команд введите /newbot. BotFather попросит указать название и имя пользователя для нового бота.
  4. Введите желаемое имя пользователя для вашего бота. Имя должно заканчиваться на _bot.
  5. После успешного создания бота BotFather отправит сообщение с токеном. Сохраните этот токен — он потребуется при настройке вебхука в GitVerse.

Important

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

Активация бота для отправки уведомлений

После создания бота через BotFather необходимо активировать его для работы. Без активации бот не будет принимать входящие сообщения и не сможет доставлять уведомления. Для активации выполните следующие действия:

  1. Найдите созданного бота в поиске Telegram по его имени пользователя.
  2. Откройте диалог с ботом и введите команду /start или нажмите кнопку «Запустить».

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

Получение идентификатора чата через GetMyId_bot

Идентификатор чата — это уникальный числовой идентификатор, который указывает, в какой чат Telegram должны доставляться уведомления. Для получения chat ID воспользуйтесь специальным ботом @GetMyId_bot:

  1. Откройте Telegram и найдите бота @GetMyId_bot.
  2. Откройте диалог с ботом и введите произвольное слово или команду /start.
  3. Бот ответит сообщением, содержащим ваш идентификатор чата. Скопируйте это значение — вместе с токеном бота оно потребуется при настройке вебхука в GitVerse.

Конфигурация вебхука в GitVerse

После получения токена бота и идентификатора чата перейдите к настройке вебхука в GitVerse. Форма создания вебхука расположена в профиле репозитория > Настройки > Вебхуки.

  1. Нажмите кнопку Добавить Вебхук для начала настройки.
  2. В поле Сервис выберите Telegram из выпадающего списка.
  3. Вставьте токен бота и идентификатор чата в соответствующие поля. Токен был получен через BotFather, а chat ID — через бота @GetMyId_bot.
  4. Настройте фильтр уведомлений — выберите события репозитория, о которых хотите получать уведомления в Telegram (например, pull request в определенную ветку, commit и другие).
  5. Нажмите кнопку Сохранить.

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

Дальнейшие шаги

После настройки вебхука Telegram рекомендуется выполнить следующие действия: