Кастомизация мобильного приложения Битрикс24

Кастомизация мобильного приложения Битрикс24

Представьте: пятьдесят агентов в поле, каждый открывает CRM на телефоне — и видит двадцать вкладок, из которых реально нужны три. На переключение уходит до тридцати секунд на действие, а за день набегает час простоев. Мы решаем эту проблему с помощью кастомизации мобильного приложения Битрикс24 двумя способами: виджеты (встраиваемые UI-элементы, загружаемые за 200 мс) и веб-приложения на JavaScript SDK (полноценные экраны за 2-3 секунды). Выбор зависит от сценария: для быстрых действий (звонок, смена статуса) — виджеты, для сложных форм (оформление заказа) — веб-приложения. Экономия после внедрения может достигать существенных сумм для команды из 50 сотрудников.

Какие способы кастомизации доступны?

Веб-приложения через JavaScript SDK. Платформа предоставляет BX24.js SDK для встроенных приложений. В мобильном контексте приложение открывается в WebView внутри системы. SDK позволяет читать и писать CRM-данные через REST API, открывать стандартные экраны, получать данные пользователя, вызывать методы crm.deal.list, crm.contact.get, tasks.task.list. Пример обращения к CRM из мобильного приложения:

BX24.callMethod('crm.deal.list', {
    filter: { ASSIGNED_BY_ID: BX24.getAuth().user_id },
    select: ['ID', 'TITLE', 'STAGE_ID', 'UF_CRM_CUSTOM_FIELD'],
}, function(result) {
    if (result.error()) {
        console.error(result.error());
    } else {
        renderDeals(result.data());
    }
});

Веб-приложения размещаются в маркетплейсе или устанавливаются локально (коробочная версия). Технически это HTML/CSS/JS, размещённый на вашем сервере и зарегистрированный в разделе «Настройки → Приложения».

Виджеты в CRM. Виджеты — наиболее востребованный тип кастомизации. Они работают в 3 раза быстрее, чем полноценные веб-приложения, так как не требуют полной перезагрузки. Размещение виджетов:

Виджет регистрируется через placement.bind:

BX24.callMethod('placement.bind', {
    PLACEMENT: 'CRM_DEAL_DETAIL_TAB',
    HANDLER: 'https://your-app.ru/widgets/deal-tab',
    TITLE: 'Дополнительные данные',
    DESCRIPTION: 'История доставок',
});

Как запустить бизнес-процесс из мобильного?

Комбинация: кнопка в виджете → REST-вызов → запуск BP через bizproc.workflow.start. Пользователь нажимает кнопку в карточке сделки, на сервере запускается бизнес-процесс, меняется статус, уходит уведомление. За 2 дня реализуем цепочку: список задач, согласование, отправка документа.

Пошаговая инструкция:

1. Разработайте виджет с кнопкой «Одобрить» и зарегистрируйте его на карточке сделки.
2. В обработчике виджета вызовите BX24.callMethod('bizproc.workflow.start', { ... }) с параметрами шаблона и ID сделки.
3. На сервере бизнес-процесс выполнит 5 шагов: проверка условия, смена статуса сделки на «В работе», отправка уведомления менеджеру, запись в историю, оповещение клиента.
4. После завершения процесса мобильное приложение получит ответ и обновит интерфейс.

White Label: собственное брендирование

Для коробочной платформы доступна White Label — сборка собственного мобильного приложения под брендом компании. Система предоставляет возможность перекомпиляции приложения с кастомным названием, иконкой и сплэш-экраном. Требует лицензии Enterprise и отдельного соглашения с 1С-Битрикс. Мы помогаем подготовить ресурсы: иконки в 5 разрешениях, сплэш-экраны для 3 разрешений, конфигурацию сборки.

Кейс: страховой брокер, кастомный интерфейс агента

Сроки и стоимость

Сроки разработки зависят от сложности: MVP (минимально жизнеспособный продукт) — от 5 дней; типовой проект с веб-приложением и несколькими виджетами — от 10 до 20 дней; комплексная кастомизация с White Label — до 30 дней. Стоимость рассчитывается индивидуально после аудита ваших бизнес-процессов и утверждения технического задания. Окупаемость кастомизации — 3-4 месяца за счёт сокращения времени обработки сделок.

Что входит в работу

В рамках проекта мы предоставляем:

• Техническое задание с описанием архитектуры, прототипы экранов и согласование с вами.
• Исходный код веб-приложений и виджетов, зарегистрированный в вашей системе.
• Документацию по REST-методам и сценариям использования.
• Инструкцию по установке и настройке, включая права доступа.
• Тестирование на реальных устройствах (iOS, Android) и исправление замечаний.
• Поддержку в течение 30 дней после сдачи (консультации, правки по согласованию).

Каждый проект начинается с аудита текущих процессов. Получите консультацию — оценим ваш сценарий за 1 день. Свяжитесь с нами, чтобы обсудить архитектуру и сроки. Закажите кастомизацию мобильного приложения — начните с аудита.

Service Worker на Битриксе — отдельное приключение

Композитный кэш (CPagesCache) отдаёт HTML-страницу из файлового кэша, а Service Worker поверх него кэширует ресурсы через Cache API. Два слоя кэширования, которые ничего не знают друг о друге. Если не развести их стратегии — пользователь видит устаревшую корзину после добавления товара. Мы начинаем любой PWA-проект на Битриксе с настройки правильного разделения: Service Worker берёт статику (CSS, JS, шрифты) через Cache First, а HTML и API-ответы всегда идут Network First с fallback на кэш. Композитный кэш Битрикса при этом работает на серверной стороне и не пересекается с клиентским.

Типы мобильных приложений для Битрикс

PWA (Progressive Web App) — веб-приложение, которое выглядит как нативное, но живёт в браузере. Установка из стора не нужна — добавление на домашний экран.

React Native — кроссплатформа от Meta. JavaScript, один код — нативное приложение для iOS и Android с полным доступом к API устройства.

Flutter — кроссплатформа от Google на Dart. Собственный движок рендеринга Skia, стабильные 60/120 FPS.

Мобильное приложение Битрикс24 — готовое корпоративное решение: CRM, задачи, чат, видеозвонки.

PWA обгоняет нативную разработку по скорости запуска в 3 раза, а React Native на 40% дешевле Flutter по трудозатратам для типового интернет-магазина.

Как реализовать PWA на Битриксе без конфликта кэшей?

manifest.json — иконка, название, display: standalone, theme_color, start_url. Пользователь устанавливает сайт на домашний экран. Файл кладём в корень и подключаем через <link rel="manifest"> в header.php шаблона.

Service Worker — ядро PWA. Регистрируем в footer.php:

• Cache First для статики: /bitrix/cache/, CSS, JS, шрифты, изображения товаров
• Network First для HTML и API (/ajax/, /bitrix/services/). Если сеть недоступна — отдаём кэш.
• Stale While Revalidate для каталога — показываем кэшированное, обновляем в фоне
• Отдельная логика для корзины: всегда Network Only, иначе пользователь видит фантомные товары

Ключевой нюанс — конфликт с композитом Битрикс. Модуль composite кэширует HTML на сервере и отдаёт статические файлы. Service Worker не должен перехватывать эти ответы для авторизованных пользователей — иначе разлогиненный пользователь увидит корзину предыдущего. Решаем через проверку cookie BX_USER_ID в fetch-обработчике.

Push-уведомления — Firebase Cloud Messaging или OneSignal. Статус заказа (OnSaleStatusOrder → trigger push), акции, поступление товара. Токен устройства сохраняем в UF-поле пользователя.

Офлайн-каталог — ранее просмотренные товары доступны без интернета. IndexedDB для карточек, Cache API для изображений.

Совместимость с Проактивной защитой — модуль security проверяет Referer и сессионные токены. Service Worker при prefetch может не передать нужные заголовки — настраиваем исключения в BX_SECURITY_SESSION_VIRTUAL.

Прирост производительности мобильного сайта после внедрения PWA составляет 60-80% по Time to Interactive, а конверсия с мобильных устройств растёт на 25-35%.

React Native для интернет-магазинов на Битрикс

Когда PWA мало — React Native даёт полноценное нативное приложение с единой кодовой базой.

Архитектура:

• Бекенд: Битрикс отдаёт данные через REST API. Стандартные методы catalog.product.list, sale.order.add для каталога и заказов. Для кастомных сущностей — свои контроллеры через \Bitrix\Main\Engine\Controller.
• Промежуточный слой: BFF (Backend for Frontend) на Node.js или GraphQL. Агрегируем 3-5 запросов к Битрикс API в один ответ для мобильного клиента — мобильный интернет не прощает лишних round-trip.
• Фронтенд: React Native приложение.

Функционал интернет-магазина:

• Каталог: поиск, фильтры, сортировка — данные из CIBlockElement::GetList через REST
• Карточка товара: галерея (react-native-fast-image), описание, характеристики, отзывы
• Корзина и чекаут с persistence через AsyncStorage
• Личный кабинет: заказы, избранное, профиль, адреса
• Push: статус заказа, акции, брошенная корзина — FCM/APNs, триггеры на событиях Битрикс
• Нативные фичи: сканер штрихкодов (react-native-camera), геолокация для ПВЗ, Face ID / Touch ID (react-native-biometrics)
• Офлайн: каталог и избранное через AsyncStorage / WatermelonDB
• Deep linking: react-navigation deep link → конкретный товар из push или рекламы

React Native выбирают, потому что:

• React-разработчики уже знают 80% стека
• Экосистема: тысячи готовых пакетов в npm
• Hot Reload — моментальный feedback при разработке
• CodePush от Microsoft — обновление JS-бандла без публикации в Store. Фикс бага за минуты, а не за 2-3 дня ревью.

Flutter vs React Native: когда выбрать Flutter

Альтернатива React Native. Выбираем, когда нужен нестандартный UI с тяжёлыми анимациями.

Сильные стороны:

• Skia engine — 60/120 FPS на сложных анимациях, где React Native начинает подлагивать на bridge
• Пиксельная идентичность на iOS и Android — свой рендеринг, не платформенные виджеты
• Dart: строго типизированный, ошибки на этапе компиляции, а не в проде на устройстве пользователя
• Material Design и Cupertino виджеты из коробки

Когда Flutter:

• Интерфейс со сложными анимациями и кастомными переходами между экранами
• Критически важна одинаковость UI на обеих платформах
• Планы на web и desktop (Flutter поддерживает все три таргета)
• Команда знает Dart или готова вложиться

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

• REST API на стороне Битрикс (аналогично React Native)
• Пакет dio для HTTP с interceptors: автоматическое добавление auth-токена, retry на 5xx
• Состояние: Riverpod или BLoC — зависит от масштаба
• Локальное хранение: Hive для key-value, sqflite для сложных запросов к офлайн-данным

Для нестандартного интерфейса Flutter даёт идентичное поведение на обеих платформах — экономия до 30% времени на кросс-платформенных багах.

Как подготовить API для мобильного приложения на Битриксе?

Мобильное приложение ровно настолько хорошо, насколько хорош API.

Проектирование:

• RESTful с версионированием (/api/v1/, /api/v2/) — обратная совместимость при обновлениях
• JWT + refresh token. Access — 15 минут, refresh — 30 дней. Хранение refresh в Keychain (iOS) / EncryptedSharedPreferences (Android).
• Пагинация курсором (?after=eyJ...) — стабильная подгрузка без дублей при добавлении новых элементов
• Sparse fieldsets: ?fields=id,name,price,image — отдаём только нужное экрану, экономим трафик

Оптимизация под мобильные сети:

• Агрегированные эндпоинты: один запрос на экран вместо пяти. /api/v1/home возвращает баннеры, рекомендации, акции и категории одним ответом
• Gzip-сжатие — в Битрикс включается через \Bitrix\Main\Config\Option::set('main', 'use_compression', 'Y')
• ETag / Last-Modified — 304 Not Modified экономит трафик и время
• Retry с exponential backoff + offline queue (запросы копятся и отправляются при восстановлении сети)
• Изображения по размеру устройства: CFile::ResizeImageGet() с параметрами из заголовка DPR

Push-уведомления:

• FCM (Android) + APNs (iOS)
• Триггеры на событиях Битрикс: OnSaleStatusOrder, OnCatalogStoreProductUpdate, OnSaleBasketSaved
• Сегментация: персонализация по поведению из CRM
• Аналитика воронки: доставка → открытие → переход → конверсия

Что входит в разработку мобильного приложения под ключ?

1. Аналитика — аудит текущего сайта, нагрузочное тестирование, профилирование узких мест (SQL-запросы, кэширование). Сбор требований по фичам.
2. Проектирование API — проектирование REST/GraphQL-схемы с курсорной пагинацией и sparse fieldsets, интеграция с 1С через CommerceML, фискализация (54-ФЗ, АТОЛ, ОФД).
3. Реализация PWA — настройка Service Worker, manifest, push-уведомления, офлайн-каталог, тестирование на реальных устройствах.
4. Разработка нативного приложения — React Native или Flutter: верстка экранов, интеграция с API, камера, геолокация, deep linking.
5. Интеграция с Битрикс24 — REST OAuth, webhooks, Open Lines, Bizproc, синхронизация с CRM.
6. Тестирование — нагрузочное (k6), регрессионное, кроссплатформенное на iOS/Android, проверка офлайн-сценариев.
7. Деплой — публикация в App Store / Google Play, настройка CI/CD, мониторинг (Sentry, Firebase Crashlytics).
8. Документация — описание API, архитектуры, инструкция по обновлению. Передача доступов и исходных кодов.

Результат: работающее приложение, документация, доступы к серверам и сторам, обучение команды заказчика.

Сроки

Рекомендуем стартовать с PWA — проверить гипотезу за 2-3 недели. Если мобильный трафик подтверждает спрос — наращивать нативное приложение с полным доступом к устройству.

Наша команда — сертифицированные разработчики 1С-Битрикс с опытом более 7 лет. За это время реализовали 20+ мобильных проектов — от PWA для сетевых магазинов до нативных приложений для дистрибьюторов с интеграцией СДЭК и 1С. Гарантируем совместимость с актуальными версиями платформы и модулей. Progressive Web Apps, React Native, Flutter.

Закажите предварительную оценку: пришлём архитектурный план и сроки за 2 рабочих дня. Получите консультацию разработчика по выбору технологии — заполните форму на сайте или позвоните нам.