Техническая поддержка приложения в маркетплейсе Битрикс24
После публикации приложения в маркетплейсе начинается операционная жизнь: обращения пользователей, инциденты из-за изменений API Битрикс24, истечение токенов, конфликты с обновлениями порталов. Без выстроенной поддержки рейтинг приложения начнёт падать за счёт негативных отзывов.
Что ломается в опубликованных приложениях
Протухшие токены. refresh_token живёт 180 дней. Если пользователь не открывал приложение полгода — токен истёк, повторная авторизация невозможна без ручного вмешательства (переустановка или принудительный re-auth). Нужен мониторинг токенов по expires_at и проактивное уведомление.
Изменения REST API Битрикс24. 1С-Битрикс периодически устаревает методы: deprecated-предупреждение в документации появляется за несколько месяцев, но отключение бывает резким. Подписка на changelog dev.bitrix24.ru — обязательна.
Недоступность placements. Если Битрикс24 меняет структуру интерфейса, placement-точки могут переместиться или изменить контекст. Пользователи видят пустую вкладку или ошибку.
Ошибки у конкретных порталов. Нестандартная конфигурация портала, кастомные права пользователей, нестандартные статусы CRM — всё это вызывает ошибки только у части пользователей. Без нормального логирования с привязкой к member_id диагностика занимает часы.
Организация поддержки
Минимальный набор для поддержки опубликованного приложения:
-
Мониторинг ошибок — Sentry или аналог с группировкой по
member_idи типу ошибки. Алерт при превышении порога ошибок за 15 минут -
Логирование API-вызовов — все вызовы к Битрикс24 REST с кодом ответа, время выполнения,
member_id - Очередь неудачных задач — задачи со статусом error отображаются в дашборде поддержки с возможностью повторного запуска
- Канал обращений — email, форма на сайте или чат, с SLA: реакция до 24 часов, решение критических инцидентов до 4 часов
Поддержка работает лучше, если каждое обращение пользователя содержит member_id портала — это связывает тикет с конкретными логами и токенами.
Плановые работы
Помимо реактивной поддержки — регулярные профилактические задачи:
- Еженедельная проверка changelog Битрикс24 REST API
- Ежемесячная проверка истекающих токенов (за 30 дней до
expires_at) - Мониторинг рейтинга и новых отзывов в маркетплейсе — реагировать публично в течение 48 часов
Срок реакции на критический инцидент (приложение не открывается у всех пользователей): до 2 часов в рабочее время.