Налаштування push-сповіщень мобільного застосунку Бітрікс24
Push-сповіщення в мобільному застосунку Бітрікс24 працюють через два канали: Firebase Cloud Messaging (Android) та Apple Push Notification Service (iOS). Без коректного налаштування ключів і сертифікатів застосунок мовчки «ковтатиме» сповіщення — користувачі не отримають ні повідомлень із чату, ні нагадувань щодо завдань.
Як влаштована доставка push-сповіщень
Бітрікс24 використовує модуль mobile і сервіс push.bitrix24.com як проміжний брокер. Сервер Бітрікс24 надсилає подію на push.bitrix24.com, той формує запит до FCM або APNs, і лише після цього сповіщення потрапляє на пристрій. Це важливо: якщо ваш Бітрікс24 встановлений on-premise і закритий файрволом, брокер повинен мати доступ до вашого сервера через API.
Для коробкового Бітрікс24 ланцюжок виглядає так:
- Подія на порталі (нове повідомлення, завдання, лід) → тригер у модулі
mobile - Запит до
https://push.bitrix24.com/pub/з токеном пристрою та payload - Брокер → FCM/APNs → пристрій користувача
Токени пристроїв зберігаються в таблиці b_mobile_device. При перевстановленні застосунку токен змінюється; старий позначається як невалідний після першої неуспішної відповіді від FCM/APNs.
Налаштування для on-premise: ключі Firebase і сертифікати Apple
Android/FCM. У консолі Firebase-проєкту потрібно отримати Server Key (Legacy API) або налаштувати сервісний акаунт для FCM v1. Бітрікс24 до версії 22.x працює з Legacy API — ключ вигляду AAAAxxxxxxx:APA91b.... Починаючи з нових версій модуля mobile підтримується FCM HTTP v1 API через OAuth2-токен сервісного акаунта.
Ключ вносять у налаштуваннях: Налаштування → Мобільний застосунок → Push-сповіщення → Android. Після збереження система одразу перевіряє ключ тестовим запитом до FCM.
iOS/APNs. Apple використовує два механізми автентифікації: сертифікати .p12 і ключі .p8 (токен-автентифікація). Сертифікати закінчуються через рік — це типова причина раптової зупинки push на iOS. Ключі .p8 не мають терміну дії, тому рекомендуємо саме їх.
Для генерації ключа .p8: Apple Developer Console → Certificates, Identifiers & Profiles → Keys → створити ключ із прапорцем Apple Push Notifications service (APNs). Завантажити його можна лише один раз.
Типові збої та їх діагностика
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.
Етапи налаштування та орієнтовні строки
| Задача | Трудомісткість |
|---|---|
| Налаштування FCM Legacy/v1 для Android | 1–2 години |
| Налаштування APNs (.p8) для iOS | 1–2 години |
| Діагностика наявної конфігурації | 2–4 години |
| Налаштування push для кастомного мобільного застосунку на базі Бітрікс24 | 1–3 дні |
Вартість розраховується індивідуально після аудиту поточної конфігурації порталу та версії модуля mobile, що використовується.