Мы регулярно сталкиваемся с ситуацией, когда после внедрения Битрикс24 мобильные push-уведомления не работают. Клиенты получают жалобы от сотрудников: не приходят сообщения из чата, пропускают задачи, уведомления о лидах приходят с опозданием. Чаще всего проблема кроется в некорректной настройке ключей Firebase Cloud Messaging (FCM) для Android или сертификатов Apple Push Notification Service (APNs) для iOS. Мы берём такую настройку под ключ и устраняем сбои за 1–2 дня.
Как устроена доставка 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 — это надёжнее и не требует обновления ключа в будущем.
Сертификаты 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 не приходят только на 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-уведомления на более чем 200 порталах Битрикс24 за 5 лет работы. Неработающие уведомления могут стоить бизнесу до 5% выручки из-за пропущенных лидов и задержек в коммуникации. Настройка push-уведомлений окупается в течение недели за счёт ускорения реакции сотрудников. Своевременная диагностика предотвращает финансовые потери от упущенных лидов.
Свяжитесь с нами для бесплатного аудита текущей push-конфигурации. Мы оценим проект и предложим оптимальное решение. Закажите настройку push-уведомлений и убедитесь в их стабильной работе. Получите консультацию — напишите в Telegram или на почту.