Налаштування інтеграції Бітрікс24 з Miro: під ключ

Після брейнштормів у Miro стікери часто залишаються на дошці, а завдання в Бітрікс24 не з'являються. Команда витрачає до 5 годин на тиждень на ручне перенесення. Ми налаштовуємо інтеграцію під ключ: стікери перетворюються на завдання, статуси синхронізуються, дошки вбудовуються в інтерфейс. Оцінимо ваш проєкт і запропонуємо рішення за два дні. Напишіть нам — реалізуємо міст між Miro та Бітрікс24 без ручного перенесення. Наш досвід понад 5 років гарантує стабільну роботу. Час перенесення завдань скорочується в 10 разів, а помилки виключаються повністю.

Як middleware зв'язує Miro та Бітрікс24?

Зв'язка використовує Miro REST API v2 та Бітрікс24 REST API. Miro надає API для роботи з дошками, стікерами, фреймами та конекторами. Б24 — вебхуки для подій завдань та CRM. Middleware обробляє обмін даними між системами.

Miro (webhook) → Middleware → Б24 REST API → Завдання/Коментарі Б24 (подія) → Webhook → Middleware → Miro REST API → Стікери/Картки 

Miro підтримує webhooks — підписка на події дошки через POST /v2/boards/{board_id}/webhooks. Middleware отримує сповіщення при створенні, зміні та видаленні елементів. Як зазначено в документації Miro REST API, вебхуки надсилають JSON-об'єкт з типом події та даними елемента.

Як автоматизувати перенесення стікерів у завдання?

Ключовий сценарій — перетворення стікерів Miro на завдання Б24. Middleware відстежує стікери з певним маркером (колір, тег або префікс у тексті):

Технічна реалізація:

1. Miro webhook надсилає подію item_created або item_updated.
2. Middleware отримує дані стікера через GET /v2/boards/{board_id}/items/{item_id}.
3. Текст стікера парситься: перший рядок — назва завдання, решта — опис.
4. Завдання створюється через tasks.task.add з прив'язкою до проєкту (визначається за фреймом, в якому знаходиться стікер).
5. ID створеного завдання записується назад у стікер як тег — для двостороннього зв'язку.

Автоматизація скорочує час перенесення завдань у 10 разів порівняно з ручним копіюванням. Замовте впровадження — отримайте готове рішення за 2 дні.

Порівняння способів вбудовування дощок Miro в Б24

Iframe простіший, але placement дає вбудоване управління правами. Вибір залежить від потреб команди.

Вбудовування дощок Miro в Б24

Miro-дошки вбудовуються в інтерфейс Бітрікс24 двома способами:

• Iframe у завданні. В опис завдання або кастомне поле додається embed-посилання формату https://miro.com/app/live-embed/{board_id}/. Користувач бачить інтерактивну дошку прямо в картці завдання.
• Додаток у маркетплейсі Б24. Локальний додаток (тип placement) вбудовує Miro-віджет у картку завдання або угоди через REST-плейсмент TASK_VIEW_TAB. Користувач відкриває вкладку «Дошка» і бачить прив'язану Miro-дошку.

Для авторизації у вбудованій дошці Miro використовує власну сесію користувача. Middleware передає access_token через OAuth 2.0 flow при першому вході.

Як відбувається синхронізація статусів?

При переміщенні стікера між фреймами на дошці (наприклад, з «To Do» в «In Progress») middleware оновлює статус завдання в Б24. Фрейми мапляться на стадії:

• Middleware запитує позицію стікера через API та визначає, в якому фреймі він знаходиться.
• Назва фрейму зіставляється зі статусом завдання через конфігурацію.
• Виклик tasks.task.update з новим статусом.

Зворотній напрямок: при зміні статусу завдання в Б24 middleware переміщує стікер у відповідний фрейм через PATCH /v2/boards/{board_id}/items/{item_id} з новими координатами.

Проєктна колаборація

Для проєктної роботи налаштовуємо автоматичне створення Miro-дошки при створенні проєкту в Б24:

1. Подія ONSOCNETGROUPADD (створення проєкту/групи) → middleware викликає POST /v2/boards з шаблоном дошки.
2. Посилання на дошку зберігається в описі проєкту Б24.
3. Учасники проєкту отримують доступ до дошки через POST /v2/boards/{board_id}/members — email береться з профілів Б24.

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

• Miro: OAuth 2.0. Додаток реєструється на https://miro.com/app/settings/user-profile/apps/. Scope: boards:read, boards:write, identity:read.
• Б24: OAuth 2.0 з scope task,sonet_group,user.
• Токени зберігаються зашифрованими на middleware. Refresh виконується автоматично.

Що входить у налаштування

• Middleware для двосторонньої інтеграції Miro-дошок і завдань Б24
• Автоматичне створення завдань зі стікерів Miro за кольоровою маркуванням
• Вбудовування Miro-дошок в інтерфейс Бітрікс24
• Синхронізація статусів через маппінг фреймів і стадій завдань
• Автоматичне створення дошок при запуску проєктів
• Управління доступом учасників між системами
• Документація та навчання команди

<?php // Приклад middleware для обробки webhook Miro require_once 'vendor/autoload.php'; $payload = json_decode(file_get_contents('php://input'), true); if ($payload['event'] === 'item_created') { $itemId = $payload['data']['id']; $boardId = $payload['data']['boardId']; // Отримання даних стікера через Miro API $miro = new MiroClient(getenv('MIRO_TOKEN')); $item = $miro->getItem($boardId, $itemId); // Створення завдання в Бітрікс24 $bitrix = new Bitrix24Client(getenv('BX_WEBHOOK_URL')); $taskId = $bitrix->createTask($item['data']['title'], $item['data']['description']); // Запис ID завдання в тег стікера $miro->addTag($boardId, $itemId, 'bx_task_'.$taskId); }