Сборка и деплой кастомных приложений Битрикс24

Что такое кастомные приложения для Битрикс24

Кастомное приложение — это веб-приложение, расширяющее функциональность Битрикс24. Виды:

• Локальное приложение — для одного портала. Устанавливается админом портала.
• Тиражируемое приложение — продаётся через Маркетплейс Битрикс24, устанавливается на разные порталы.
• Виджеты, поля, активити, обработчики — отдельные элементы (часть приложения или независимые).

Все они размещаются на отдельном сервере (не на Битрикс) и общаются с порталом через REST API и встраивание через iframe.

Стек разработки

Битрикс не диктует. Чаще всего:

• PHP — официальный CRest SDK от Битрикс24, много примеров
• Python — flask, django, b24sdk
• Node.js — экспресс, b24-rest-client
• Frontend — vanilla JS, React, Vue (что угодно)

Главное — JS API Битрикс (BX24) для встраивания в портал.

Структура простого приложения

my-app/
├── index.html         # главная (или install.php)
├── handler.html       # обработчик встраивания
├── install.php        # установка приложения
├── config.php         # конфиг (токены)
├── settings/          # API-методы для настроек
├── public/            # статика
└── README.md

Окружения

Минимум 2 окружения:

• dev — для разработки и тестов. Привязан к dev-порталу.
• prod — рабочее, привязан к продакшен-порталу.

Иногда — staging между ними.

Деплой через Git + скрипт

Базовый workflow:

1. Код в Git (например, Bitbucket/GitHub/GitLab)
2. На сервере — клон репозитория
3. Скрипт деплоя: pull, restart, миграции
4. Триггер деплоя — git push, ручной или CI/CD

Для PHP-приложений на shared-хостинге типа Timeweb — SCP или SFTP файлов.

Деплой через Docker (для VPS)

Для приложений на Python/Node — часто Docker:

1. Dockerfile в репозитории
2. Образ собирается в CI
3. На сервере — docker pull, docker compose up
4. Nginx как reverse proxy (HTTPS, маршрутизация)

Конфигурация и секреты

НЕ хранить в коде:

• Токены вебхуков
• Пароли БД
• Ключи API сторонних сервисов

Хранить в:

• .env файлах (не в git)
• Системных переменных окружения
• Vault/Secrets Manager (для продвинутых)

Авторизация при установке

Для тиражируемых приложений — OAuth 2.0:

1. Пользователь устанавливает на портал
2. Битрикс присылает код установки
3. Приложение обменивает код на access_token + refresh_token
4. Токены сохраняются в БД (привязка к порталу)
5. Refresh каждые 1 час (срок жизни access_token)

Размещение на Битрикс24 Маркетплейс

1. Зарегистрировать партнёрский аккаунт
2. Подготовить приложение (с install.php, иконкой, описанием)
3. Запросить тестирование Битриксом
4. После тестов — на модерацию
5. После модерации — публикуется в Маркетплейсе

Сроки: 2–6 недель от готовности до публикации.

Логирование и мониторинг

• Логи приложения (что происходит, ошибки)
• Логи запросов API Битрикс
• Метрики (uptime, latency)
• Алерты при сбоях

Без логов — отладка ад. Без мониторинга — узнаёшь о падении от клиента.

Тестирование

• Юнит-тесты на бизнес-логику
• Интеграционные тесты с тестовым порталом Битрикс
• E2E через Selenium/Cypress
• Ручное тестирование основных сценариев

Версионирование

• Семантическое версионирование (1.0.0, 1.1.0)
• CHANGELOG в репозитории
• Backward-compatibility при минорных обновлениях
• Уведомления пользователей о крупных изменениях

Производительность

API Битрикс — 2 запроса в секунду. Для тяжёлых операций:

• Batch-запросы (50 за раз)
• Очереди (Redis, RabbitMQ)
• Кэширование справочников
• Асинхронность

Типичные ошибки разработчиков

• Деплой прямо на prod без тестов — часто падает
• Секреты в коде — попадают в Git
• Нет логов — нечем отлаживать
• Нет мониторинга — узнают о падении от клиента
• Не учитывают лимиты API — приложение упирается в quota
• Нет версий — обновили, у клиентов всё сломалось

Сколько стоит разработка приложения

Простое локальное приложение (1 функция): 50 000–200 000 ₽.

Среднее (несколько функций, интерфейс, интеграция): 200 000–800 000 ₽.

Сложное тиражируемое (для Маркетплейса): от 500 000 ₽.

Поддержка после запуска: 5 000–30 000 ₽/мес в зависимости от сложности.

Рассчитать →   Записаться на разбор →

FAQ

Какой стек выбрать?

Для shared-хостинга — PHP. Для VPS и сложных проектов — Python/Node.

Сколько окупается приложение в Маркетплейсе?

Зависит от ниши и качества. Хорошие — окупаются за 6–18 месяцев.