Настройка інтеграції Бітрікс24 з YouTrack: синхронізація завдань

Клієнт надсилає баг-репорт в техпідтримку, менеджер створює задачу в Бітрікс24, потім іде в YouTrack і створює дублюючий issue. Розробник закриває issue, але менеджер про це не знає — клієнт отримує відповідь «ще працюємо» на вже виправлену проблему. Два трекери без зв'язку — це подвійна робота та постійне відставання інформації. Ми проектуємо middleware, яке слухає події в обох системах та перетворює їх на сутності іншої системи. Виключаємо ручне перенесення та затримки. Наші інженери мають 5+ років досвіду з YouTrack та Бітрікс24, тому ми знаємо всі підводні камені та гарантуємо стабільне рішення. Надаємо документацію, навчання співробітників та підтримку після впровадження. Підсумок — єдиний інформаційний простір для розробників та менеджерів. Економія часу: до 30 годин на місяць на одному співробітнику.

Як налаштувати інтеграцію Бітрікс24 з YouTrack?

Кроки з налаштування

1. Отримати Permanent Token в YouTrack (Profile → Authentication) та OAuth-токен Бітрікс24 з правами task, user.
2. Розгорнути middleware на сервері з Docker (надаємо готовий образ).
3. Сконфігурувати мапінг полів: відповідність заголовка, опису, відповідального, статусу та проектів.
4. Налаштувати webhooks в обох системах для відправки подій у middleware.
5. Протестувати синхронізацію в тестовому контурі та запустити в продакшн.

middleware:
  youtrack:
    token: "perm:YOUR_TOKEN"
    base_url: "https://yourcompany.youtrack.cloud"
  bitrix24:
    webhook_url: "https://yourdomain.bitrix24.ru/rest/1/TOKEN/"
  mapping:
    fields:
      - b24: TITLE
        yt: summary
      - b24: DESCRIPTION
        yt: description
        transform: "html_to_md"
    statuses:
      - b24: 2
        yt: Open
      - b24: 3
        yt: "In Progress"

Архітектура синхронізації

Інтеграція працює через YouTrack REST API та Б24 REST API. YouTrack надає повноцінний API для роботи з issues, проектами, agile-дошками та часовими записами. Middleware забезпечує двоспрямований обмін.

Б24 (подія задачі) → Webhook → Middleware → YouTrack REST API → Issue
YouTrack (workflow/webhook) → Middleware → Б24 REST API → Задача

YouTrack підтримує два механізми сповіщення зовнішніх систем: Webhooks (Settings → Webhooks) та Workflows (серверні скрипти на JavaScript). Webhooks простіші, але workflows дають більше контролю — можна фільтрувати події за полями, проектами та типами issues. Згідно з документацією YouTrack REST API, permanent token — рекомендований спосіб аутентифікації для серверних інтеграцій.

Мапінг полів

Конвертація опису: Б24 зберігає HTML, YouTrack використовує Markdown (з розширеннями). Middleware конвертує через проміжне AST-представлення.

Мапінг статусів

YouTrack використовує state machine — кожен проект має свій набір станів. Middleware підтримує конфігурований мапінг:

Стани, яких немає в Б24, обробляються особливим чином: middleware додає коментар з поясненням та закриває або призупиняє задачу.

Синхронізація обліку часу

YouTrack та Б24 обидва ведуть облік витраченого часу. Middleware об'єднує записи:

• З YouTrack в Б24: При додаванні work item в YouTrack (подія issue.updated, поле workItems) middleware створює запис про витрачений час в задачі Б24 через task.elapseditem.add. Вказується тривалість, дата та коментар.
• З Б24 в YouTrack: При додаванні запису про час в Б24 (подія ONTASKELAPSEDTIMEADD) middleware створює work item в YouTrack через POST /api/issues/{id}/timeTracking/workItems.

Важливо: middleware веде таблицю мапінгу записів часу, щоб уникнути дублювання при двосторонній синхронізації. Кожен запис отримує унікальний sync_id.

Інтеграція agile-дошок

YouTrack Agile Board відображає issues на kanban/scrum-дошці. Б24 має свій Канбан. Middleware не синхронізує візуальне розташування, але забезпечує:

• Переміщення issue на дошці YouTrack (зміна State) → оновлення статусу задачі в Б24 Канбан.
• Зміна стадії на Канбан-дошці Б24 → оновлення State issue в YouTrack.
• Спринти YouTrack → групи задач або теги в Б24 (через кастомне поле UF_SPRINT).

Як уникнути петель синхронізації?

Той самий принцип, що в інших інтеграціях: middleware маркує джерело оновлення в кастомному полі обох систем. При отриманні webhook перевіряється маркер — якщо оновлення ініційоване middleware, обробка пропускається.

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

• YouTrack: Permanent Token (Profile → Authentication → New Token). Для Cloud та Server — однаковий механізм. Scope задається через права користувача, від імені якого видано токен.
• Б24: OAuth 2.0 з scope task,user.
• Дані проходять тільки через middleware — прямого доступу між системами немає.

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

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

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

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

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