Як автоматично зв'язати Бітрікс24 з Confluence?
Документація лежить у Confluence, а робочі процеси — в Бітрікс24. Коли менеджер створює задачу, він копіює посилання на статтю Confluence в опис. За тиждень стаття оновлюється, а посилання в задачі веде на застарілу версію — або на сторінку, яку перейменували та перемістили. Розробник відкриває задачу та бачить неробоче посилання. Ми вирішуємо цю проблему за допомогою автоматичної інтеграції Бітрікс24 Confluence: зв'язуємо сторінки Confluence з задачами Бітрікс24, синхронізуємо метадані та сповіщаємо команду про зміни. Наша команда має 5+ років досвіду в розробці на Бітрікс24 та понад 50 успішних інтеграцій. Гарантуємо стабільну роботу зв'язки під ключ. Інвестиція в інтеграцію окупається за 2-3 місяці завдяки економії часу до 40%. Наприклад, при зарплаті команди $5000 на місяць економія складає $2000.
Як влаштована архітектура інтеграції?
Зв'язка будується на Confluence REST API v2 (або v1 для Server/Data Center) та Б24 REST API. Middleware обробляє обмін даними між системами: відстежує зміни в Confluence та транслює їх в Б24, а також синхронізує посилання та метадані. Документація Confluence REST API описує всі endpoints. Інтеграція через middleware у 10 разів швидша за ручне оновлення посилань.
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 результатів пошуку у форматі повідомлення. Пошук через віджет у 3 рази швидше за відкриття Confluence в браузері.
Синхронізація контенту
Два режими синхронізації:
| Режим | Опис | Застосування |
|---|---|---|
| Посилальний | В Б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-блоки.
Деталі про автентифікацію
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 транслює події Confluence в чати Б24. Налаштовується автоматизація сповіщень про зміни в Confluence:
- Нова сторінка в просторі проекту → повідомлення в чат проекту Б24.
- Оновлення сторінки → сповіщення підписаним користувачам (маппінг Confluence watchers → Б24 users).
- Новий коментар → повідомлення автору прив'язаної задачі. Автоматичне сповіщення в 5 разів швидше за ручне.
Окупність інтеграції
Більшість команд відзначають економію часу до 40% на пошуку інформації та оновленні посилань. Вартість інтеграції починається від $500, а економія може досягати $2000 на місяць. Окупність настає за 2-3 місяці.
Що входить в роботу
- Розробка та розгортання middleware для зв'язки Confluence і Бітрікс24.
- Налаштування кастомних полів та плейсментів у задачах Б24.
- Конфігурація webhooks та обробка подій.
- Реалізація пошуку та дзеркалювання контенту.
- Тестування та оптимізація продуктивності.
- Документація з експлуатації та навчання команди.
- Підтримка після впровадження.
Зв'яжіться з нами для оцінки вашого проекту — розрахуємо вартість та терміни за 1-2 дні. Замовте інтеграцію під ключ і позбудьтесь ручного копіювання посилань.