Настройка вебхука Telegram
Для получения вебхук-уведомлений в Telegram требуется создать бота через BotFather, получить его токен и идентификатор чата, затем указать эти данные в настройках репозитория GitVerse: Настройки → Вебхуки.
Создание бота и получение токена через BotFather
BotFather — это официальный бот Telegram для создания других ботов. Чтобы создать нового бота и получить его токен, выполните следующие шаги:
- Откройте Telegram и найдите официальный бот
@BotFather(с синей галочкой верификации). - В диалоговом окне введите команду
/startили нажмите кнопку «Запустить», чтобы запустить сервис BotFather. - Из списка доступных команд введите
/newbot. BotFather попросит указать название и имя пользователя для нового бота. - Введите желаемое имя пользователя для вашего бота. Имя должно заканчиваться на
_bot. - После успешного создания бота BotFather отправит сообщение с токеном. Сохраните этот токен — он потребуется при настройке вебхука в GitVerse.
Important
Токен бота обеспечивает доступ к его API. Не передавайте его третьим лицам и не публикуйте в открытых источниках.
Активация бота для отправки уведомлений
После создания бота через BotFather необходимо активировать его для работы. Без активации бот не будет принимать входящие сообщения и не сможет доставлять уведомления. Для активации выполните следующие действия:
- Найдите созданного бота в поиске Telegram по его имени пользователя.
- Откройте диалог с ботом и введите команду
/startили нажмите кнопку «Запустить».
После активации бот готов к использованию и сможет отправлять уведомления в чат, указанный при настройке вебхука в GitVerse.
Получение идентификатора чата через GetMyId_bot
Идентификатор чата — это уникальный числовой идентификатор, который указывает, в какой чат Telegram должны доставляться уведомления. Для получения chat ID воспользуйтесь специальным ботом @GetMyId_bot:
- Откройте Telegram и найдите бота
@GetMyId_bot. - Откройте диалог с ботом и введите произвольное слово или команду
/start. - Бот ответит сообщением, содержащим ваш идентификатор чата. Скопируйте это значение — вместе с токеном бота оно потребуется при настройке вебхука в GitVerse.
Конфигурация вебхука в GitVerse
После получения токена бота и идентификатора чата перейдите к настройке вебхука в GitVerse. Форма создания вебхука расположена в профиле репозитория > Настройки > Вебхуки.
- Нажмите кнопку Добавить Вебхук для начала настройки.
- В поле Сервис выберите Telegram из выпадающего списка.
- Вставьте токен бота и идентификатор чата в соответствующие поля. Токен был получен через BotFather, а chat ID — через бота
@GetMyId_bot. - Настройте фильтр уведомлений — выберите события репозитория, о которых хотите получать уведомления в Telegram (например, pull request в определенную ветку, commit и другие).
- Нажмите кнопку Сохранить.
После сохранения настроенный бот будет автоматически присылать уведомления о выбранных событиях в Telegram.
Дальнейшие шаги
После настройки вебхука Telegram рекомендуется выполнить следующие действия:
- Настройка вебхуков в GitVerse — обзор возможностей и настройка других вебхуков;
- API вебхуков — программное управление вебхуками через публичный API.