Налаштування інтеграції Бітрікс24 з GitHub

Налаштування інтеграції Бітрікс24 з GitHub

Менеджер питає статус задачі — розробник відповідає «на рев'ю». Pull request в GitHub уже змерджили, а задача в Б24 досі «В роботі». Ручний міст між кодом і трекером ламається щодня. Ми прибираємо цей міст, зв'язуючи коміти, PR та деплої з задачами Б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:

Повідомлення надсилаються через 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 — основний тригер для оновлення статусів задач:

1. PR відкрито → задача переходить у статус «На рев'ю» (tasks.task.update з новим STATUS).
2. PR отримав approve → задача переходить у «Рев'ю пройдено» (кастомний статус).
3. PR змерджено → задача переходить у «На тестуванні» або «Виконано» (налаштовується).
4. 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. Невалідні запити відхиляються.

Що входить у налаштування інтеграції?

Ми надаємо документацію з архітектури, доступи до middleware та навчання команди роботі з інтеграцією. Гарантуємо підтримку протягом місяця після запуску.

Чому обирають нас?

Більше 5 років ми налаштовуємо інтеграції Бітрікс24 з GitHub для клієнтів з різних галузей. Наші інженери — сертифіковані спеціалісти 1С-Бітрікс та GitHub Actions. Досвід — понад 50 успішних проєктів. Ми оцінюємо ваш проєкт безкоштовно та пропонуємо оптимальне рішення.

Зв'яжіться з нами, щоб обговорити деталі інтеграції та отримати консультацію.

Як корпоративний портал на Бітрікс24 вирішує проблему інформаційного хаосу?

Ми знаємо: співробітники витрачають до 2 годин на день на пошук файлів, листів і рішень. Завдання губляться в десятку чатів, погодження застряють на тижні. Керівник дізнається про зрив дедлайну лише на нараді. Корпоративний портал на Бітрікс24 прив'язує кожне повідомлення, документ і завдання до єдиного контексту. Ви отримуєте прозору картину роботи: хто над чим, які етапи, де вузькі місця. Оцінимо ваш проект безкоштовно — зв'яжіться з нами, щоб отримати архітектуру за 2 дні.

Що дає портал у щоденній роботі і чому це краще месенджерів?

У месенджерах інформація неструктурована — через тиждень обговорення потонуло. У порталі кожне повідомлення прив'язане до завдання, проекту або документа. Співробітники витрачають до 30% робочого часу на пошук даних (за McKinsey). Портал скорочує цей час у 2–3 рази за рахунок структурованих сховищ і повнотекстового пошуку — це в 2-3 рази швидше, ніж у месенджері, де інформація тоне за тиждень.

Комунікації. Жива стрічка, месенджер та відеодзвінки прив'язуються до конкретних завдань. Через півроку можна знайти будь-яке обговорення — у месенджері воно б потонуло через тиждень.

Завдання та проекти. Канбан, Гант, чеклісти, залежності, облік часу. Ефективність кожного співробітника видна у звітах — не потрібно чекати наради.

Документообіг. Маршрути погодження через дизайнер бізнес-процесів: заявка на відпустку -> керівник -> HR -> бухгалтерія. Електронний підпис, версіонування, контроль термінів. Інтеграція з електронним документообігом (СБІС, Діадок) через REST API.

HR. Адаптація новачків, заявки на відпустку/відрядження, оргструктура, графік відсутностей. Співробітник з першого дня знає, куди йти.

База знань. Wiki-движок Бітрікс24: регламенти, інструкції. Знання не йдуть зі звільненими.

Приклад із впровадження. Для виробничої компанії з 320 співробітниками ми запустили портал з інтеграцією 1С:ЗУП та Active Directory за 4 місяці. Час погодження заявок на відрядження скоротився з 3 днів до 4 годин. Економія на простої співробітників — близько 1,2 млн грн на рік. Керівники отримують автоматичні звіти з ефективності підрозділів. Термін відповіді клієнтам зменшився на 20%. Окупність порталу — 7 місяців.

Як інтеграція з 1С та Active Directory прискорює кадровий облік?

Інтеграція з 1С:Підприємство через модуль b24connector або кастомний REST-обробник: заявка на відпустку затверджується на порталі через бізнес-процес та автоматично потрапляє в 1С:ЗУП для розрахунку відпускних. Active Directory (SSO через модуль ldap) — обліковка співробітника створюється один раз в AD та синхронізується на портал, пошту, 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. Реалізація — налаштовуємо бізнес-процеси, права, інтерфейс.
4. Тест — пілотна група перевіряє сценарії, ми виправляємо недоліки.
5. Запуск — підключаємо всіх співробітників, навчаємо, передаємо документацію.

Що входить у роботу

В результаті ви отримуєте:

• проектну документацію (архітектура, схеми бізнес-процесів, технічне завдання);
• налаштований портал з інтеграціями (1С, AD, пошта, телефонія, ЕДО);
• опис бізнес-процесів та інструкції для адміністраторів і користувачів;
• 30 днів технічної підтримки після запуску.

Підтримка після запуску: як не дати порталу померти

Через півроку багато порталів стають занедбаними. Щоб цього уникнути, пропонуємо пакети з фіксованим SLA та виділеним адміністратором. Моніторинг продуктивності, оновлення платформи, адміністрування користувачів, доопрацювання нових модулів. Досвід нашої команди — понад 50 впроваджень корпоративних порталів на Бітрікс24, 10+ років роботи, статус сертифікованого партнера 1С-Бітрікс. Гарантуємо якість та терміни.

Мобільний доступ. Нативний додаток Бітрікс24 (iOS/Android) з push-сповіщеннями, завданнями, чатами. Адаптивний веб-інтерфейс для екстранет-користувачів (не треба встановлювати додаток). Офлайн-доступ до документів та завдань, синхронізація при відновленні зв'язку.

Замовте впровадження корпоративного порталу під ключ

Зв'яжіться з нами — оцінимо ваш проект, запропонуємо архітектуру та терміни. Отримайте консультацію безкоштовно та переконайтеся, що портал окупається в перші півроку. Замовляйте впровадження та почніть автоматизацію вже сьогодні.