Интеграция с Telegram
Для создания новой интеграции с Telegram нажмите кнопку "Добавить". На странице создания интеграции выберете необходимый набор событий, который вам требуется для получения уведомлений в чате или канале, укажите название для новой интеграции и нажмите "Сохранить". После успешного сохранения вам будет доступен токен для интеграции с чатом Telegram.
Для настройки связи GitFlic-Telegram вам необходим GitFlic бот.
Рекомендуем создать отдельный чат для уведомлений о проектах, чтобы важные уведомления не затерялись в переписке.
Далее вам нужно добавить бота в ваш канал или групповой чат вашей команды разработки, для бота достаточно прав только для отправки новых сообщений. Далее необходимо отправить в чат команду бота /start, вам придет обратное сообщение, что бот готов к работе. Чтобы подключить интеграцию с проектом, необходимо скопировать секретный токен из настроек проекта и с командой /connect через пробел отправить в чат. Например, команда для подключения бота может выглядеть так: /connect a1b2c3d4-aaaa-aaaa-aaaa-05a592e5578f. После создания успешной связи вы получите обратное сообщение, что ваш проект был подключен. А на странице управления интеграцией появится информация о подключенном чате.
После успешной связи с чатом в Telegram, на странице настроек GitFlic отобразится внутренний ID чата Telegram и его название.
Если добавляете бота в групповой чат, необходимо добавить его в администраторы. При добавлении бота в канал, права администратора будут предложены автоматически. Боту достаточно прав для отправки сообщений.
Внимание!
Максимальное количество интеграций 5, т.е один проект можно подписать на 5 чатов Telegram.
Внимание!
Для настройки интеграции в GitFlic self-hosted необходимо создать бота самостоятельно при помощи @BotFather и указать полученный токен для бота в application.properties.
При использовании GitFlic self-hosted в закрытом контуре имеется возможность настроить интеграцию без необходимости открывать сетевой доступ до вашей инсталляции GitFlic. Для корректной работы достаточно отправлять исходящие запросы к API Telegram.
Команда для проверки доступа к API Telegram
Выполните команду с вашего закрытого контура curl https://api.telegram.org/bot<token>/getUpdates.
При наличии доступа придет ответ аналогичный {"ok":true,"result":[]}
При создании новой интеграции доступна возможность самостоятельно указать ID чата, с которым необходимо создать связь для интеграции.
Для получения ID чата Telegram - необходимо добавить вашего бота в чат, в который настраивается интеграция (бота необходимо добавить в группой чат с правами на отправку сообщений). Далее необходимо через команду getUpdates указанную ранее найти ID вашего чата. Обращаем ваше внимание, ID чата у каналов и групповых чатов начинается с -100. В поле Название необходимо указать наименование чата.