Налаштування Bitrix24 Market
Bitrix24 Market — це каталог застосунків та інтеграцій, доступний з будь-якого порталу через меню «Застосунки». Якщо ваш відділ підключає телефонію, пошту або корпоративний месенджер через Market, налаштування займає від 5 хвилин. Якщо ж потрібно опублікувати власний застосунок або керувати встановленими — там є нюанси.
Встановлення застосунків з Market
Шлях: Застосунки → Market. Застосунки розбиті за категоріями: CRM, Телефонія, Завдання, Інтеграції з сервісами тощо.
При встановленні застосунку з Market відбувається:
- OAuth-авторизація: застосунок запитує права на потрібні скоупи
- Користувач підтверджує права
- Застосунок реєструє свої плейсменти, обробники подій, пункти меню
Після встановлення застосунок з'являється в Застосунки → Мої застосунки. Управління — лише звідти.
Управління встановленими застосунками
Список встановлених застосунків з правами та статусом:
/devops/section/api/apps/
Там же видно: які скоупи запросив застосунок, які вебхуки зареєстрував, дату останньої активності. Це корисно при аудиті безпеки — іноді виявляються забуті тестові застосунки з правами адміністратора.
Видалення застосунку через REST:
POST /rest/app.uninstall
{
"clear": 1
}
Параметр clear=1 видаляє всі дані застосунку з порталу (налаштування, опції, плейсменти). Без нього застосунок деавторизується, але дані залишаються — зручно для перевстановлення без втрати конфігурації.
Налаштування застосунків після встановлення
Багато застосунків з Market вимагають конфігурації після встановлення: вказати 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-підтвердження. Автоматичного оновлення без участі користувача немає — це обмеження безпеки платформи.
Публікація власного застосунку в Market
Вимоги для публікації:
- Реєстрація партнера на partners.1c-bitrix.ru
- HTTPS для всіх endpoint'ів застосунку
- Коректний manifest з описом, скриншотами та іконкою
- Проходження технічного ревю командою Bitrix
Типові причини відмови при ревю:
- Handler URL недоступний або повертає помилку
- Застосунок запитує зайві скоупи (просить
diskіcalendar, а використовує лишеcrm) - Відсутній опис російською мовою
- Немає коректної обробки деінсталяції (
OnAppUninstall)
Терміни ревю: від 3 до 14 робочих днів залежно від завантаженості команди Bitrix та складності застосунку.