Настройка Битрикс24 Маркет

Настройка Битрикс24 Маркет

Битрикс24 Маркет — это каталог приложений и интеграций, доступный из любого портала через меню «Приложения». Если ваш отдел подключает телефонию, почту или корпоративный мессенджер через Маркет, настройка занимает от 5 минут. Если же нужно опубликовать своё приложение или управлять установленными — там есть нюансы.

Установка приложений из Маркета

Путь: Приложения → Маркет. Приложения разбиты по категориям: CRM, Телефония, Задачи, Интеграции с сервисами и т.д.

При установке приложения из Маркета происходит:

1. OAuth-авторизация: приложение запрашивает права на нужные скоупы
2. Пользователь подтверждает права
3. Приложение регистрирует свои плейсменты, обработчики событий, пункты меню

После установки приложение появляется в Приложения → Мои приложения. Управление — только оттуда.

Управление установленными приложениями

Список установленных приложений с правами и статусом:

/devops/section/api/apps/

Там же видно: какие скоупы запросило приложение, какие вебхуки зарегистрировало, дату последней активности. Это полезно при аудите безопасности — иногда обнаруживаются забытые тестовые приложения с правами администратора.

Удаление приложения через REST:

POST /rest/app.uninstall
{
  "clear": 1
}

Параметр clear=1 удаляет все данные приложения с портала (настройки, опции, плейсменты). Без него приложение деавторизуется, но данные остаются — удобно для переустановки без потери конфигурации.

Настройка приложений после установки

Многие приложения из Маркета требуют конфигурации после установки: указать API-ключи сторонних сервисов, настроить маппинг полей, выбрать ответственных. Конфигурационный интерфейс открывается из карточки приложения.

Если приложение использует app.option.set/app.option.get для хранения настроек:

POST /rest/app.option.set
{
  "options": {
    "api_key": "your-service-api-key",
    "sync_interval": "60",
    "deal_stage_mapping": "{\"WON\":\"DELIVERED\"}"
  }
}

Настройки хранятся в таблице b_app_option на портале, привязаны к member_id приложения.

Обновление прав установленного приложения

Если разработчик приложения добавил новый скоуп, администратору портала придёт уведомление с предложением обновить права. Принудительно проверить наличие обновлений:

Приложения → Мои приложения → [приложение] → Проверить обновления

При обновлении прав пользователь снова проходит OAuth-подтверждение. Автоматического обновления без участия пользователя нет — это ограничение безопасности платформы.

Публикация своего приложения в Маркет

Требования для публикации:

• Регистрация партнёра на partners.1c-bitrix.ru
• HTTPS для всех endpoint'ов приложения
• Корректный manifest с описанием, скриншотами и иконкой
• Прохождение технического ревью командой Bitrix

Типичные причины отказа при ревью:

• Handler URL недоступен или возвращает ошибку
• Приложение запрашивает лишние скоупы (просит disk и calendar, а использует только crm)
• Отсутствует описание на русском языке
• Нет корректной обработки деинсталляции (OnAppUninstall)

Сроки ревью: от 3 до 14 рабочих дней в зависимости от загрузки команды Bitrix и сложности приложения.