Перенос push-подписок из стороннего сервиса

Эта статья описывает перенос push-подписок из стороннего сервиса на платформу Altcraft.

Шаг 1. Получение VAPID-ключей

подсказка

VAPID keys и Application Server keys — это одно и то же.

Запросите VAPID-ключи у технической поддержки текущего сервиса. Нужны приватный и публичный ключи: private key, public key.

---

Шаг 2. Импорт VAPID-ключей в Firebase

Откройте настройки проекта в Firebase Console и перейдите на вкладку Cloud Messaging. В разделе Web Configuration нажмите import an existing key pair.

---

В появившемся окне введите Public key и Private key от текущего сервиса.

Шаг 3. Настройка ресурса в платформе Altcraft

Настройте ресурс для Web Push-уведомлений. Подробнее в статье Настройка ресурса и сайта.

подсказка

Настройка ресурса отличается для разных браузеров. Убедитесь, что провайдеры настроены правильно.

Шаг 4. Подготовка CSV-файла с подписками

При подписке пользователя на push-уведомления создаётся объект PushSubscription, который содержит данные для отправки уведомлений:

{
  "endpoint": "https://some.pushservice.com/something-unique",
  "keys": {
    "p256dh": "BIPUL12DLfytvTajnryr2PRdAgXS3HGKiLqndGcJGabyhHheJYlNGCeXl1dn18gSJ1WAkAPIxr4gK0_dQds4yiI=",
    "auth": "FPssNDTKnInHVndSTdbKFw=="
  }
}

Выгрузите эти данные из стороннего сервиса в CSV-файл. Для каждой подписки должны быть указаны поля endpoint, p256dh, auth.

Передайте CSV-файл для обработки:

• Для облачной версии: передайте файл в службу поддержки Altcraft
• Для On-Premises: передайте файл администратору платформы. Далее он должен привести данные к формату, совместимому с импортом. Подробнее о том, как это сделать, администратор может прочесть в этой статье документации для администраторов.

После обработки вы получите готовый к импорту CSV-файл.

---

Шаг 5. Импорт профилей с подписками

Создайте или выберите подходящую базу данных и в выпадающем списке нажмите Импорт профилей клиентов.

---

Выберите способ импорта — Файл. Загрузите CSV-файл с подписками.

---

Нажмите Режим поиска подписки и выберите Поиск по пуш подписке.

предупреждение

Если в файле есть данные для сопоставления существующих пользователей (например, email, phone), выберите соответствующий режим поиска профиля.

---

Нажмите Добавить подписку и настройте параметры: Канал — Push канал Провайдер — если браузер подписки неизвестен, укажите Chrome Firebase Источник подписки — firebase_push_token

предупреждение

Для создания подписки необходимо название поля, где хранится ID подписки. В обработанном CSV-файле это поле называется firebase_push_token.

---

Настройте соответствие колонок: SubscriptionID — firebase_push_token Provider — поле идентификатора провайдера Altcraft. Если поле отсутствует в CSV, укажите то же, что и в SubscriptionID — для каждой подписки будет создан новый профиль

Список идентификаторов Web-провайдеров

В поле Provider CSV-файла укажите один из следующих идентификаторов:

Провайдер	Идентификатор
Mozilla Firefox	mozilla
Safari	safari
Firefox Firebase	firefox-firebase
Chrome Firebase	chrome-firebase
Opera Firebase	opera-firebase
Yandex Firebase	yandex-firebase
Samsung Firebase	samsung-firebase
IOS APNs	ios-apns
IOS Huawei Mobile Services	ios-huawei

предупреждение

В поле Пропустить строк укажите значение 1, если в файле есть заголовки.

---

Нажмите Импортировать. После завершения импорта откройте базу данных и вкладку Подписки — там отобразятся новые подписки профилей на push-уведомления.

подсказка

Если вы переносите подписки с сервиса OneSignal, изучите статью Миграция с OneSignal.