Интеграции

Вебхуки: события внешних систем в канале команды

Atlas принимает входящие вебхуки без отдельного бота. Push, pull request, merge request и события CI/CD превращаются в читаемые сообщения канала, а произвольный JSON-payload позволяет подключить систему, для которой готового адаптера нет.

Что можно подключить

  • GitHub

    События репозитория приходят в выбранный канал.

  • GitLab

    Push, merge request и pipeline-события.

  • Bitbucket

    События репозиториев команды.

  • Произвольный JSON

    Прямой payload в стиле Slack и Discord — для внутренних сервисов и мониторинга.

Безопасность интеграций

Для каждого вебхука создаётся отдельный Secret URL и signing secret. Подписи GitHub, GitLab и Bitbucket проверяются на стороне сервера, поэтому в канал не попадут сообщения от того, кто просто узнал адрес. Секрет можно перевыпустить, не пересоздавая интеграцию.

Диагностика доставок

В настройках рабочего пространства доступен журнал последних доставок: какой провайдер, какой тип события, какой статус ответа и что за ошибка, если внешний сервис вернул 400, 403, 404 или 500. Это снимает главный вопрос при отладке интеграции — «дошло ли вообще».

Частые вопросы

Нужен ли отдельный бот для интеграции?

Нет. Вебхук создаётся в настройках рабочего пространства и привязывается к каналу.

Что делать, если секрет попал не в те руки?

Секрет вебхука можно ротировать: старый перестаёт работать, интеграцию пересоздавать не нужно.

Поддерживается ли система, для которой нет адаптера?

Да, через generic JSON payload — формат совместим с тем, что умеют отправлять большинство сервисов.

Приведите события в рабочие каналы

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