Настройка 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. При переустановке приложения токен меняется, старый помечается как невалидный после первого failed-ответа от 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.