Публикация приложения в маркетплейсе Битрикс24
Сдать приложение в маркетплейс Битрикс24 — отдельная задача, которая занимает от 2 до 8 недель и нередко ломается о требования модерации. Процесс многоступенчатый: сначала регистрация партнёра, потом оформление карточки, потом техническая проверка, потом ревью редакцией. На каждом этапе можно получить отказ с формулировкой, которую придётся расшифровывать.
Предварительные требования
Прежде чем отправлять заявку, нужно соответствовать нескольким требованиям:
Статус партнёра. Публиковать приложения могут только компании, зарегистрированные в партнёрской программе 1С-Битрикс. Регистрация через partner.1c-bitrix.ru, базовый статус — «Партнёр». Без этого форма публикации в личном кабинете разработчика недоступна.
Приложение должно быть зарегистрировано в кабинете разработчика на bitrix24.ru/apps/. При регистрации указывается client_id, client_secret, список OAuth-скоупов и redirect URI. После регистрации приложению присваивается числовой application_id.
Техническая готовность:
- HTTPS с валидным сертификатом на всех endpoint'ах
- Приложение работает в sandbox-портале без ошибок
- Все заявленные скоупы реально используются (лишние скоупы — причина отказа)
- Обработка ошибок: приложение не падает на тарифах без нужных модулей
- Поддержка русского языка в интерфейсе обязательна
Оформление карточки приложения
Карточка в маркетплейсе — это то, что видит пользователь перед установкой. Требования к контенту:
Обязательные элементы:
- Название (до 60 символов), краткое описание (до 160 символов)
- Полное описание с форматированием — редактор в личном кабинете
- Скриншоты: минимум 3, формат PNG/JPG, размер 1280×800 пикселей
- Иконка: 128×128 пикселей, PNG с прозрачным фоном
- Промо-видео — необязательно, но увеличивает конверсию установок
- Категория приложения (CRM, задачи, коммуникации и т.д.)
Частые причины отказа на этапе оформления:
- Скриншоты с тестовыми данными или placeholder-текстом
- Описание на русском плохого качества или скопированное с другого источника
- Иконка с логотипом Битрикс24 или использование фирменных цветов 1С без разрешения
- Заявленная функциональность не соответствует тому, что делает приложение
Технические требования модерации
Это самая непрозрачная часть процесса. Команда модерации проверяет приложение вручную в тестовом окружении. Проверяется:
Безопасность:
- Приложение не запрашивает данные пользователей, которые не нужны для работы
- Нет передачи
access_tokenв GET-параметрах URL (логируются на прокси) - CSRF-защита на всех формах
- XSS-защита при выводе данных из Битрикс24 в своём интерфейсе
Корректность работы с API:
- Корректная обработка
401 Unauthorized— приложение должно инициировать re-auth, а не падать - Обработка rate limit (
429 Too Many Requests) — retry с экспоненциальным backoff - Приложение не вызывает
event.bindв цикле при каждом открытии iframe — только при установке
UX:
- Приложение должно показывать осмысленное состояние загрузки, а не белый экран
- Ошибки должны отображаться пользователю, а не только в консоли
- На мобильной версии Битрикс24 приложение должно быть хотя бы минимально работоспособно
Процесс публикации: шаги и сроки
| Этап | Действие | Типичный срок |
|---|---|---|
| Регистрация партнёра | Подача заявки, проверка документов | 3–7 дней |
| Регистрация приложения | Заполнение формы, получение client_id | 1–2 дня |
| Подготовка карточки | Скриншоты, описание, иконка | 3–5 дней |
| Техническое тестирование | Самопроверка по чеклисту | 2–5 дней |
| Первичная модерация | Автоматические проверки | 1–3 дня |
| Ревью редакцией | Ручная проверка | 5–14 дней |
| Итерации по замечаниям | Доработка + повторная отправка | 3–10 дней |
| Публикация | Появление в каталоге | 1–2 дня |
Итого реалистичный срок от готового приложения до публикации — 3–6 недель при первой итерации.
Типы публикации и монетизация
В маркетплейсе доступны модели:
- Бесплатное — приложение устанавливается без оплаты. Монетизация внутри приложения через собственный биллинг.
- Платное (разово) — пользователь платит один раз при установке через систему 1С-Битрикс. Комиссия маркетплейса составляет процент от продажи.
- Подписка — ежемесячная/ежегодная оплата через биллинг Битрикс24. Приложение получает уведомления о продлении/отмене через события.
- Freemium — базовая функциональность бесплатна, расширенная — платная. Наиболее популярная модель.
Для подписочной модели приложение должно обрабатывать события onAppPaymentAdd (оплата прошла) и onAppPaymentDelete (подписка отменена/истекла) и соответственно включать/отключать функциональность.
После публикации
Публикация — не конец. Битрикс24 периодически обновляет API и deprecated-методы действительно выключает. Нужно подписаться на changelog разработчика и следить за BITRIX24_PHP_SDK версиями.
Рейтинг приложения в маркетплейсе влияет на его позицию в каталоге. Первые отзывы критичны — стоит проработать онбординг так, чтобы пользователь мог начать использовать приложение за 5 минут без чтения инструкции.
Обновления приложения (новые версии) проходят повторную модерацию, но быстрее — обычно 3–7 дней, если изменения не затрагивают запрашиваемые скоупы и не меняют монетизационную модель.