Настройка интеграции Битрикс24 с Figma
Дизайнер обновляет макет в Figma, но разработчик узнаёт об этом через два дня — когда менеджер случайно спрашивает в чате. Ссылки на макеты разбросаны по задачам, комментариям и личным сообщениям. Актуальная версия — непонятно какая: в задаче прикреплён скриншот трёхнедельной давности, а текущий макет живёт в ветке Figma, о которой знает только автор. Мы решаем эту проблему: наша интеграция связывает Figma и Битрикс24, чтобы каждый участник команды видел актуальный дизайн прямо в задачах. Под ключ настраиваем автоматическое обновление превью, уведомления об изменениях и синхронизацию комментариев.
Почему эта интеграция необходима?
Без связки дизайн-процесс превращается в поиск актуальных ссылок. Разработчики тратят до 30% времени на уточнение версий макетов. Интеграция через middleware в 3 раза сокращает время на согласование дизайна: все изменения фиксируются в задачах, а комментарии синхронизируются между Figma и Битрикс24.
Архитектура интеграции
Интеграция строится на Figma REST API и Битрикс24 REST API. Figma предоставляет API для получения данных о файлах, комментариях и версиях. Webhooks отправляют уведомления при изменениях. Middleware связывает события Figma с сущностями Б24.
Figma (webhook) → Middleware → Б24 REST API → Задачи/Чат/Лента
Б24 (задача/CRM) → Middleware → Figma API → Получение данных о файле
Figma Webhooks поддерживают события: FILE_UPDATE, FILE_VERSION_UPDATE, FILE_COMMENT, FILE_DELETE. Регистрация — через POST /v2/webhooks с указанием team_id и event_type.
Привязка макетов к задачам
Каждая задача в Б24, связанная с дизайном, получает ссылку на Figma-файл или конкретный фрейм. Два варианта реализации:
-
Кастомное поле. В задачах Б24 создаётся поле
UF_FIGMA_URL типа «строка». Middleware валидирует формат ссылки (https://www.figma.com/file/{file_key}/...) и извлекает file_key и node_id для API-запросов.
- Плейсмент в карточке задачи. Локальное приложение Б24 добавляет вкладку в карточку задачи (
TASK_VIEW_TAB), которая отображает превью макета и основные метаданные: название файла, последнее обновление, количество комментариев.
Превью макета получается через GET /v1/images/{file_key} с параметром ids (список node_id). Figma возвращает URL растрового изображения, который middleware кеширует и отдаёт в интерфейс Б24.
Как работают уведомления об обновлениях?
При изменении файла в Figma middleware отправляет уведомления в Б24:
| Событие Figma |
Действие в Б24 |
Получатель |
| FILE_VERSION_UPDATE |
Комментарий в привязанной задаче |
Исполнитель задачи |
| FILE_COMMENT |
Сообщение в чат проекта |
Участники проекта |
| FILE_UPDATE (значимое) |
Уведомление в ленту |
Ответственный |
Событие FILE_VERSION_UPDATE — самое важное. Оно приходит, когда дизайнер сохраняет именованную версию (Save to Version History). Middleware получает webhook payload с file_key, file_name и timestamp, находит все задачи Б24 с этим file_key в поле UF_FIGMA_URL и добавляет комментарий: название версии, время, ссылка на файл.
Для FILE_COMMENT middleware подтягивает текст комментария через GET /v1/files/{file_key}/comments и транслирует его в чат соответствующего проекта Б24 через im.message.add.
Workflow дизайн-ревью
Настраиваем процесс согласования макетов через задачи Б24:
- Дизайнер завершает макет и меняет статус задачи на «На ревью».
- Middleware по событию
ONTASKUPDATE запрашивает превью из Figma API и прикрепляет актуальный скриншот к задаче через task.commentitem.add.
- Ревьюер видит скриншот в задаче, оставляет комментарий.
- Middleware при желании транслирует комментарий из Б24 обратно в Figma через
POST /v1/files/{file_key}/comments с координатами фрейма.
Это замыкает цикл: дизайнер видит фидбек в Figma, менеджер — в Б24. Никто не переключается между инструментами.
Генерация превью
Middleware периодически (по расписанию или по событию) обновляет превью макетов:
- Запрос
GET /v1/images/{file_key}?ids={node_ids}&format=png&scale=2 возвращает URL изображений.
- Middleware скачивает изображения и загружает на диск Б24 через
disk.file.uploadtofolder.
- Ссылка на файл обновляется в кастомном поле задачи.
Rate limit Figma API — 120 запросов в минуту. Middleware распределяет запросы с учётом лимита.
Аутентификация
- Figma: Personal Access Token или OAuth 2.0. Для команды рекомендуется OAuth — токен привязан к пользователю и имеет доступ ко всем файлам, к которым имеет доступ этот пользователь.
- Б24: OAuth 2.0 с scope
task,im,disk,user.
- Webhooks Figma привязаны к
team_id — одна подписка покрывает все файлы команды.
Что входит в работу
- Middleware для связки Figma-файлов с задачами Б24
- Уведомления об обновлениях макетов и комментариях в задачах и чатах Б24
- Автоматическая генерация и обновление превью макетов
- Workflow дизайн-ревью с двусторонней синхронизацией комментариев
- Встраивание превью Figma в карточку задачи Б24
- Кеширование и ротация превью с учётом rate limits
- Документация и передача доступов
- Техническая поддержка на этапе внедрения
Сравнение: ручной процесс vs автоматизация
| Параметр |
Ручной процесс |
Автоматизация |
| Время на обновление макета в задаче |
10-15 мин |
Мгновенно |
| Риск ошибки (не та версия) |
Высокий |
Низкий |
| Согласование одного ревью |
В среднем 1 день |
2-3 часа |
Наш опыт — более 5 лет интеграций Figma и Битрикс24, более 50 успешных проектов. Сертифицированные специалисты гарантируют стабильную работу решения.
Хотите так же ускорить дизайн-процесс? Свяжитесь с нами — оценим ваш проект и предложим оптимальную архитектуру интеграции.
Как корпоративный портал на Битрикс24 решает проблему информационного хаоса?
Сотрудники тратят до 2 часов в день на поиск файлов, писем и решений. Задачи теряются в десятке чатов, согласования застревают на недели. Руководитель узнает о срыве дедлайна только на летучке. Корпоративный портал на Битрикс24 привязывает каждое сообщение, документ и задачу к единому контексту. Вы получаете прозрачную картину работы: кто над чем, какие этапы, где узкие места. Оценим ваш проект бесплатно — свяжитесь с нами, чтобы получить архитектуру за 2 дня.
Что даёт портал в ежедневной работе и почему это лучше мессенджеров?
В мессенджерах информация неструктурирована — через неделю обсуждение утонуло. В портале каждое сообщение привязано к задаче, проекту или документу. Сотрудники тратят до 30% рабочего времени на поиск данных (по McKinsey). Портал сокращает это время в 2–3 раза за счет структурированных хранилищ и полнотекстового поиска.
Коммуникации. Живая лента, мессенджер и видеозвонки привязываются к конкретным задачам. Через полгода можно найти любое обсуждение — в мессенджере оно бы утонуло через неделю.
Задачи и проекты. Канбан, Гант, чеклисты, зависимости, учет времени. Эффективность каждого сотрудника видна в отчетах — не нужно ждать совещания.
Документооборот. Маршруты согласования через дизайнер бизнес-процессов: заявка на отпуск → руководитель → HR → бухгалтерия. Электронная подпись, версионирование, контроль сроков. Интеграция с электронным документооборотом (СБИС, Диадок) через REST API.
HR. Адаптация новичков, заявки на отпуск/командировку, оргструктура, график отсутствий. Сотрудник с первого дня знает, куда идти.
База знаний. Wiki-движок Битрикс24: регламенты, инструкции. Знания не уходят с увольняющимися.
Пример из внедрения. Для производственной компании с 320 сотрудниками мы запустили портал с интеграцией 1С:ЗУП и Active Directory за 4 месяца. Время согласования заявок на командировки сократилось с 3 дней до 4 часов. Экономия на простое сотрудников — 1,5 млн рублей в год. Руководители получают автоматические отчеты по эффективности подразделений. Срок ответа клиентам уменьшился на 20%. Окупаемость портала — 7 месяцев.
Как интеграция с 1С и Active Directory ускоряет кадровый учёт?
Интеграция с 1С:Предприятие через модуль b24connector или кастомный REST-обработчик: заявка на отпуск утверждается на портале через бизнес-процесс и автоматически попадает в 1С:ЗУП для расчета отпускных. Active Directory (SSO через модуль ldap) — учетка сотрудника создается один раз в AD и синхронизируется на портал, почту, VPN. При увольнении блокируется везде. Ручное создание аккаунтов исключено, ошибки минимизированы.
Типы корпоративных порталов и ключевые интеграции
| Тип |
Цель |
Ключевая функция |
| Интранет |
Внутренние коммуникации и сервисы |
Новости, телефонный справочник (синхронизация с Active Directory), бронирование переговорных, заявки на IT через БП |
| HR-портал |
Кадровый учет и развитие |
Профили, KPI/OKR на кастомных HL-блоках, обучение, электронный документооборот |
| Портал знаний |
Документация и регламенты |
Категоризация, теги, рейтинги, подписки на обновления |
| Экстранет |
Работа с партнерами и подрядчиками |
Гранулярные права через CGroup и модуль extranet, доступ без VPN |
| Портал холдинга |
Управление мультикомпанейной структурой |
Раздельные рабочие пространства, консолидированная отчетность, сквозные БП |
Дополнительные интеграции, дающие реальную ценность
- Почта. Exchange через EWS API или IMAP, синхронизация календарей, создание задачи из письма.
- IP-телефония. Asterisk, Mango Office, Zadarma через REST API — звонки из портала, карточка контакта, запись разговоров.
- Видеоконференции. Встроенные видеозвонки или интеграция с Zoom/Teams через marketplace.
- ЭДО. СБИС, Диадок через REST API — полностью электронный документооборот с контрагентами.
Безопасность и соответствие 152-ФЗ
На портале — персональные данные, финансовая отчетность, стратегические планы. Мы гарантируем защиту:
- ролевая модель через CGroup и права на уровне разделов;
- двухфакторная аутентификация (OTP, Яндекс.Ключ, SMS);
- аудит всех действий (b_event_log);
- шифрование TLS на передачу и шифрование дисков;
- полное соответствие Федеральному закону № 152-ФЗ «О персональных данных».
Как происходит внедрение? Пошаговый план
| Этап |
Срок |
Что делаем |
| 1. Аудит |
2–3 недели |
Интервью, анализ процессов, архитектура, план интеграций |
| 2. Настройка и кастомизация |
3–6 недель |
Структура, роли, БП, брендирование (CSS шаблон) |
| 3. Интеграции |
2–4 недели |
1С, AD, почта, телефония, ЭДО |
| 4. Миграция данных |
1–2 недели |
Документы, справочники, сотрудники из текущих систем |
| 5. Обучение и пилот |
1–2 недели |
Администраторы, ключевые пользователи, пилот 20–30 чел. |
| 6. Масштабирование |
2–4 недели |
Подключение подразделений, донастройка по обратной связи |
-
Аудит — фиксируем текущие процессы, замеряем потери времени.
-
Проектирование — выбираем тип портала, планируем интеграции.
-
Реализация — настраиваем бизнес-процессы, права, интерфейс.
-
Тест — пилотная группа проверяет сценарии, мы исправляем недочеты.
-
Запуск — подключаем всех сотрудников, обучаем, передаем документацию.
В результате вы получаете: проектную документацию, настроенный портал с интеграциями, описание бизнес-процессов, инструкции для администраторов и пользователей, 30 дней технической поддержки после запуска.
Поддержка после запуска: как не дать порталу умереть
Через полгода многие порталы становятся заброшенными. Чтобы этого избежать, предлагаем пакеты с фиксированным SLA и выделенным администратором. Мониторинг производительности, обновления платформы, администрирование пользователей, доработка новых модулей. Опыт нашей команды — более 50 внедрений корпоративных порталов на Битрикс24. Мы являемся сертифицированным партнером 1С-Битрикс, гарантируем качество и сроки.
Мобильный доступ. Нативное приложение Битрикс24 (iOS/Android) с push-уведомлениями, задачами, чатами. Адаптивный веб-интерфейс для экстранет-пользователей (не надо ставить приложение). Офлайн-доступ к документам и задачам, синхронизация при восстановлении связи.
Закажите внедрение корпоративного портала под ключ
Свяжитесь с нами — оценим ваш проект, предложим архитектуру и сроки. Получите консультацию бесплатно и убедитесь, что портал окупается в первые полгода.