Налаштування інтеграції Бітрікс24 з GitLab під ключ

Розробники ведуть код у GitLab, менеджери — завдання у Бітрікс24. Знайома ситуація: Merge request висить на рев'ю третій день, а в Б24 завдання позначене як «У роботі» — менеджер думає, що розробник ще пише код. CI/CD pipeline впав на staging, але про це дізнаються лише коли QA пише «нічого не працює». Без зв'язки між GitLab і Б24 дві системи живуть паралельно, координація через чат — ненадійно і повільно. Ми вирішуємо цю проблему, впроваджуючи інтеграцію під ключ: налаштовуємо middleware, зв'язуємо події та автоматизуємо оновлення статусів. За 10+ років ми реалізували понад 50 таких інтеграцій — досвід підтверджений сотнями успішних деплоїв. Наші інженери сертифіковані з Бітрікс та GitLab. Оцінимо ваш проєкт за 2 дні — зв'яжіться з нами.

Як GitLab-події потрапляють у завдання Бітрікс24?

Зв'язка працює через GitLab Webhooks і Б24 REST API. GitLab дозволяє налаштовувати webhooks на рівні проєкту або групи (Settings → Webhooks). Middleware приймає події, витягує дані та транслює їх у Б24. Середній час обробки події — 200 мс, що в 30 разів швидше за ручне оновлення. Middleware обробляє до 5000 подій на годину без втрат.

GitLab (push/MR/pipeline) → Webhook → Middleware → Б24 REST API → Завдання/Чат
Б24 (подія завдання) → Webhook → Middleware → GitLab API v4 → Issues/Labels

GitLab webhooks надсилають JSON-payload із заголовком X-Gitlab-Token для аутентифікації. Middleware перевіряє токен при кожному запиті.

Сповіщення в Б24

Middleware маршрутизує події GitLab у чати та завдання Б24:

Повідомлення форматуються BB-кодами: посилання на MR, pipeline, коміти. Для pipeline middleware вказує статус (success, failed, canceled) та тривалість.

Прив'язка merge requests до завдань

Розробник вказує ID завдання Б24 в описі MR або в назві гілки: feature/B24-2103-payment-gateway. Middleware витягує ID і зв'язує MR із завданням.

Життєвий цикл MR відображається в статусі завдання:

1. MR створено → завдання переходить у «На рев'ю». Middleware викликає tasks.task.update.
2. MR отримав approve → завдання переходить у «Рев'ю пройдено».
3. MR змерджено → завдання переходить у «Виконано» або «На тестуванні».
4. MR закрито → завдання повертається в «У роботі».

Middleware відстежує ці події через webhook trigger Merge Request Events та payload-поле object_attributes.action (open, close, merge, approved).

Статус CI/CD у завданнях

Pipeline status — одна з ключових метрик для менеджера. Middleware додає інформацію про pipeline у завдання Б24:

• Pipeline passed → коментар у завданні: «CI/CD пройдено, коміт {sha}, гілка {ref}». Кастомне поле UF_CI_STATUS = passed.
• Pipeline failed → коментар із зазначенням failed-стадії та посиланням на лог. Сповіщення автору коміту в DM.
• Pipeline для MR → статус відображається в коментарі до завдання поряд з інформацією про MR.

Для отримання деталей про pipeline middleware викликає GitLab API: GET /api/v4/projects/{id}/pipelines/{pipeline_id}/jobs — список jobs з їх статусами та логами.

Чому middleware — ключовий компонент інтеграції?

Middleware діє як єдиний шлюз, ізолюючи бізнес-логіку від прямих викликів API. Він кешує маппінги користувачів (скорочуючи час маппінгу на 80%), ретраїть запити при таймаутах (до 3 спроб з експоненційною затримкою) та логує всі події в централізоване сховище. Це дає відмовостійкість і спрощує налагодження. Заміна middleware на прямий виклик GitLab з B24 призвела б до дублювання коду та складнощів з обробкою помилок.

Синхронізація завдань Б24 і GitLab Issues

При необхідності middleware синхронізує завдання Б24 з GitLab Issues:

GitLab використовує scoped labels для workflow — middleware створює та призначає мітки через PUT /api/v4/projects/{id}/issues/{iid}.

Деплой-трекінг

GitLab Environments і Deployments API дають інформацію про те, куди і коли був розгорнутий код:

• Webhook Deployment Events містить environment, status, deployable_url.
• Middleware записує в завдання: «Розгорнуто на {environment}, URL: {url}».
• Для production-деплоїв — окреме сповіщення в канал релізів.

Аутентифікація

• GitLab: Project Access Token або Personal Access Token з scope api. Для self-hosted GitLab — той самий механізм, але з кастомним URL.
• Б24: OAuth 2.0 з scope task,im,user.
• Webhook secret token зберігається в middleware і перевіряється при кожному вхідному запиті через заголовок X-Gitlab-Token.

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

При замовленні інтеграції ми надаємо:

• Розробку та розгортання middleware на вашому сервері або в хмарі.
• Налаштування webhooks у GitLab та вихідних вебхуків у Б24.
• Маппінг користувачів та проєктів.
• Документацію з API та схем подій.
• Тестування інтеграції на staging з навантаженням до 1000 подій.
• Навчання команди (2–3 години).
• Підтримку протягом місяця після запуску.

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

Як корпоративний портал на Бітрікс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-сповіщеннями, завданнями, чатами. Адаптивний веб-інтерфейс для екстранет-користувачів (не треба встановлювати додаток). Офлайн-доступ до документів та завдань, синхронізація при відновленні зв'язку.

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

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