Публікація додатку в маркетплейсі Бітрікс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 днів, якщо зміни не торкаються запрошених скоупів та не змінюють монетизаційну модель.