Перейти к основному содержимому

Диагностика push-уведомлений

Обновлено: 2 сентября 2026

Если при работе Push-канала возникают ошибки, перед обращением в службу поддержки edna подготовьте информацию, приведённую ниже.

Общая информация для предоставления​

  • App Package или APNS Topic приложения;
  • операционная система и версия устройства;
  • версия библиотеки edna SDK;
  • информация о новой интеграции или переходе с предыдущей версии;
  • используемая среда (тестовая или промышленная);
  • частота возникновения проблемы;
  • количество затронутых устройств;
  • возможность воспроизведения проблемы на тестовом устройстве;
  • возможность собрать логи с устройства;
  • состояние приложения при получении уведомления (открыто, свернуто или выгружено);
  • тип push-уведомления (длинное или короткое);
  • идентификатор сообщения из OUT_MESSAGES_TAB.

Для Android-приложений​

Для диагностики приложите:

  • AndroidManifest.xml;
  • код интеграции SDK edna;
  • файлы build.gradle проекта и приложения;
  • файл конфигурации ProGuard (если используется).

По возможности также укажите:

  • используется ли стандартная или кастомная отрисовка уведомлений;
  • используются ли кастомные worker-компоненты;
  • результат выполнения worker при регистрации устройства;
  • статус получения push-токена (получен, не получен или получен без адреса).

Для iOS-приложений​

Для диагностики приложите:

  • код интеграции SDK из AppDelegate и NotificationService;
  • скриншоты вкладки Signing & Capabilities для основного приложения и расширения;
  • файлы Info.plist для приложения и расширения.

Что приложить к обращению​

Для ускорения диагностики приложите:

  • логи с отметкой времени (timestamp), соответствующей моменту возникновения ошибки;
  • пример payload проблемного push-уведомления;
  • идентификатор сообщения (messageId), если он известен;
  • любую дополнительную информацию, которая поможет воспроизвести проблему.

Справочник ошибок​


Ошибки APNS (Apple Push Notification service)​

ОшибкаОписание
apns-error: application-removed (Unregistered)Приложение удалено с устройства
apns-error: pns-access-error (connect timed out)Ошибка облачного сервиса
apns-error: pns-access-error (DeviceTokenNotForTopic)Неверная настройка приложения
apns-error: pns-access-error (timeout)Ошибка облачного сервиса
apns-error: expired-before-pushingСрок действия сообщения истек перед отправкой
apns-error: pns-access-error (BadDeviceToken)Отправка в неверное облако
apns-error: pns-access-error (SSL peer shut down incorrectly)Проблема с валидным сертификатом
apns-error: pns-access-error (Connection reset)Ошибка облачного сервиса
apns-error: pns-access-error (certificate_expired)Истек срок действия сертификата
apns-error: pns-access-error (certificate_revoked)Сертификат отозван

Ошибки FCM (Firebase Cloud Messaging)​

ОшибкаОписание
gcm-error: application-removed (device-unregistered)Приложение удалено с устройства
gcm-error: bad-registrationНеверный адрес устройства в облаке
gcm-error: invalid-jsonОшибка облачного сервиса
gcm-error: No sender for [acnId:**;devUid:****] foundНеверная настройка приложения
gcm-error: pns-access-error (Forbidden character)Запрещённый символ
gcm-error: sender-id-mismatchНеверная настройка приложения

Ошибки Huawei Push Kit​

ОшибкаОписание
hcm-error: application-removed (All the tokens are invalid)Приложение удалено с устройства
hcm-error: expired-before-pushingСрок действия сообщения истёк перед отправкой
hcm-error: pns-access-error (invalid client_secret)Неверная настройка приложения

Ошибки RuStore Push​

ОшибкаОписание
rcm-error: pns-access-error (INVALID_ARGUMENT)Невалидный push-токен
rcm-error: pns-access-error (NOT_FOUND)Токен просрочен или использован ID другого проекта
gcm-error: No sender for [acnId:**;devUid:****] foundНеверная настройка приложения

Ошибки Web API​

ОшибкаОписание
webapi-error: pns-access-error (no protocol: null)Неверный адрес endpoint=null
webapi-error: application-removed (404: )Неверный endPoint
webapi-error: pns-access-error (Invalid point encoding 0x-39)Неверные данные в разделе keys
webapi-error: pns-access-error (Unrecognized token 'j'...)Неверный pnsPushAddress