Налаштування інтеграції Bitrix24 з Confluence
Документація лежить у Confluence, робочі процеси — у Bitrix24. Коли менеджер створює задачу, він копіює посилання на статтю 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 прямо з Bitrix24:
- Користувач відкриває віджет (або 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 зберігає облікові дані зашифрованими. Для Cloud — refresh-токен оновлюється автоматично.
Що впроваджуємо
- Middleware для зв'язку сторінок Confluence з задачами Б24
- Автоматичні сповіщення про оновлення документації в чатах Б24
- Пошук по Confluence з інтерфейсу Б24
- Зеркалювання контенту в базу знань Б24 (опціонально)
- Bulk-міграцію сторінок між системами
- Прив'язку та відстеження документації у карточках задач