Настройка веб-пушей

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

Важно

Убедитесь, что Web Push SDK правильно интегрирован в ваш сайт. Это обязательный шаг, чтобы пользователи могли подписываться и получать уведомления. Узнать больше

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

Настройка веб-пушей для всех браузеров (кроме старых версий Safari)

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

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

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

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

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

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

Создание новой конфигурации пушей

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

Что такое VAPID-ключи?

VAPID-ключи — это пара из открытого и закрытого ключей, используемая в Web Push Protocol для аутентификации сервера приложений при отправке пуш-уведомлений в веб-браузеры. Открытый ключ передается браузеру, когда пользователь подписывается на уведомления. Закрытый ключ остается на вашем сервере и используется для безопасной подписи каждого отправляемого вами сообщения.

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

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

Использование существующей конфигурации

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

Для этого:

1. Выберите Использовать существующую конфигурацию.

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

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

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

Как найти VAPID-ключи в Firebase

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

Web Push certificate

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

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

Web Push private key

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

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

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

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

Перенастройка конфигурации веб-пушей

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

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

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

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

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

Важно

Замена VAPID-ключей влияет на всю вашу настройку веб-пушей и может нарушить доставку уведомлений, если не управлять этим процессом правильно. Меняйте ключи только в случае крайней необходимости и убедитесь, что вы понимаете последствия, прежде чем вносить какие-либо обновления.

Настройка запроса на подписку

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

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

Совет

Хорошо продуманный запрос, объясняющий ценность уведомлений (например, «Получайте последние новости и обновления»), может значительно повысить процент подписок.

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

Типы запросов

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

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

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

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

Конфигурация Safari (macOS 10.14–12)

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

Получение необходимых учетных данных от Apple

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

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

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

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

5. Загрузите Certificate Signing Request. Чтобы узнать больше о создании Certificate Signing Request, обратитесь к статье справки Developer Account.

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

Примечание

Сертификат, который вы загружаете с сайта Apple, представляет собой файл .cer. Чтобы получить файл .p12, необходимый для настройки Pushwoosh, вы должны экспортировать закрытый ключ. Подробности см. в руководстве по настройке iOS.

Настройка Safari в Pushwoosh

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

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

Название сайта	Название вашего сайта, которое отображается в запросе на подписку.
Разрешенные домены	Список доменов, которым разрешено запрашивать разрешение на отправку уведомлений (по одному в строке).
Шаблон URL	URL, открываемый при нажатии на уведомление. Поддерживает плейсхолдеры, такие как %@, для вставки динамических значений. Пример: https://yourwebsite.com/%@
Иконка сайта	Загрузите квадратное изображение в формате PNG (256×256 пикселей). Pushwoosh автоматически изменяет его размер для различных интерфейсов.
Файл ключа	Загрузите сертификат .p12, экспортированный из вашей учетной записи Apple Developer.
Пароль закрытого ключа	Пароль, использованный при экспорте файла .p12.

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

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

Важно

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

Push package со всем его содержимым загружается КАЖДЫМ подписавшимся пользователем ТОЛЬКО ОДИН РАЗ при регистрации и не может быть принудительно обновлен на устройствах.

Учитывайте это при запуске пуш-уведомлений Safari для вашего сайта в продакшене.