Интеграция Битрикс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 — подтверждает надёжность решения. Свяжитесь с нами, чтобы обсудить вашу задачу.
Как корпоративный портал на Битрикс24 решает проблему информационного хаоса?
Сотрудники тратят до 2 часов в день на поиск файлов, писем и решений. Задачи теряются в десятке чатов, согласования застревают на недели. Руководитель узнает о срыве дедлайна только на летучке. Корпоративный портал на Битрикс24 привязывает каждое сообщение, документ и задачу к единому контексту. Вы получаете прозрачную картину работы: кто над чем, какие этапы, где узкие места. Оценим ваш проект бесплатно — свяжитесь с нами, чтобы получить архитектуру за 2 дня.
Что даёт портал в ежедневной работе и почему это лучше мессенджеров?
В мессенджерах информация неструктурирована — через неделю обсуждение утонуло. В портале каждое сообщение привязано к задаче, проекту или документу. Сотрудники тратят до 30% рабочего времени на поиск данных (по McKinsey). Портал сокращает это время в 2–3 раза за счет структурированных хранилищ и полнотекстового поиска.
Коммуникации. Живая лента, мессенджер и видеозвонки привязываются к конкретным задачам. Через полгода можно найти любое обсуждение — в мессенджере оно бы утонуло через неделю.
Задачи и проекты. Канбан, Гант, чеклисты, зависимости, учет времени. Эффективность каждого сотрудника видна в отчетах — не нужно ждать совещания.
Документооборот. Маршруты согласования через дизайнер бизнес-процессов: заявка на отпуск → руководитель → HR → бухгалтерия. Электронная подпись, версионирование, контроль сроков. Интеграция с электронным документооборотом (СБИС, Диадок) через REST API.
HR. Адаптация новичков, заявки на отпуск/командировку, оргструктура, график отсутствий. Сотрудник с первого дня знает, куда идти.
База знаний. Wiki-движок Битрикс24: регламенты, инструкции. Знания не уходят с увольняющимися.
Пример из внедрения. Для производственной компании с 320 сотрудниками мы запустили портал с интеграцией 1С:ЗУП и Active Directory за 4 месяца. Время согласования заявок на командировки сократилось с 3 дней до 4 часов. Экономия на простое сотрудников — 1,5 млн рублей в год. Руководители получают автоматические отчеты по эффективности подразделений. Срок ответа клиентам уменьшился на 20%. Окупаемость портала — 7 месяцев.
Как интеграция с 1С и Active Directory ускоряет кадровый учёт?
Интеграция с 1С:Предприятие через модуль b24connector или кастомный REST-обработчик: заявка на отпуск утверждается на портале через бизнес-процесс и автоматически попадает в 1С:ЗУП для расчета отпускных. Active Directory (SSO через модуль ldap) — учетка сотрудника создается один раз в AD и синхронизируется на портал, почту, VPN. При увольнении блокируется везде. Ручное создание аккаунтов исключено, ошибки минимизированы.
Типы корпоративных порталов и ключевые интеграции
| Тип |
Цель |
Ключевая функция |
| Интранет |
Внутренние коммуникации и сервисы |
Новости, телефонный справочник (синхронизация с Active Directory), бронирование переговорных, заявки на IT через БП |
| HR-портал |
Кадровый учет и развитие |
Профили, KPI/OKR на кастомных HL-блоках, обучение, электронный документооборот |
| Портал знаний |
Документация и регламенты |
Категоризация, теги, рейтинги, подписки на обновления |
| Экстранет |
Работа с партнерами и подрядчиками |
Гранулярные права через CGroup и модуль extranet, доступ без 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 недели |
Интервью, анализ процессов, архитектура, план интеграций |
| 2. Настройка и кастомизация |
3–6 недель |
Структура, роли, БП, брендирование (CSS шаблон) |
| 3. Интеграции |
2–4 недели |
1С, AD, почта, телефония, ЭДО |
| 4. Миграция данных |
1–2 недели |
Документы, справочники, сотрудники из текущих систем |
| 5. Обучение и пилот |
1–2 недели |
Администраторы, ключевые пользователи, пилот 20–30 чел. |
| 6. Масштабирование |
2–4 недели |
Подключение подразделений, донастройка по обратной связи |
-
Аудит — фиксируем текущие процессы, замеряем потери времени.
-
Проектирование — выбираем тип портала, планируем интеграции.
-
Реализация — настраиваем бизнес-процессы, права, интерфейс.
-
Тест — пилотная группа проверяет сценарии, мы исправляем недочеты.
-
Запуск — подключаем всех сотрудников, обучаем, передаем документацию.
В результате вы получаете: проектную документацию, настроенный портал с интеграциями, описание бизнес-процессов, инструкции для администраторов и пользователей, 30 дней технической поддержки после запуска.
Поддержка после запуска: как не дать порталу умереть
Через полгода многие порталы становятся заброшенными. Чтобы этого избежать, предлагаем пакеты с фиксированным SLA и выделенным администратором. Мониторинг производительности, обновления платформы, администрирование пользователей, доработка новых модулей. Опыт нашей команды — более 50 внедрений корпоративных порталов на Битрикс24. Мы являемся сертифицированным партнером 1С-Битрикс, гарантируем качество и сроки.
Мобильный доступ. Нативное приложение Битрикс24 (iOS/Android) с push-уведомлениями, задачами, чатами. Адаптивный веб-интерфейс для экстранет-пользователей (не надо ставить приложение). Офлайн-доступ к документам и задачам, синхронизация при восстановлении связи.
Закажите внедрение корпоративного портала под ключ
Свяжитесь с нами — оценим ваш проект, предложим архитектуру и сроки. Получите консультацию бесплатно и убедитесь, что портал окупается в первые полгода.