Интеграция Web-Push в веб-приложение
Шаг 1. Подготовка к интеграции
Перед подключением виджета подготовьте следующие данные и файлы.
Домен сайта appPackage
Доменное имя сайта, к которому подключается виджет, без протокола.
Например,
example.com.
VAPID-ключи
Для работы виджета необходима пара VAPID-ключей. Публичный ключ используется при инициализации виджета, приватный хранится на платформе.
Чтобы завести новое веб-приложение на Push-платформе, обратитесь в службу поддержки edna. Укажите в письме значения параметров appPackage, а также тип среды — тестовая или производственная.
Если у вас есть доступ к консоли Управление Push, зарегистрируйте приложение и сгенерируйте VAPID-ключи самостоятельно.
Настройка приложения в консоли ednaИдентификатор providerUid
Пара метр providerUid генерируется виджетом автоматически. Задавать его вручную не требуется.
Сборки виджета и сервис-воркера
Выберите сборку в зависимости от используемой Push-платформы:
-
Производственная:
maven-pub.edna.ru -
Тестовая:
maven-pub.edna.ru
Сборки в каталоге push-web-widget предназначены для производственной Push-платформы, в каталоге push-web-widget-demo — для тестовой. Выберите сборку 2.4 с наибольшим номером версии.
Шаг 2. Подключение виджета и сервис-воркера
Разместите файлы виджета и сервис-воркера в проекте. Подключите виджет с помощью скрипта:
<script defer src="edna-web-widget.js"></script>
Если сервис-воркер размещён не в корневом каталоге сайта, укажите путь к нему в параметре ednaWorkerPath в localStorage.
Шаг 3. Настройка параметров виджета
Перед инициализацией виджета задайте в localStorage следующие параметры:
| Параметр | Описание |
|---|---|
appVersion | Версия сборки сайта, используемая для анализа доставки сообщений на стороне edna. |
appPackage | Домен сайта, к которому подключается виджет, без протокола. Например, example.com. |
vapid_key | Пу бличный VAPID-ключ, полученный при регистрации веб-приложения. |
Шаг 4. Запрос разрешения на уведомления
Перед инициализацией виджета необходимо получить разрешение пользователя на показ push-уведомлений.
Если пользователь запретил уведомления, инициализация без разрешения приводит к ошибке PUSH_PERMISSION_DENIED. В этом случае покажите пользователю инструкцию по включению уведомлений.
Пример запроса разрешения в Chrome на десктопном (слева) и мобильном (справа) устройствах:

Рекомендуется предварительно показывать всплывающее окно с описанием цели запроса и кнопками подтверждения и отклонения. Это поможет объяснить пользователю пользу уведомлений. Пример такого окна:

Если пользователь ранее запретил уведомления, повторный запрос разрешения блокируется. Вместо него виджет показывает инструкцию по включению уведомлений.
- На десктопе: откройте настройки сайта, нажав на значок слева от адресной строки браузера.
- На мобильном устройстве: перейдите в настройки браузера и разрешите уведомления для сайта.
Пример настройки уведомлений на десктопном устройстве:

Сценарий запроса разрешения можно создать самостоятельно или использовать метод checkPermitAndAsk().