Интеграция Битрикс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 — подтверждает надёжность решения. Свяжитесь с нами, чтобы обсудить вашу задачу.