Интеграция Битрикс24 с Trello

Интеграция Битрикс24 с Trello

Отдел маркетинга ведёт контент-план в Trello, а задачи от клиентов приходят через CRM в Битрикс24. Менеджер копирует карточки из Trello в задачи Б24 вручную, забывает половину, путает дедлайны. Дизайнер двигает карточку в Done, а в Б24 задача остаётся «В работе» ещё три дня — пока кто-нибудь не заметит. Два инструмента без связи множат ручную работу и создают слепые зоны.

Как устроена синхронизация

Trello предоставляет REST API и механизм webhooks. Битрикс24 — REST API с исходящими webhooks по событиям. Middleware между ними выполняет три функции: принимает события, трансформирует данные, отправляет обновления в парную систему.

Trello (webhook) → Middleware → Б24 REST API → задача/CRM
Б24 (событие) → Outbound Webhook → Middleware → Trello REST API → карточка

Каждая связка «доска Trello — проект Б24» настраивается отдельно. Одна доска может синхронизироваться с одним проектом, несколько досок — с несколькими проектами.

Маппинг структур

Trello и Б24 организуют работу по-разному. Соответствие:

Конвертация описания: Trello хранит текст в Markdown, Б24 — в HTML. Middleware использует парсер (markdown-it или аналог) для преобразования в обе стороны. Изображения в описании скачиваются и перезаливаются.

Синхронизация статусов через списки

Перемещение карточки между списками в Trello — это смена статуса. Webhook updateCard с полем listAfter сообщает middleware, в какой список переместилась карточка. Middleware ищет соответствие в таблице маппинга и обновляет стадию задачи в Б24.

Обратное направление: при смене стадии задачи в Б24 (событие ONTASKUPDATE) middleware перемещает карточку в соответствующий список Trello через PUT /1/cards/{id} с параметром idList.

Таблица маппинга списков настраивается для каждой доски:

Автоматизация через Power-Ups и REST API

Trello Power-Ups позволяют добавить кнопки и действия на карточках. Middleware предоставляет endpoint для Power-Up, который добавляет на карточку кнопку «Создать в Б24». По нажатию — карточка создаётся как задача в выбранном проекте.

Со стороны Б24 — робот в бизнес-процессе задач. При создании задачи с определённым тегом (например, «trello») робот вызывает webhook на middleware, который создаёт карточку на нужной доске.

Дополнительные автоматизации:

• Карточка перемещена в «Done» → задача в Б24 закрывается + комментарий с timestamp
• Новый комментарий в карточке → комментарий к задаче Б24 (и обратно)
• Добавлен участник в карточку → добавлен наблюдатель в задачу Б24
• Изменён дедлайн в Б24 → обновлён due date карточки

Миграция с Trello на Б24

Частый сценарий: команда переезжает с Trello на Битрикс24 полностью. Middleware поддерживает полную миграцию:

1. Экспорт досок. Через Trello API (GET /1/boards/{id}/cards) выгружаются все карточки с чеклистами, комментариями, вложениями и метками.
2. Создание структуры. В Б24 создаются проекты (группы), соответствующие доскам. Стадии канбана настраиваются по спискам Trello.
3. Перенос карточек. Каждая карточка создаётся как задача через tasks.task.add. Чеклисты — через task.checklistitem.add. Комментарии — через task.commentitem.add с указанием автора и даты.
4. Файлы. Вложения скачиваются из Trello, загружаются на диск Б24, привязываются к задачам.
5. Архивные карточки. Переносятся как завершённые задачи с сохранением истории.

Объём миграции: доска с 500 карточками переносится за 15–30 минут (зависит от количества вложений и лимитов API).

Ограничения API

Trello API лимитирует запросы: 100 запросов за 10 секунд на токен, 300 за 10 секунд на ключ. Б24 — 2 запроса в секунду. Middleware управляет rate limiting:

• Очередь запросов с throttling
• Batch-запросы в Б24 через batch метод (до 50 команд за один вызов)
• Для Trello — fields и card_fields параметры для уменьшения числа запросов (получать только нужные поля)

Что внедряем

• Middleware для двусторонней синхронизации досок Trello и проектов Б24
• Маппинг карточек, списков, чеклистов и участников
• Автоматическое обновление статусов при перемещении карточек
• Power-Up для создания задач Б24 из карточек Trello
• Полная миграция данных с Trello в Битрикс24
• Синхронизация комментариев и вложений
• Rate limiting и очередь для работы в рамках API-лимитов