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

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

Важно

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

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

Настройка веб-пушей для всех браузеров (кроме старых версий 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 для аутентификации сервера приложений при отправке пуш-уведомлений в веб-браузеры. Открытый ключ передается браузеру, когда пользователь подписывается на уведомления. Закрытый ключ остается на вашем сервере и используется для безопасной подписи каждого отправляемого сообщения.

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

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

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

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

Для этого:

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

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 Console перейдите в Project Settings → Cloud Messaging → Web Configuration.
2. Нажмите на меню с тремя точками в разделе Actions рядом с парой ключей и выберите Show private key. Этот ключ необходим для корректной работы веб-пуш-уведомлений.

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

4. В форме Pushwoosh Web Configuration вставьте его в поле 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 для вашего сайта в рабочей среде.