Настройка интеграции Битрикс24 с Confluence

Документация лежит в Confluence, а рабочие процессы — в Битрикс24. Когда менеджер создаёт задачу, он копирует ссылку на статью Confluence в описание. Через неделю статья обновляется, а ссылка в задаче ведёт на устаревшую версию — или на страницу, которую переименовали и переместили. Разработчик открывает задачу и видит нерабочую ссылку. Мы решаем эту проблему с помощью автоматической интеграции: связываем страницы Confluence с задачами Битрикс24, синхронизируем метаданные и уведомляем команду об изменениях. Наша команда имеет 5+ лет опыта в разработке на Битрикс24 и более 50 успешных интеграций. Гарантируем стабильную работу связки под ключ.

Архитектура интеграции

Связка строится на Confluence REST API v2 (или v1 для Server/Data Center) и Б24 REST API. Middleware обрабатывает обмен данными между системами: отслеживает изменения в Confluence и транслирует их в Б24, а также синхронизирует ссылки и метаданные.

Confluence (webhook) → Middleware → Б24 REST API → Задачи/Чат/Лента
Б24 (задача/CRM) → Middleware → Confluence API → Поиск/Получение страниц

Confluence Cloud поддерживает webhooks через Connect-приложения или Forge. Для Server/Data Center — плагины или встроенные webhooks (Administration → Webhooks). Middleware подписывается на события: page_created, page_updated, page_removed, comment_created.

Как автоматизировать привязку документации к задачам?

Middleware автоматизирует привязку документации к задачам. Кастомное поле UF_CONFLUENCE_URL в задачах Б24 хранит ссылку на страницу Confluence. Middleware по ссылке извлекает content_id и через API подтягивает метаданные: заголовок, автора, дату обновления. Плейсмент в карточке задачи (локальное приложение Б24 TASK_VIEW_TAB) отображает вкладку «Документация» — список привязанных страниц с актуальными заголовками, статусами и превью.

При изменении страницы Confluence (webhook page_updated) middleware находит все задачи Б24, в которых эта страница привязана, и добавляет комментарий: «Страница "{title}" обновлена {автор}, {дата}. Ссылка: {url}».

Поиск по Confluence из Б24

Middleware предоставляет интерфейс поиска по Confluence прямо из Битрикс24:

1. Пользователь открывает виджет (или slash-команду в чате) и вводит поисковый запрос.
2. Middleware вызывает GET /wiki/rest/api/content/search?cql=text~"{query}" — поиск по CQL (Confluence Query Language).
3. Результаты отображаются с заголовками, пространствами и датами обновления.
4. Пользователь кликает — ссылка открывается в Confluence или привязывается к текущей задаче.

Для чат-ботов Б24 — команда /wiki {запрос}, которая возвращает топ-5 результатов поиска в формате сообщения.

Синхронизация контента

Два режима синхронизации:

Зеркальный режим: middleware при обновлении страницы Confluence запрашивает контент через GET /wiki/rest/api/content/{id}?expand=body.storage, конвертирует Confluence Storage Format (XHTML-подобный) в формат Б24 и создаёт или обновляет статью в разделе «База знаний» через API Б24.

Миграция контента

Для переезда с Confluence на базу знаний Б24 (или наоборот) middleware поддерживает bulk-миграцию:

1. Выгрузка дерева страниц из пространства Confluence через GET /wiki/rest/api/content?spaceKey={key}&type=page&limit=100 с пагинацией.
2. Конвертация контента из Confluence Storage Format: таблицы, макросы, вложения, изображения.
3. Создание страниц в базе знаний Б24 с сохранением иерархии (parent-child).
4. Перенос вложений: скачивание через GET /wiki/rest/api/content/{id}/child/attachment, загрузка на диск Б24.

Макросы Confluence (code blocks, info panels, expand) конвертируются в ближайшие аналоги Б24 или заменяются на HTML-блоки.

Уведомления об изменениях

Middleware транслирует события Confluence в чаты Б24:

• Новая страница в пространстве проекта → сообщение в чат проекта Б24.
• Обновление страницы → уведомление подписанным пользователям (маппинг Confluence watchers → Б24 users).
• Новый комментарий → сообщение автору привязанной задачи.

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

• Confluence Cloud: OAuth 2.0 через Atlassian Connect или API token (email:token в Basic Auth).
• Confluence Server/Data Center: Personal Access Token или Basic Auth.
• Б24: OAuth 2.0 с scope task,im,disk,user.
• Middleware хранит credentials зашифрованными. Для Cloud — refresh-токен обновляется автоматически.

Что входит в работу

• Разработка и развёртывание middleware для связки Confluence и Битрикс24.
• Настройка кастомных полей и плейсментов в задачах Б24.
• Конфигурация webhooks и обработка событий.
• Реализация поиска и зеркалирования контента.
• Тестирование и оптимизация производительности.
• Документация по эксплуатации и обучение команды.
• Поддержка после внедрения.

Свяжитесь с нами для оценки вашего проекта — рассчитаем стоимость и сроки за 1-2 дня. Закажите интеграцию под ключ и избавьтесь от ручного копирования ссылок.

Как корпоративный портал на Битрикс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. При увольнении блокируется везде. Ручное создание аккаунтов исключено, ошибки минимизированы.

Типы корпоративных порталов и ключевые интеграции

Безопасность и соответствие 152-ФЗ

На портале — персональные данные, финансовая отчетность, стратегические планы. Мы гарантируем защиту:

• ролевая модель через CGroup и права на уровне разделов;
• двухфакторная аутентификация (OTP, Яндекс.Ключ, SMS);
• аудит всех действий (b_event_log);
• шифрование TLS на передачу и шифрование дисков;
• полное соответствие Федеральному закону № 152-ФЗ «О персональных данных».

Как происходит внедрение? Пошаговый план

1. Аудит — фиксируем текущие процессы, замеряем потери времени.
2. Проектирование — выбираем тип портала, планируем интеграции.
3. Реализация — настраиваем бизнес-процессы, права, интерфейс.
4. Тест — пилотная группа проверяет сценарии, мы исправляем недочеты.
5. Запуск — подключаем всех сотрудников, обучаем, передаем документацию.

В результате вы получаете: проектную документацию, настроенный портал с интеграциями, описание бизнес-процессов, инструкции для администраторов и пользователей, 30 дней технической поддержки после запуска.

Поддержка после запуска: как не дать порталу умереть

Через полгода многие порталы становятся заброшенными. Чтобы этого избежать, предлагаем пакеты с фиксированным SLA и выделенным администратором. Мониторинг производительности, обновления платформы, администрирование пользователей, доработка новых модулей. Опыт нашей команды — более 50 внедрений корпоративных порталов на Битрикс24. Мы являемся сертифицированным партнером 1С-Битрикс, гарантируем качество и сроки.

Мобильный доступ. Нативное приложение Битрикс24 (iOS/Android) с push-уведомлениями, задачами, чатами. Адаптивный веб-интерфейс для экстранет-пользователей (не надо ставить приложение). Офлайн-доступ к документам и задачам, синхронизация при восстановлении связи.

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

Свяжитесь с нами — оценим ваш проект, предложим архитектуру и сроки. Получите консультацию бесплатно и убедитесь, что портал окупается в первые полгода.