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