Конструктор встроек

Конструктор встроек помогает встроить внешний сайт или веб-приложение прямо в интерфейс Битрикс24: в карточки CRM, воронки, левое меню, страницы, чаты и другие доступные места портала

Приложение подходит, когда сотруднику нужна подсказка, форма, каталог, отчет или внутренний сервис в контексте рабочей карточки. Внешний ресурс открывается внутри Битрикс24, поэтому пользователю не приходится переключаться между вкладками

Кому подходит приложение

• Администраторам портала и интеграторам, которые подключают внешние сервисы к рабочим сценариям

• Командам, которые развивают собственный веб-сервис и хотят открывать его в контексте CRM или коммуникаций

• Разработчикам REST-приложений, которым нужно проверять разные места встраивания и параметры вызова

• Компаниям, где инструкции, формы, каталоги или внутренние панели должны быть доступны прямо из Битрикс24

Сценарии использования

• Встроить инструкцию, чек-лист или базу знаний в карточку лида, сделки, контакта, компании или смарт-процесса

• Открыть CRM-форму, каталог товаров или внутренний сервис в рабочем окне менеджера

• Добавить виртуального помощника, FAQ или внешний раздел в меню списков и аналитики CRM

• Подключить контекстное действие к чатам и IM-интерфейсу

• Вывести быструю ссылку или внешний раздел в левое меню портала

• Встроить внешний сервис в BI-аналитику, реквизиты, банковские реквизиты или фоновые процессы

Как это работает

Администратор выбирает сущность или раздел Битрикс24, куда нужно добавить встройку, и указывает конкретное место встраивания - placement

Затем задаются название встройки и URL обработчика. Это адрес внешней страницы или сервиса, который будет открываться внутри портала

При открытии встройки Битрикс24 передает обработчику служебные параметры: домен портала, язык, идентификаторы приложения, данные авторизации, placement и placement_options. По ним внешний сервис понимает, кто открыл встройку, из какого места портала она вызвана и с каким элементом связана

Все созданные встройки отображаются в общем списке. Там видно место встраивания, название, URL обработчика и доступные действия для проверки и поддержки настроек

Доступные категории

• Карточки CRM: лид, сделка, контакт, компания, старый счет, счет, предложение, заказ, смарт-процесс

• Сопутствующие разделы CRM: активность, аналитика, воронки, реквизиты, банковские реквизиты

• Пользователь, чаты и сообщения

• IM-сайдбар, IM-навигация, IM-текстовое поле, IM-смайлы, IM-контекстное меню

• Левое меню, страницы, BI-аналитика, REST-приложение, фоновый процесс

• CRM-поиск и CRM-автозаполнение

Что получает обработчик

• DOMAIN - домен портала

• PROTOCOL и LANG - параметры подключения и язык интерфейса

• APP_SID - идентификатор текущей сессии приложения

• AUTH_ID, AUTH_EXPIRES и REFRESH_ID - данные авторизации для работы с REST

• member_id и status - идентификатор портала и его статус

• PLACEMENT и PLACEMENT_OPTIONS - место встройки и параметры контекста, например ID элемента CRM

Фильтры

• Сущность или раздел, где будет отображаться встройка

• Место встраивания placement

• Название встройки

• URL обработчика

• Цветовая схема из готовой палитры

• Радиус скругления элементов

• Размер шрифта

• Светлая и темная темы

Доступы и безопасность

Обработчик получает параметры авторизации и контекст вызова через placement и placement_options. Эти данные нужно обрабатывать на стороне внешнего сервиса безопасно, использовать HTTPS для URL обработчика и учитывать права пользователя в Битрикс24 при формировании ответа

Ограничения

• Встройка отображает внешний ресурс, поэтому его доступность и скорость ответа влияют на работу пользователей

• Для некоторых мест встраивания нужно корректно разбирать placement_options

• Если внешний сервис не обрабатывает ошибки или авторизацию, сотрудник может увидеть пустой экран вместо полезного интерфейса

На что обратить внимание

1. Перед запуском на рабочем портале проверьте обработчик в тестовом сценарии

2. Убедитесь, что внешний сервис корректно принимает параметры вызова и обновляет авторизацию при необходимости

3. Если встройка зависит от ID элемента CRM или прав пользователя, проверьте поведение на разных ролях и сущностях

4. Для рабочих подсказок и форм лучше заранее определить, где встройка действительно нужна, чтобы не перегружать интерфейс портала

Телеграм-канал для интеграторов,      администраторов и руководителей Кейсы и статьи от интеграторов и разработчиков, об использовании Битрикс24 и автоматизации; Новые приложения Bambit, обновления и доработки приложений; Личный опыт руководителя Bambit.

Полезные приложения для администраторов и интеграторов:

Получайте отчеты автоматически (раз в день/неделю/месяц):


Полезные приложения для работы с задачами:


Полезные отчеты для руководителей и сотрудников:

Полезные приложения для маркетологов:


Real-time отчеты:


Для B2B-компаний: