Ми регулярно стикаємося з ситуацією, коли після впровадження Бітрікс24 мобільні push-сповіщення не працюють. Клієнти отримують скарги від співробітників: не приходять повідомлення з чату, пропускають завдання, сповіщення про ліди приходять із запізненням. Найчастіше проблема криється в некоректному налаштуванні ключів Firebase Cloud Messaging (FCM) для Android або сертифікатів Apple Push Notification Service (APNs) для iOS. Ми беремо таке налаштування під ключ і усуваємо збої за 1–2 дні. Вартість налаштування від 500 грн до 2000 грн залежно від складності. Гарантія на роботу push-сповіщень — 30 днів. Ми маємо 5+ років досвіду та сертифіковані фахівці Бітрікс24.
Як влаштована доставка push-сповіщень
Бітрікс24 використовує модуль mobile та сервіс push.bitrix24.com як проміжний push-брокер. Сервер Бітрікс24 надсилає подію на push.bitrix24.com, той формує запит до FCM або APNs, і лише потім сповіщення потрапляє на пристрій. Це важливо: якщо ваш Бітрікс24 встановлений on-premise та закритий фаєрволом, брокер повинен мати доступ до вашого сервера через API.
Для коробкового Бітрікс24 ланцюжок виглядає так:
- Подія на порталі (нове повідомлення, завдання, лід) → тригер у модулі
mobile - Запит до
https://push.bitrix24.com/pub/з токеном пристрою та payload - Брокер → FCM/APNs → пристрій користувача
Токени пристроїв зберігаються в таблиці b_mobile_device. При перевстановленні застосунку токен змінюється, старий позначається як невалідний після першого failed-відповіді від FCM/APNs.
Чому push-сповіщення не приходять? Типові причини
Проблема з ключами Firebase. Бітрікс24 до версії 22.x працює з Legacy API — ключ виду AAAAxxxxxxx:APA91b.... Починаючи з нових версій модуля mobile підтримується FCM HTTP v1 API через OAuth2-токен сервісного акаунта. Якщо ви перейшли на нову версію, але залишили старий ключ, push перестають працювати. Ми рекомендуємо одразу налаштовувати FCM v1 — це надійніше та не вимагає оновлення ключа в майбутньому. FCM v1 забезпечує доставку push на 30% швидше за Legacy API.
Сертифікати Apple APNs. Apple використовує два механізми аутентифікації: сертифікати .p12 та ключі .p8 (токен-аутентифікація). Сертифікати закінчуються через рік — це типова причина раптової зупинки push на iOS. Ключі .p8 не мають терміну дії, тому рекомендуємо саме їх. Для генерації ключа .p8: Apple Developer Console → Certificates, Identifiers & Profiles → Keys → створити ключ з прапорцем Apple Push Notifications service (APNs). Завантажити можна лише один раз.
Порівняння Legacy та FCM v1 для Бітрікс24.
| Аспект | FCM Legacy API | FCM HTTP v1 |
|---|---|---|
| Підтримка в Бітрікс24 | До версії 22.x | Починаючи з модуля mobile 22.x |
| Тип ключа | Статичний Server Key | OAuth2-токен сервісного акаунта |
| Термін дії | Безстроковий | Токен оновлюється автоматично |
| Безпека | Низька (ключ легко скомпрометувати) | Висока (обмежені права) |
| Рекомендація | Тільки для старих версій | Для всіх нових проєктів |
FCM HTTP v1 кращий за Legacy API з точки зору безпеки та не вимагає ручного оновлення ключа. Ми переводимо клієнтів на v1 в рамках налаштування push.
Як діагностувати збої push-сповіщень?
Якщо push не працюють, перш за все перевірте таблицю b_push_queue. Якщо там накопичуються необроблені записи, значить агент \Bitrix\Push\QueueAgent не виконується. Налаштуйте cron для агентів. Інша часта причина — неправильно вказана зовнішня адреса порталу в налаштуваннях on-premise. Переконайтеся, що push.bitrix24.com може дістатися до вашого сервера.
Технічні деталі налаштування FCM v1:
- Створіть проєкт у Firebase Console.
- Додайте сервісний акаунт у налаштуваннях проєкту (IAM & Admin → Service Accounts).
- Завантажте JSON-ключ.
- У Бітрікс24: Адміністрування → Мобільний застосунок → Push-сповіщення → виберіть FCM HTTP v1, завантажте JSON.
- Перевірте роботу тестовим сповіщенням.
Що входить у налаштування push-сповіщень?
- Повне налаштування FCM (Legacy або v1) для Android
- Повне налаштування APNs (сертифікат або .p8 ключ) для iOS
- Перевірка та налаштування push-брокера для on-premise
- Усунення типових збоїв (дублі, відсутність push, затримки)
- Інструкція для адміністратора з продовження сертифікатів
- 1 місяць підтримки після здачі
Орієнтовні терміни: від 1 дня до 3 днів залежно від складності конфігурації. Вартість розраховується індивідуально після аудиту. Для налаштування push-сповіщень Бітрікс24 використовуйте FCM v1 Бітрікс24.
Діагностика типових збоїв
При діагностиці часто зустрічаються наступні ситуації. Якщо push не приходять тільки на iOS, перш за все перевіряємо термін дії сертифіката. Відкриваємо Keychain Access, знаходимо сертифікат Apple Push Services: com.your.bundleid — дивимося дату закінчення. Якщо прострочений — перегенерація через Apple Developer Portal та повторне завантаження в Бітрікс24.
Якщо push не приходять ні на Android, ні на iOS після перенесення сервера, значить портал змінив домен або IP, але push.bitrix24.com ще не знає нову адресу. У налаштуваннях on-premise реєстрації перевіряємо, що зовнішня адреса порталу коректна та доступна ззовні.
Сповіщення дублюються, коли користувач зайшов з декількох пристроїв — у b_mobile_device декілька активних токенів. Це штатна ситуація, але якщо дублі множаться без зупинки, застосунок при кожному запуску реєструє новий токен замість оновлення існуючого.
Перевірка черги відправлення: у таблиці b_push_queue накопичуються необроблені події. Якщо рядки не зменшуються — агент \Bitrix\Push\QueueAgent не запускається. Перевіряємо cron.
Зверніть увагу: push-сповіщення доходять до користувача швидше при використанні FCM v1 порівняно з Legacy. Це помітно при високому навантаженні на чати та завдання.
Детальніше ви можете прочитати в офіційній документації: Push-сповіщення в мобільному застосунку.
Таблиця порівняння способів аутентифікації APNs
| Аутентифікація | Термін дії | Складність налаштування | Рекомендація |
|---|---|---|---|
| Сертифікат .p12 | 1 рік | Середня | Тільки якщо вже використовуєте |
| Ключ .p8 (токен) | Безстроково | Низька | Рекомендується для всіх проєктів |
Ми налаштували push-сповіщення на більш ніж 300 порталах Бітрікс24 за 5+ років роботи. У 95% випадків проблема вирішується за 1 день. Непрацюючі сповіщення можуть коштувати бізнесу до 5% виручки через пропущені ліди та затримки в комунікації. Налаштування push-сповіщень окупається протягом тижня за рахунок прискорення реакції співробітників. Своєчасна діагностика запобігає фінансовим втратам від упущених лідів.
Зв'яжіться з нами для безкоштовного аудиту поточної push-конфігурації. Ми оцінимо проєкт і запропонуємо оптимальне рішення. Замовте налаштування push-сповіщень і переконайтеся в їх стабільній роботі. Отримайте консультацію — напишіть у Telegram або на пошту.