Как начать работать с push-уведомлениями в браузере Yandex Cloud Notification Service
Примечание
Сервис находится на стадии Preview.
Чтобы включить Cloud Notification Service, запросите доступ к сервису у вашего аккаунт-менеджера или в технической поддержке.
Cloud Notification Service (CNS) — сервис для мультиканальной отправки уведомлений пользователям. HTTP API сервиса совместим с Amazon SNS API.
С помощью Cloud Notification Service вы можете отправлять push-уведомления в браузеры пользователей.
Чтобы начать работу с push-уведомлениями:
- Подготовьте облако к работе.
- Создайте канал push-уведомлений в браузере.
- Получите данные для отправки уведомлений пользователю.
- Создайте эндпоинт.
- Отправьте уведомление.
Подготовьте облако к работе
Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:
- Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
- На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.
Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.
Подробнее об облаках и каталогах.
Создайте канал push-уведомлений в браузере
В Cloud Notification Service сообщения конечным пользователям отправляются через каналы уведомлений.
Чтобы создать канал:
-
В консоли управления выберите каталог, в котором вы хотите создать канал уведомлений.
-
В списке сервисов выберите Cloud Notification Service.
-
Нажмите Создать канал уведомлений.
-
Выберите вкладку Push-уведомления в браузере.
-
Введите имя канала уведомления. Имя канала должно быть уникальным в Cloud Notification Service.
-
Нажмите Создать.
Создание канала уведомлений может занять некоторое время.
Получите данные для отправки уведомлений пользователю
Для каждого канала надо создать набор эндпоинтов, через которые будут отправляться уведомления в браузеры конкретных пользователей.
Чтобы создать эндпоинт, получите данные пользователя:
-
Из браузера пользователя с помощью Service Worker вызовите метод JavaScript subscribe.
В ответ вернется объект PushSubscription.
-
Преобразуйте полученный объект в JSON, вызвав метод toJSON.
Пример параметров подписки в JSON
{
"endpoint": "https://fcm.googleapis.com/fcm/send/abcdef123456",
"expirationTime": 1704093740000,
"keys": {
"p256dh": "BOrLkr7sEt8tERyAv6c8ZG5UC********",
"auth": "aBcDeFg12345"
}
}
Создайте эндпоинт
- Выберите созданный канал уведомлений.
- Выберите вкладку Эндпоинты.
- Нажмите Создать эндпоинт.
- Введите Параметры эндпоинта в JSON, которые были получены в браузере пользователя.
- Нажмите Создать.
Отправьте уведомление
- Выберите созданный эндпоинт.
- Введите текст уведомления.
- Нажмите кнопку Отправить.
Каждому отправленному уведомлению присваивается уникальный идентификатор. Чтобы сохранить его, нажмите кнопку Скопировать идентификатор.