Настройка интеграции Битрикс24 с GitHub
Менеджер просит статус задачи — разработчик отвечает «в ревью». Pull request в GitHub уже смёрджен, а задача в Б24 до сих пор «В работе». Ручной мост между кодом и трекером ломается каждый день. Мы убираем этот мост, связывая коммиты, PR и деплои с задачами Б24 напрямую. Наши инженеры настраивают интеграцию под ключ, чтобы вы забыли о рассинхронизации.
Почему интеграция GitHub и Битрикс24?
В типичном проекте разработчик тратит до 30% времени на ручное обновление статусов задач. Автоматизация через вебхуки и API сокращает это время в 10 раз и исключает человеческие ошибки. Кроме того, менеджеры и QA получают прозрачную картину: каждый коммит привязан к задаче, каждый PR меняет статус, каждый деплой логируется. Это не просто удобство — это прозрачность разработки для бизнеса.
Архитектура интеграции
Связка использует GitHub Webhooks и Б24 REST API. GitHub отправляет POST-запросы при событиях в репозиториях. Middleware принимает эти запросы, извлекает данные и транслирует их в Б24.
GitHub (push/PR/issue) → Webhook → Middleware → Б24 REST API → Задачи/Чат Б24 (событие задачи) → Webhook → Middleware → GitHub API → Issues/Labels GitHub Webhooks настраиваются на уровне репозитория (Settings → Webhooks) или организации. Content type — application/json. Каждый webhook подписывается HMAC-SHA256 через secret — middleware проверяет подпись.
Уведомления о коммитах и PR в чате Б24
Middleware маршрутизирует события GitHub в каналы Б24:
| Событие GitHub | Канал Б24 | Формат сообщения |
|---|---|---|
push |
Чат проекта | Автор, ветка, список коммитов со ссылками |
pull_request.opened |
Чат проекта | Название PR, автор, ветка, ссылка |
pull_request.merged |
Чат проекта + уведомление ответственному | PR смёрджен, кто замёрджил |
pull_request_review |
DM автору PR | Результат ревью: approved/changes_requested |
issues.opened |
Чат проекта | Новый issue, автор, текст |
release.published |
Общий чат / канал releases | Версия, changelog, ссылка |
Сообщения отправляются через im.message.add с форматированием BB-кодами. Ссылки на PR и коммиты кликабельны.
Привязка коммитов к задачам
Разработчик указывает ID задачи Б24 в сообщении коммита: fix: resolve layout issue [B24-1542]. Middleware парсит commit message, извлекает ID и выполняет действия:
- Добавляет комментарий к задаче через
task.commentitem.addс текстом коммита, автором и ссылкой на diff. - Если коммит содержит ключевые слова (
close,fix,resolve), middleware может автоматически переводить задачу в статус «Выполнена». - Все коммиты, привязанные к задаче, видны в истории комментариев — менеджер понимает, что происходит с кодом.
Как работает синхронизация статусов через PR?
Pull request — основной триггер для обновления статусов задач:
- PR открыт → задача переходит в статус «На ревью» (
tasks.task.updateс новымSTATUS). - PR получил approve → задача переходит в «Ревью пройдено» (кастомный статус).
- PR смёрджен → задача переходит в «На тестировании» или «Выполнена» (настраивается).
- PR закрыт без мёрджа → задача возвращается в «В работе».
Middleware определяет задачу по branch name (например, feature/B24-1542-user-auth) или по тексту PR description.
Трекинг деплоев
GitHub Actions или другие CI/CD-системы отправляют события deployment_status. Middleware транслирует их в Б24:
- Деплой на staging → комментарий в задаче: «Развёрнуто на staging, ссылка: {url}».
- Деплой на production → уведомление в общий чат + обновление кастомного поля задачи
UF_DEPLOY_DATE. - Деплой failed → уведомление ответственному с логом ошибки.
Это позволяет менеджерам и QA видеть, когда фича доступна для тестирования, без лишних вопросов.
Обратная связь: задачи Б24 → GitHub Issues
При создании задачи определённого типа в Б24 middleware автоматически создаёт issue в GitHub через POST /repos/{owner}/{repo}/issues. Маппинг:
- Название задачи → title issue
- Описание → body (HTML конвертируется в Markdown)
- Приоритет → label (
priority:high,priority:medium) - Проект Б24 → репозиторий (через таблицу соответствий)
Обратное обновление: при закрытии issue в GitHub middleware закрывает задачу в Б24.
Безопасность
- GitHub: webhook secret для проверки подписи. API-запросы — через Personal Access Token или GitHub App (Installation Token с ограниченными permissions).
- Б24: OAuth 2.0 с scope
task,im,user.
Middleware проверяет заголовок X-Hub-Signature-256 для каждого входящего webhook. Невалидные запросы отклоняются.
Что входит в настройку интеграции?
| Этап | Длительность | Результат |
|---|---|---|
| Аудит текущих процессов | 1-2 дня | Схема потоков данных, список триггеров |
| Разработка middleware | 3-5 дней | Рабочий сервис с логированием |
| Настройка вебхуков и токенов | 0.5 дня | Подключение репозиториев и Б24 |
| Тестирование и отладка | 1-2 дня | Проверка всех сценариев |
| Документация и обучение | 0.5 дня | Инструкция для команды |
Мы предоставляем документацию по архитектуре, доступы к middleware, и обучение команды работе с интеграцией. Гарантируем поддержку в течение месяца после запуска.
Почему выбирают нас?
Более 5 лет мы настраиваем интеграции Битрикс24 с GitHub для клиентов из разных отраслей. Наши инженеры — сертифицированные специалисты 1С-Битрикс и GitHub Actions. Опыт — более 50 успешных проектов. Мы оцениваем ваш проект бесплатно и предлагаем оптимальное решение.
Свяжитесь с нами, чтобы обсудить детали интеграции и получить консультацию.