Документация лежит в 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:
- Пользователь открывает виджет (или slash-команду в чате) и вводит поисковый запрос.
- Middleware вызывает
GET /wiki/rest/api/content/search?cql=text~"{query}"— поиск по CQL (Confluence Query Language). - Результаты отображаются с заголовками, пространствами и датами обновления.
- Пользователь кликает — ссылка открывается в Confluence или привязывается к текущей задаче.
Для чат-ботов Б24 — команда /wiki {запрос}, которая возвращает топ-5 результатов поиска в формате сообщения.
Синхронизация контента
Два режима синхронизации:
| Режим | Описание | Применение |
|---|---|---|
| Ссылочный | В Б24 хранится только ссылка и метаданные страницы. Контент читается в Confluence. | Стандартный сценарий |
| Зеркальный | Контент страницы дублируется в базу знаний Б24 (раздел «Знания»). | Для команд, работающих преимущественно в Б24 |
Зеркальный режим: middleware при обновлении страницы Confluence запрашивает контент через GET /wiki/rest/api/content/{id}?expand=body.storage, конвертирует Confluence Storage Format (XHTML-подобный) в формат Б24 и создаёт или обновляет статью в разделе «База знаний» через API Б24.
Миграция контента
Для переезда с Confluence на базу знаний Б24 (или наоборот) middleware поддерживает bulk-миграцию:
- Выгрузка дерева страниц из пространства Confluence через
GET /wiki/rest/api/content?spaceKey={key}&type=page&limit=100с пагинацией. - Конвертация контента из Confluence Storage Format: таблицы, макросы, вложения, изображения.
- Создание страниц в базе знаний Б24 с сохранением иерархии (parent-child).
- Перенос вложений: скачивание через
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 дня. Закажите интеграцию под ключ и избавьтесь от ручного копирования ссылок.