Маркетплейс RetailCRM — витрина готовых интеграций, которые пользователи подключают в пару кликов. Публикация превращает частный модуль в тиражируемый продукт: он становится доступен всем клиентам платформы, а подключение и оплата проходят по единым правилам.
Зачем публиковать модуль
Частный интеграционный модуль решает задачу одного клиента. Публикация в маркетплейсе делает его продуктом: одна кодовая база обслуживает множество аккаунтов, а подключение стандартизировано. Это меняет и разработку, и сопровождение.
- Тиражируемость — один модуль на многих клиентов;
- Готовый канал — витрина и аудитория платформы;
- Стандартное подключение — единый сценарий connect для всех;
- Мультиаккаунтность — обязательная поддержка множества независимых подключений.
Аккаунт разработчика
Публикация начинается с регистрации в программе разработчиков RetailCRM. Аккаунт разработчика даёт доступ к оформлению карточки модуля, тестовым окружениям и настройкам публикации.
- Зарегистрируйтесь как разработчик на платформе;
- Получите доступ к тестовому аккаунту для разработки и проверки;
- Подготовьте описание, логотип и материалы карточки модуля;
- Определите модель подключения и тарификации.
Тестовое окружение критично: на нём отрабатывают сценарий подключения и обмена, прежде чем модуль увидят реальные пользователи. Разработку на боевых аккаунтах не ведут.
Манифест и карточка
Технически публичный модуль описывается тем же манифестом интеграции, что и частный, — через POST /api/v5/integration-modules/{code}/edit. Но к публичному модулю добавляются требования к оформлению и корректности объявленных возможностей.
| Элемент | Назначение |
|---|---|
name, логотип | Карточка в витрине |
baseUrl | Адрес вашего сервиса |
accountUrl | Страница подключения аккаунта |
integrations | Объявленные возможности |
Карточка должна честно описывать функциональность: несоответствие описания и реального поведения — частая причина отклонения на модерации.
Подключение аккаунтов
Для публичного модуля сценарий подключения должен корректно работать для любого клиента без ручной настройки с вашей стороны. Пользователь нажимает "подключить", проходит связывание, и модуль активируется для его аккаунта.
- Пользователь инициирует подключение из витрины;
- Открывается ваша страница
accountUrlс параметрами аккаунта; - Сервис регистрирует подключение и сохраняет выданный API-ключ;
- Модуль активируется вызовом
integration-modules/{code}/edit; - Начинается обмен данными по API v5.
Модерация и требования
Перед публикацией модуль проходит проверку командой RetailCRM. Модерация смотрит и на техническую корректность, и на пользовательский опыт. Типовые требования:
- Работоспособность — заявленные возможности реально функционируют;
- Корректный connect — подключение проходит без ошибок для чистого аккаунта;
- Обработка ошибок — модуль корректно реагирует на сбои и лимиты API;
- Документация — понятная инструкция по подключению и настройке;
- Соответствие карточки — описание совпадает с фактическим поведением.
Замечания модерации устраняют и отправляют модуль на повторную проверку. Чем тщательнее протестирован сценарий подключения заранее, тем быстрее проходит публикация.
Тарификация и поддержка
После релиза начинается жизненный цикл продукта. Модуль может быть бесплатным или платным — модель оплаты определяется на этапе публикации и интегрируется с биллингом платформы. Но публикация — это не финал, а начало сопровождения.
- Совместимость — следить за изменениями API и вовремя адаптировать модуль;
- Поддержка клиентов — реагировать на обращения подключившихся;
- Мониторинг — отслеживать доступность сервиса и ошибки обмена;
- Обновления — выпускать новые версии, не ломая работающие подключения.
Отказоустойчивость становится обязательной: сбой вашего сервиса теперь затрагивает всех клиентов сразу, а не одного.
Итог
Публикация в маркетплейсе превращает модуль в тиражируемый продукт: с аккаунтом разработчика, оформленной карточкой, стандартным подключением, изоляцией аккаунтов и обязательствами по поддержке. Проходит через модерацию только модуль, у которого выверены и техника, и пользовательский сценарий.
Мы разрабатываем и готовим к публикации интеграционные модули: проектируем мультиаккаунтную архитектуру, обеспечиваем изоляцию данных и отказоустойчивость, помогаем пройти модерацию и сопровождаем продукт после релиза. Так интеграция становится надёжным продуктом, а не разовым скриптом.
Частые вопросы
Чем публичный модуль отличается от частного?
Публичный обслуживает множество аккаунтов по стандартному сценарию подключения и проходит модерацию. Частный решает задачу одного клиента и настраивается вручную.
Каким методом описывается публичный модуль?
Тем же, что и частный, — POST /api/v5/integration-modules/{code}/edit. Различие в требованиях к оформлению карточки и обязательной мультиаккаунтности.
Что проверяет модерация?
Работоспособность заявленных возможностей, корректность подключения на чистом аккаунте, обработку ошибок, документацию и соответствие карточки реальному поведению.
Обязательна ли поддержка нескольких аккаунтов?
Да, публичный модуль по определению работает с множеством независимых подключений. Данные и ключи разных клиентов должны быть строго изолированы.
Может ли модуль быть платным?
Да, модель оплаты определяется при публикации и интегрируется с биллингом платформы. Модуль может быть как бесплатным, так и платным.
Что происходит после публикации?
Начинается сопровождение: поддержка клиентов, мониторинг доступности, адаптация к изменениям API и выпуск обновлений без поломки работающих подключений.
Как ускорить прохождение модерации?
Тщательно протестируйте сценарий подключения на чистом тестовом аккаунте и убедитесь, что карточка точно описывает функциональность. Большинство отказов связано именно с этим.
Поможем с настройкой и поддержкой Для разработчиков
Поможем с настройкой, доработкой и поддержкой Для разработчиков.