Клієнт надсилає баг-репорт в техпідтримку, менеджер створює задачу в Бітрікс24, потім іде в YouTrack і створює дублюючий issue. Розробник закриває issue, але менеджер про це не знає — клієнт отримує відповідь «ще працюємо» на вже виправлену проблему. Два трекери без зв'язку — це подвійна робота та постійне відставання інформації. Ми проектуємо middleware, яке слухає події в обох системах та перетворює їх на сутності іншої системи. Виключаємо ручне перенесення та затримки. Наші інженери мають 5+ років досвіду з YouTrack та Бітрікс24, тому ми знаємо всі підводні камені та гарантуємо стабільне рішення. Надаємо документацію, навчання співробітників та підтримку після впровадження. Підсумок — єдиний інформаційний простір для розробників та менеджерів. Економія часу: до 30 годин на місяць на одному співробітнику.
Як налаштувати інтеграцію Бітрікс24 з YouTrack?
Кроки з налаштування
- Отримати Permanent Token в YouTrack (Profile → Authentication) та OAuth-токен Бітрікс24 з правами task, user.
- Розгорнути middleware на сервері з Docker (надаємо готовий образ).
- Сконфігурувати мапінг полів: відповідність заголовка, опису, відповідального, статусу та проектів.
- Налаштувати webhooks в обох системах для відправки подій у middleware.
- Протестувати синхронізацію в тестовому контурі та запустити в продакшн.
Приклад конфігурації middleware
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 (tasks.task) | Поле YouTrack (issue) | Примітка |
|---|---|---|
| TITLE | summary | Пряма відповідність |
| DESCRIPTION | description | Б24 HTML → YouTrack Markdown |
| RESPONSIBLE_ID | Assignee | Через таблицю мапінгу користувачів |
| CREATED_BY | Reporter | Аналогічно |
| DEADLINE | Due Date | ISO 8601 в обох системах |
| PRIORITY | Priority | Мапінг значень (див. нижче) |
| STATUS | State | Окрема конфігурація |
| GROUP_ID | Project (shortName) | Таблиця відповідностей |
| UF_* (кастомні) | Custom fields | Індивідуально |
Конвертація опису: Б24 зберігає HTML, YouTrack використовує Markdown (з розширеннями). Middleware конвертує через проміжне AST-представлення.
Мапінг статусів
YouTrack використовує state machine — кожен проект має свій набір станів. Middleware підтримує конфігурований мапінг:
| Статус Б24 | State YouTrack | Напрямок |
|---|---|---|
| Нова (2) | Open | ↔ |
| Виконується (3) | In Progress | ↔ |
| Чекає контролю (4) | To Verify | ↔ |
| Завершена (5) | Fixed / Done | ↔ |
| На паузі (6) | Wait | ↔ |
| — | Duplicate | YT → Б24 (коментар) |
| — | Won't Fix | YT → Б24 (закриття + коментар) |
Стани, яких немає в Б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 — прямого доступу між системами немає.
Що входить в роботу?
| Дія | Опис |
|---|---|
| Аналіз процесів | Вивчаємо поточні регламенти, схеми роботи в обох системах, збираємо вимоги щодо синхронізації |
| Налаштування middleware | Розробляємо та конфігуруємо компонент для двоспрямованого обміну |
| Мапінг даних | Налаштовуємо відповідність полів, статусів, користувачів та проектів |
| Тестування | Перевіряємо коректність синхронізації в тестовому контурі, фіксуємо метрики |
| Запуск та підтримка | Розгортаємо в продуктивному середовищі, надаємо документацію та навчання |
Оцінимо ваш проект: терміни — від 2 до 5 робочих днів залежно від складності. Вартість розраховується індивідуально. Отримайте консультацію — просто зв'яжіться з нами. Ми гарантуємо стабільну синхронізацію 24/7. Наш досвід: понад 5 років роботи з Бітрікс та YouTrack, десятки успішних інтеграцій. Сертифіковані інженери забезпечать надійність. Замовте налаштування інтеграції — виключіть дублювання завдань та втрату часу. Залиште заявку на сайті для розрахунку.