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

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

Info

Создание ботов доступно только для организаций с верифицированным профилем на платформе MAX для партнеров. Для одной организации можно создать до 5 ботов. Подробнее — в документации MAX.

Создание бота и получение токена в MAX

Для настройки вебхук-уведомлений в MAX необходимо создать чат-бота через платформу MAX для партнеров и получить его токен доступа. Выполните следующие шаги:

  1. Авторизуйтесь на платформе MAX для партнеров.
  2. Перейдите в раздел Чат-боты и нажмите кнопку создания нового бота.
  3. Заполните обязательные поля: название бота, логотип и описание. Эти данные будут отображаться пользователям при взаимодействии с ботом.
  4. Отправьте бота на модерацию. После успешного прохождения модерации перейдите в Чат-боты → Интеграция → Получить токен.
  5. Сохраните полученный токен бота — он потребуется при настройке вебхука в GitVerse.

Important

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

Получение идентификатора чата в MAX

Идентификатор чата — это уникальный числовой идентификатор диалога с вашим ботом, необходимый для доставки уведомлений. Чтобы получить chat ID:

  1. Откройте бота в веб-версии MAX. Вы можете найти его по названию, указанному при создании.
  2. В адресной строке браузера будет URL вида https://web.max.ru/-32665136695840 — цифровая строка с минусом после последнего / является идентификатором чата.
  3. Скопируйте и сохраните значение chat ID — вместе с токеном оно потребуется при настройке вебхука в GitVerse.

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

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

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

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

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

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

Вид графа

Связанные страницы