FAQ: Чому я не отримую push-сповіщення в iOS SDK?

Цей чекліст допоможе вам швидко знайти та виправити проблему
Написано Konstantine
Оновлено 4 тижні тому

Виправлення помилок із push-сповіщеннями в HelpCrunch iOS SDK включає кілька ключових кроків для забезпечення належної конфігурації та функціональності.


1. Перевірка налаштування push-сповіщень

Перевірте документацію для розробників: Переконайтеся, що ви ретельно виконали інструкцію з налаштування HelpCrunch iOS SDK, особливо розділи щодо активації push-сповіщень.

Створіть і завантажте APNs-сертифікат: переконайтеся, що ви правильно створили та завантажили сертифікат Apple Push Notification Service (APNs) у свій обліковий запис HelpCrunch. Неправильно налаштований сертифікат — одна з найпоширеніших причин проблем.

Найбільш поширена проблема з push-сповіщеннями пов’язана із сертифікатом .p12. Переконайтеся, що ви завантажили правильний .p12-файл для режимів розробки/продакшену. Також перевірте цю статтю довідки.

Додатково перевірте:

  • Чи правильно введено пароль до сертифіката.
  • Чи не закінчився термін дії сертифіката.
  • Довідкові матеріали Apple з усунення несправностей.
  • Під час створення .p12-файлу експортуйте весь публічний сертифікат, а не лише приватний сертифікат всередині нього.
  • Повторно створіть .p12 з нуля, завантажте його та перевірте, чи вирішує це проблему.

Важливо: Якщо ви вже завантажили пуш-сертифікат у налаштуваннях HelpCrunch, він буде закешований, і його заміна на новий не набуде чинності негайно. Щоб переконатися, що ваш оновлений сертифікат працює коректно, будь ласка, зв'яжіться з нашою службою підтримки після кожного завантаження, щоб очистити кеш пуш-сертифіката, перш ніж продовжувати тестування.
Сертифікат APNS без пароля не працюватиме. Переконайтеся, що ви завантажили сертифікат з паролем.

Перевірте свій Bundle ID: Переконайтеся, що Bundle ID вашого додатку збігається з ідентифікатором, зареєстрованим на Apple Developer Portal та в налаштуваннях HelpCrunch. Якщо Bundle ID неправильний або відрізняється від того, що використовувався для генерації вашого push-сертифіката, push-сповіщення можуть не доставлятися. Щоб перевірити свій Bundle ID:  

  1.  Відкрийте Xcode і перейдіть до Налаштувань проекту.  
  2. У розділі GeneralIdentity перевірте Bundle Identifier
  3. Порівняйте його з Bundle ID, зареєстрованим на Apple Developer Portal і в налаштуваннях HelpCrunch (Налаштування→Канали→Застосунки для iOS→Назва_вашого_додатка).  
  4. Якщо він не збігається, оновіть налаштування та, за необхідності, перегенеруйте пуш-сертифікат.

2. Правильно тестуйте пуш-сповіщення

Стан додатку під час тестування: Для точного тестування переконайтеся, що ваш додаток не працює в активному режимі. Пуш-сповіщення можуть не з'являтися, якщо додаток активний, особливо якщо відкрита відповідна розмова в чаті.

  1. Ініціюйте чат зі сторони клієнта.
  2. Повністю закрийте додаток, провівши вгору з нижньої частини екрана і видаливши її зі списку нещодавніх програм.
  3. Коли додаток закритий, відповідайте в чаті на стороні агента і перевіряйте, чи доставлено пуш-повідомлення на мобільний пристрій.

Використовуйте фізичні пристрої: Пам'ятайте, що push-сповіщення не можна тестувати в iOS-симуляторі; використовуйте для тестування фізичний пристрій iOS (наприклад, Testflight).

Режим «Sandbox» не підтримується. Push-повідомлення не працюють у симуляторі iOS.

3. Перевірте налаштування пристрою та додатків

Перевірте налаштування додатків, від яких ви хочете отримувати сповіщення:

  1. Увійдіть у "Параметри IOS" натисніть на  «Сповіщення».
  2. Оберіть серед додатків нижче додаток "HelpCrunch"
  3. Увімкніть перемикач «Дозволити сповіщення» і виберіть, як сповіщення відображатимуться на екрані блокування, в Центрі сповіщень або у вигляді банера під час використання iPhone.

Режим Зосередження та пуш-сповіщення на iOS: iOS містить функцію Зосередження, яка може обмежувати або забороняти пуш-сповіщення залежно від уподобань користувача. Якщо пуш-сповіщення не надходять, перевірте, чи ввімкнено режим Зосередження (наприклад, «Не турбувати», «Робота» або «Сон»). Перевірка та налаштування параметрів фокусування:  

  1. Щоб відкрити Центр керування iOS, проведіть вниз від правого верхнього кута екрана.
  2. Натисніть кнопку Зосередження і перевірте, чи активний якийсь режим. 
  3. Якщо режим активний, натисніть на активний режим, щоб вимкнути його.
  4. Якщо режим Зосередження вимкнено, протестуйте push-сповіщення ще раз (Крок 2)

Якщо у вас все ще виникають проблеми з push-сповіщеннями, не соромтеся звертатися до нас у чат.
Не забудьте вказати відповідні фрагменти коду, версію HelpCrunch SDK, кроки для відтворення помилки, а також всі інші деталі та скріншоти проблеми, яку ви спостерігаєте. Наша команда завжди рада допомогти! 🙂

Чи була наша стаття корисною?