Інтеграція Бітрікс24 з Jira
Якщо менеджери використовують Бітрікс24 для планування, а розробники — Jira для реалізації, дані розходяться. Задачі дублюються, статуси не збігаються, а менеджеру доводиться щоразу перемикатися між системами. Наш middleware синхронізує обидва середовища в реальному часі: зміни в Бітрікс24 миттєво відображаються в Jira і навпаки. Досвід понад 5 років в інтеграціях Бітрікс24 — ми гарантуємо надійне рішення без втрати даних. Інтеграція підходить для будь-яких версій: хмарний і on-premise Бітрікс24, Jira Cloud, Server та Data Center.
Як влаштована синхронізація?
Інтеграція будується на двонаправленому обміні через REST API обох систем. Middleware обробляє події та перетворює дані з формату однієї системи у формат іншої. Для цього використовується таблиця маппінгу, яка зв'язує ID задач і користувачів. Без неї системи не зможуть спілкуватися.
Б24 Task → Webhook → Middleware → Jira REST API → Issue Jira Issue → Jira Webhook → Middleware → Б24 REST API → Task Маппінг полів
Поля в системах відрізняються. Middleware транслює їх за заданими правилами.
| Поле Бітрікс24 | Поле Jira | Примітка |
|---|---|---|
| TITLE | summary | Пряма відповідність |
| DESCRIPTION | description | Конвертація HTML ↔ ADF |
| RESPONSIBLE_ID | assignee | За таблицею користувачів |
| CREATED_BY | reporter | Аналогічно |
| DEADLINE | duedate | Формат дати ISO 8601 |
| PRIORITY | priority.id | Маппінг значень |
| STATUS | status.id | Налаштовувана таблиця |
| GROUP_ID | project.key | Проєкт → проєкт |
| UF_* | customfield_* | Індивідуально |
Конвертація опису — нетривіальне завдання. Бітрікс24 зберігає описи в HTML, Jira використовує ADF (JSON-дерево). Middleware парсить HTML, перетворює в вузли ADF і назад.
Чому виникає зациклення і як його уникнути?
Якщо не контролювати джерело, оновлення з однієї системи викликає оновлення в іншій — і так до нескінченності. Ми вирішуємо це маркуванням: middleware записує прапорець UF_SYNC_SOURCE = "jira" у задачу Бітрікс24 або customfield_sync_source = "b24" в issue Jira. Отримавши вебхук, middleware перевіряє прапорець і пропускає власні оновлення. Прапорець скидається через 5 секунд задачею cron.
Маппінг статусів
Workflow у Jira та стадії в Бітрікс24 — індивідуальні для кожної команди. Middleware використовує налаштовувану таблицю:
| Статус Бітрікс24 | Статус Jira | Напрямок |
|---|---|---|
| Нова (2) | To Do | ↔ |
| Виконується (3) | In Progress | ↔ |
| Чекає контролю (4) | In Review | Б24 → Jira |
| На паузі (6) | On Hold | ↔ |
| Завершена (5) | Done | ↔ |
| — | QA Testing | Jira → Б24 |
Переходи в Jira вимагають виклику POST /rest/api/3/issue/{id}/transitions з ID конкретного переходу. Middleware запитує доступні transitions і виконує потрібний.
Webhook-підписки
З боку Бітрікс24 реєструємо обробники через event.bind (див. REST API Бітрікс24):
-
ONTASKADD— нове завдання → створення issue -
ONTASKUPDATE— оновлення → оновлення issue -
ONTASKCOMMENTADD— коментар → коментар до issue -
ONTASKDELETE— видалення → закриття/видалення issue
З боку Jira — через системні Webhooks:
-
jira:issue_created→ нове завдання Бітрікс24 -
jira:issue_updated→ оновлення завдання -
comment_created→ коментар до завдання
Кожен вебхук містить повний payload. Middleware витягує змінені поля з changelog.items (Jira) або порівнює зі збереженою копією (Бітрікс24, де changelog недоступний).
Синхронізація коментарів
Коментарі передаються в обидві сторони із зазначенням автора. З Бітрікс24 в Jira — POST /rest/api/3/issue/{id}/comment з перетворенням в ADF. З Jira в Бітрікс24 — task.commentitem.add з префіксом з імені автора. Вкладення завантажуються і передаються через API файлів.
Первинна міграція
Перед включенням синхронізації переносимо існуючі завдання. Утиліта вивантажує дані з Бітрікс24 пачками через tasks.task.list, створює issues у Jira через bulk API, потім виконує зворотне вивантаження. Після міграції вмикаються вебхуки — real-time синхронізація.
Що входить в нашу роботу
- Розгортання middleware на вашому сервері або в хмарі
- Налаштування маппінгу полів і статусів під ваш workflow
- Інтеграція з системами авторизації (OAuth 2.0, токени)
- Синхронізація коментарів і вкладень
- Захист від зациклення
- Первинна міграція завдань
- Маппінг користувачів між системами
- Моніторинг та логування
- Документація та навчання команди
- Гарантія роботи інтеграції
Терміни та вартість
Базове налаштування інтеграції займає від 3 до 7 днів. Час залежить від складності маппінгу, кількості полів та необхідності кастомізацій. Вартість розраховується індивідуально після оцінки проекту — зв'яжіться з нами, і ми надішлемо комерційну пропозицію протягом доби.
Автоматична синхронізація скорочує час на дублювання даних у 10 разів порівняно з ручним веденням. Проєкт окупається за перші місяці використання. Наш досвід — понад 5 років і 15+ впроваджень інтеграцій Бітрікс24 — підтверджує надійність рішення. Зв'яжіться з нами, щоб обговорити вашу задачу.