Інтеграція Bitrix24 та Trello
Відділ маркетингу веде контент-план у Trello, а задачи від клієнтів приходять через CRM в Bitrix24. Менеджер копіює карточки з Trello у задачи B24 вручну, забуває половину, плутає дедлайни. Дизайнер рухає карточку в Done, а в B24 задача залишається «В роботі» ще три дні — поки хтось не помітить. Два інструменти без зв'язку множать ручну роботу та створюють сліпі зони.
Як влаштована синхронізація
Trello надає REST API та механізм webhooks. Bitrix24 — REST API з вихідними webhooks по подіям. Middleware між ними виконує три функції: отримує події, трансформує дані, відправляє оновлення у парну систему.
Trello (webhook) → Middleware → B24 REST API → задача/CRM
B24 (подія) → Outbound Webhook → Middleware → Trello REST API → карточка
Кожна зв'язка «доска Trello — проект B24» налаштовується окремо. Одна доска може синхронізуватися з одним проектом, кілька дошок — з кількома проектами.
Маппінг структур
Trello та B24 організують роботу по-різному. Відповідність:
| Trello | Bitrix24 | Примітка |
|---|---|---|
| Board | Проект (група) | Одна доска = один проект |
| List | Стадія kanban | «To Do», «In Progress», «Done» → стадії задач |
| Card | Задача | Основна одиниця синхронізації |
| Card name | Назва задачи | Пряма відповідність |
| Card description | Опис задачи | Markdown → HTML |
| Checklist | Чек-лист задачи | Елементи чек-листа синхронізуються по одному |
| Members | Учасники задачи | Через таблицю маппінгу користувачів |
| Due date | Дедлайн | Формат дати конвертується |
| Labels | Теги задачи | Колір та назва → тег |
| Attachments | Файли задачи | Файли перезаливаються через middleware |
Конвертація опису: Trello зберігає текст у Markdown, B24 — у HTML. Middleware використовує парсер (markdown-it або аналог) для трансформації в обидва боки. Зображення в описі скачуються та перезаливаються.
Синхронізація статусів через списки
Переміщення карточки між списками у Trello — це зміна статусу. Webhook updateCard з полем listAfter повідомляє middleware, у який список переместилась карточка. Middleware шукає відповідність у таблиці маппінгу та оновлює стадію задачи в B24.
Зворотне направлення: при зміні стадії задачи в B24 (подія ONTASKUPDATE) middleware рухає карточку у відповідний список Trello через PUT /1/cards/{id} з параметром idList.
Таблиця маппінгу списків налаштовується для кожної доски:
| Список Trello | Стадія B24 |
|---|---|
| Backlog | Нова |
| In Progress | Виконується |
| Review | Чекає контролю |
| Done | Завершена |
Автоматизація через Power-Ups та REST API
Trello Power-Ups дозволяють додати кнопки та дії на карточках. Middleware надає endpoint для Power-Up, який додає на карточку кнопку «Створити в B24». При натисненні — карточка створюється як задача у вибраному проекті.
З боку B24 — робот у бізнес-процесі задач. При створенні задачи з певним тегом (наприклад, «trello») робот викликає webhook на middleware, який створює карточку на потрібній дошці.
Додаткові автоматизації:
- Карточка переміщена у «Done» → задача в B24 закривається + коментар з timestamp
- Новий коментар у карточці → коментар до задачи B24 (та навпаки)
- Додан учасник у карточку → додан спостерігач у задачу B24
- Змінено дедлайн в B24 → оновлено due date карточки
Міграція з Trello на B24
Типовий сценарій: команда переїжджає з Trello на Bitrix24 повністю. Middleware підтримує повну міграцію:
-
Експорт дошок. Через Trello API (
GET /1/boards/{id}/cards) вивантажуються всі карточки з чек-листами, коментарями, вкладеннями та мітками. - Створення структури. У B24 створюються проекти (групи), які відповідають дошкам. Стадії kanban налаштовуються за списками Trello.
-
Перенесення карточок. Кожна карточка створюється як задача через
tasks.task.add. Чек-листи — черезtask.checklistitem.add. Коментарі — черезtask.commentitem.addз зазначенням автора та дати. - Файли. Вкладення скачуються з Trello, завантажуються на диск B24, привязуються до задач.
- Архівні карточки. Переносяться як завершені задачи з збереженням історії.
Обсяг міграції: доска з 500 карточками переносить за 15–30 хвилин (залежить від кількості вкладень та лімітів API).
Обмеження API
Trello API лімітує запити: 100 запитів за 10 секунд на токен, 300 за 10 секунд на ключ. B24 — 2 запити на секунду. Middleware управляє rate limiting:
- Чергу запитів з throttling
- Batch-запити в B24 через
batchметод (до 50 команд за один виклик) - Для Trello —
fieldsтаcard_fieldsпараметри для зменшення кількості запитів (отримувати тільки потрібні поля)
Що впроваджуємо
- Middleware для двосторонньої синхронізації дошок Trello та проектів B24
- Маппінг карточок, списків, чек-листів та учасників
- Автоматичне оновлення статусів при переміщенні карточок
- Power-Up для створення задач B24 з карточок Trello
- Повну міграцію даних з Trello у Bitrix24
- Синхронізацію коментарів та вкладень
- Rate limiting та чергу для роботи в межах API-лімітів