Конфигурация веб-push-уведомлений

Чтобы начать отправлять веб-push-уведомления с помощью Pushwoosh, вам необходимо настроить вашу веб-push-платформу и включить запрос на подписку, который будет отображаться пользователям.

Чтобы начать настройку, перейдите в Settings > Platform Configuration > Web Push Notifications и нажмите Configure.

Эта конфигурация применяется ко всем современным браузерам, включая последние версии Safari, которые теперь поддерживают веб-push-уведомления нативно.

Примечание: Старые версии Safari (macOS 10.14–12) требуют отдельной настройки. Вы можете выполнить ее в специальном разделе. Подробнее

Чтобы начать установку, нажмите Configure в разделе All browsers configuration.

В окне конфигурации выберите один из следующих вариантов:

• Создать новую конфигурацию для push-уведомлений
  Рекомендуется, если вы ранее не настраивали веб-push-уведомления через другой сервис. Pushwoosh автоматически сгенерирует новую пару VAPID-ключей.

• Использовать существующую конфигурацию
  Выберите этот вариант, если у вас уже есть VAPID-ключи, например, из Firebase, и вы хотите продолжать использовать их, не запрашивая у пользователей повторную подписку.

Выберите Создать новую конфигурацию для push-уведомлений, если вы ранее не настраивали веб-push-уведомления с помощью другого сервиса. Pushwoosh автоматически сгенерирует для вас необходимые VAPID-ключи (Voluntary Application Server Identification).

Нажмите Configure, чтобы сгенерировать и применить ключи.

После создания Pushwoosh будет автоматически использовать эти ключи в конфигурации SDK. Подробнее об интеграции Web Push SDK

Если у вас уже есть VAPID-ключи (например, сгенерированные через Firebase), вы можете использовать их повторно для настройки веб-push-уведомлений в Pushwoosh.

Для этого:

1. Выберите Use existing configuration.

2. В поле Web Push Certificate введите ваш открытый VAPID-ключ.

3. В поле Web Push Private Key введите ваш закрытый VAPID-ключ.

4. Нажмите Configure, чтобы сохранить и применить настройки.

Если вы переходите с Firebase и вам нужно повторно использовать существующие VAPID-ключи, выполните следующие шаги, чтобы их найти.

1. В Firebase перейдите в Project Settings → Cloud Messaging.
2. Прокрутите вниз до раздела Web Configuration и скопируйте существующую пару ключей.

3. Вставьте его в поле Web Push Certificate в форме веб-конфигурации Pushwoosh.

1. В консоли Firebase перейдите в Project Settings → Cloud Messaging → Web Configuration.
2. Нажмите меню с тремя точками в разделе Actions рядом с парой ключей и выберите Show private key. Этот ключ необходим для обеспечения корректной работы веб-push-уведомлений.

3. Скопируйте отображаемый ключ в буфер обмена.

4. В форме веб-конфигурации Pushwoosh вставьте его в поле Web Push Private Key.

5. Нажмите Apply, чтобы сохранить изменения.

Если вы уже настроили веб-push-уведомления, но вам нужно обновить учетные данные (например, заменить VAPID-ключи), сделайте следующее:

1. Нажмите Reconfigure в разделе All browsers configuration.

2. Во всплывающем окне введите ваши новые VAPID-ключи:

   • Web Push Certificate: ваш новый открытый VAPID-ключ
   • Web Push Private Key: ваш новый закрытый VAPID-ключ

3. Нажмите Configure, чтобы сохранить изменения.

Для отправки push-уведомлений пользователи должны явно предоставить разрешение через системный запрос браузера. Без этого разрешения уведомления не могут быть доставлены.

Из-за недавних изменений в политике Chrome и Firefox нативный всплывающий запрос на разрешение может появляться только после того, как пользователь взаимодействует со страницей (например, нажимает кнопку). Чтобы соответствовать этому требованию, Pushwoosh по умолчанию отображает виджет запроса на подписку. Этот виджет побуждает пользователей дать согласие, и при их согласии запускает нативный запрос браузера.

Чтобы настроить текст и внешний вид запроса, нажмите Settings.

Доступны два типа запросов на подписку:

• Виджет по умолчанию
  Предоставляется Pushwoosh и отображается автоматически. Узнайте, как настроить виджет по умолчанию.

• Пользовательский виджет.
  Используйте собственный дизайн виджета. Подробнее

Примечание: Из-за ограничений платформы изменения в виджете могут появиться в течение 30 минут. Если изменения не отображаются, обратитесь в службу поддержки Pushwoosh.

Для поддержки push-уведомлений в старых версиях Safari (macOS 10.14–12) вам необходимо выполнить отдельный процесс настройки, используя ваши учетные данные Apple Developer. Этот шаг требуется только для этих старых версий, поскольку новые версии Safari (macOS Ventura и более поздние) поддерживают стандартную настройку веб-push, включенную в конфигурацию для всех браузеров.

1. Перейдите в раздел Certificates, Identifiers & Profiles на портале Apple Developer.

2. Добавьте новый сертификат.

3. Выберите тип Website Push ID Certificate и нажмите Continue.

4. Выберите Website Push ID — вашу уникальную строку в формате обратного домена, например web.com.example.domain (должна начинаться с web.).

5. Загрузите запрос на подпись сертификата (CSR). Чтобы узнать больше о создании запросов на подпись сертификата, обратитесь к статье справки Developer Account.

6. После этого загрузите сертификат для push-уведомлений.

1. Нажмите Configure в разделе Safari Configuration.

2. Заполните следующие поля в форме конфигурации:

3. Нажмите Configure, чтобы сохранить изменения.

Pushwoosh автоматически сгенерирует push-пакет с набором иконок, JSON-словарем сайта и файлом манифеста, который Safari запрашивает с сервера. Вы можете загрузить его в любое время.