Настройка интеграции Битрикс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 успешных проектов. Мы оцениваем ваш проект бесплатно и предлагаем оптимальное решение.
Свяжитесь с нами, чтобы обсудить детали интеграции и получить консультацию.
Как корпоративный портал на Битрикс24 решает проблему информационного хаоса?
Сотрудники тратят до 2 часов в день на поиск файлов, писем и решений. Задачи теряются в десятке чатов, согласования застревают на недели. Руководитель узнает о срыве дедлайна только на летучке. Корпоративный портал на Битрикс24 привязывает каждое сообщение, документ и задачу к единому контексту. Вы получаете прозрачную картину работы: кто над чем, какие этапы, где узкие места. Оценим ваш проект бесплатно — свяжитесь с нами, чтобы получить архитектуру за 2 дня.
Что даёт портал в ежедневной работе и почему это лучше мессенджеров?
В мессенджерах информация неструктурирована — через неделю обсуждение утонуло. В портале каждое сообщение привязано к задаче, проекту или документу. Сотрудники тратят до 30% рабочего времени на поиск данных (по McKinsey). Портал сокращает это время в 2–3 раза за счет структурированных хранилищ и полнотекстового поиска.
Коммуникации. Живая лента, мессенджер и видеозвонки привязываются к конкретным задачам. Через полгода можно найти любое обсуждение — в мессенджере оно бы утонуло через неделю.
Задачи и проекты. Канбан, Гант, чеклисты, зависимости, учет времени. Эффективность каждого сотрудника видна в отчетах — не нужно ждать совещания.
Документооборот. Маршруты согласования через дизайнер бизнес-процессов: заявка на отпуск → руководитель → HR → бухгалтерия. Электронная подпись, версионирование, контроль сроков. Интеграция с электронным документооборотом (СБИС, Диадок) через REST API.
HR. Адаптация новичков, заявки на отпуск/командировку, оргструктура, график отсутствий. Сотрудник с первого дня знает, куда идти.
База знаний. Wiki-движок Битрикс24: регламенты, инструкции. Знания не уходят с увольняющимися.
Пример из внедрения. Для производственной компании с 320 сотрудниками мы запустили портал с интеграцией 1С:ЗУП и Active Directory за 4 месяца. Время согласования заявок на командировки сократилось с 3 дней до 4 часов. Экономия на простое сотрудников — 1,5 млн рублей в год. Руководители получают автоматические отчеты по эффективности подразделений. Срок ответа клиентам уменьшился на 20%. Окупаемость портала — 7 месяцев.
Как интеграция с 1С и Active Directory ускоряет кадровый учёт?
Интеграция с 1С:Предприятие через модуль b24connector или кастомный REST-обработчик: заявка на отпуск утверждается на портале через бизнес-процесс и автоматически попадает в 1С:ЗУП для расчета отпускных. Active Directory (SSO через модуль ldap) — учетка сотрудника создается один раз в AD и синхронизируется на портал, почту, VPN. При увольнении блокируется везде. Ручное создание аккаунтов исключено, ошибки минимизированы.
Типы корпоративных порталов и ключевые интеграции
| Тип |
Цель |
Ключевая функция |
| Интранет |
Внутренние коммуникации и сервисы |
Новости, телефонный справочник (синхронизация с Active Directory), бронирование переговорных, заявки на IT через БП |
| HR-портал |
Кадровый учет и развитие |
Профили, KPI/OKR на кастомных HL-блоках, обучение, электронный документооборот |
| Портал знаний |
Документация и регламенты |
Категоризация, теги, рейтинги, подписки на обновления |
| Экстранет |
Работа с партнерами и подрядчиками |
Гранулярные права через CGroup и модуль extranet, доступ без VPN |
| Портал холдинга |
Управление мультикомпанейной структурой |
Раздельные рабочие пространства, консолидированная отчетность, сквозные БП |
Дополнительные интеграции, дающие реальную ценность
- Почта. Exchange через EWS API или IMAP, синхронизация календарей, создание задачи из письма.
- IP-телефония. Asterisk, Mango Office, Zadarma через REST API — звонки из портала, карточка контакта, запись разговоров.
- Видеоконференции. Встроенные видеозвонки или интеграция с Zoom/Teams через marketplace.
- ЭДО. СБИС, Диадок через REST API — полностью электронный документооборот с контрагентами.
Безопасность и соответствие 152-ФЗ
На портале — персональные данные, финансовая отчетность, стратегические планы. Мы гарантируем защиту:
- ролевая модель через CGroup и права на уровне разделов;
- двухфакторная аутентификация (OTP, Яндекс.Ключ, SMS);
- аудит всех действий (b_event_log);
- шифрование TLS на передачу и шифрование дисков;
- полное соответствие Федеральному закону № 152-ФЗ «О персональных данных».
Как происходит внедрение? Пошаговый план
| Этап |
Срок |
Что делаем |
| 1. Аудит |
2–3 недели |
Интервью, анализ процессов, архитектура, план интеграций |
| 2. Настройка и кастомизация |
3–6 недель |
Структура, роли, БП, брендирование (CSS шаблон) |
| 3. Интеграции |
2–4 недели |
1С, AD, почта, телефония, ЭДО |
| 4. Миграция данных |
1–2 недели |
Документы, справочники, сотрудники из текущих систем |
| 5. Обучение и пилот |
1–2 недели |
Администраторы, ключевые пользователи, пилот 20–30 чел. |
| 6. Масштабирование |
2–4 недели |
Подключение подразделений, донастройка по обратной связи |
-
Аудит — фиксируем текущие процессы, замеряем потери времени.
-
Проектирование — выбираем тип портала, планируем интеграции.
-
Реализация — настраиваем бизнес-процессы, права, интерфейс.
-
Тест — пилотная группа проверяет сценарии, мы исправляем недочеты.
-
Запуск — подключаем всех сотрудников, обучаем, передаем документацию.
В результате вы получаете: проектную документацию, настроенный портал с интеграциями, описание бизнес-процессов, инструкции для администраторов и пользователей, 30 дней технической поддержки после запуска.
Поддержка после запуска: как не дать порталу умереть
Через полгода многие порталы становятся заброшенными. Чтобы этого избежать, предлагаем пакеты с фиксированным SLA и выделенным администратором. Мониторинг производительности, обновления платформы, администрирование пользователей, доработка новых модулей. Опыт нашей команды — более 50 внедрений корпоративных порталов на Битрикс24. Мы являемся сертифицированным партнером 1С-Битрикс, гарантируем качество и сроки.
Мобильный доступ. Нативное приложение Битрикс24 (iOS/Android) с push-уведомлениями, задачами, чатами. Адаптивный веб-интерфейс для экстранет-пользователей (не надо ставить приложение). Офлайн-доступ к документам и задачам, синхронизация при восстановлении связи.
Закажите внедрение корпоративного портала под ключ
Свяжитесь с нами — оценим ваш проект, предложим архитектуру и сроки. Получите консультацию бесплатно и убедитесь, что портал окупается в первые полгода.
