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

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

Важно

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

Чтобы начать настройку, перейдите в Настройки > Конфигурация платформ > Web Push-уведомления и нажмите Настроить.

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

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

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

Чтобы начать, нажмите Настроить в разделе Конфигурация для всех браузеров.

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

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

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

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

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

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

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

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

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

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

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

Для этого:

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

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

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

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

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

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

Сертификат Web Push

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

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

Приватный ключ Web Push

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

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

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

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

Перенастройка конфигурации web push

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

1. Нажмите Перенастроить в разделе Конфигурация для всех браузеров.

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

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

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

Важно

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

Настройка Subscription prompt

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

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

Tip

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

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

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

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

• Default widget
  Предоставляется Wavesend и отображается автоматически. Узнайте, как настроить Default widget.

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

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

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

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

Получение необходимых учетных данных от 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). Чтобы узнать больше о создании запросов на подпись сертификата, обратитесь к статье справки для аккаунта разработчика.

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

Note

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

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

1. Нажмите Настроить в разделе Конфигурация Safari.

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

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

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

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

Важно

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

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

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