Настройка интеграции Битрикс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);
}