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

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

Документация лежит в Confluence, а рабочие процессы — в Битрикс24. Когда менеджер создаёт задачу, он копирует ссылку на статью Confluence в описание. Через неделю статья обновляется, а ссылка в задаче ведёт на устаревшую версию — или на страницу, которую переименовали и переместили. Разработчик открывает задачу и видит нерабочую ссылку. Знания в Confluence и работа в Б24 существуют отдельно друг от друга, и ручное связывание не выдерживает даже минимальной нагрузки.

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

Связка строится на 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.

Привязка страниц Confluence к задачам Б24

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
• Поиск по Confluence из интерфейса Б24
• Зеркалирование контента в базу знаний Б24 (опционально)
• Bulk-миграцию страниц между системами
• Привязку и отслеживание документации в карточках задач