Передача пуш-сообщений
Типы передаваемых сообщений
Интерфейс Push API различает три типа пуш-сообщений. Тип сообщения указывается партнёром при отправке и определяет назначение сообщения:
- Транзакционное сообщение — сообщение, информирующее клиента о конкретной совершённой операции (транзакции) в рамках программы лояльности. Например: начисление или списание бонусных баллов с персонального счёта клиента при покупке товара или услуги.
- Сервисное сообщение — сообщение, связанное с предоставлением сервиса / услуги клиенту в рамках программы лояльности. Например, подтверждение заказа или покупки, или сообщение о входе в систему самообслуживания.
- Рекламное сообщение — сообщение, информирующее клиента о проведении партнёром маркетингового мероприятия (например, о проведении специальной акции или предоставлении персональной скидки) и направленное на повышение лояльности.
Info
Пуш-сообщение, не отнесённое платформой «Кошелёк» или партнёром к классу транзакционных или сервисных, будет автоматически отнесено к рекламным.
Сообщения с предварительной фильтрацией
В Push API предусмотрена отправка сообщений, требующих предварительной фильтрации на стороне Кошелька перед началом отправки конечным пользователям. Опция доступна начиная с версии Push API v1.2.0.
Статусы доставки сообщений
| Статус | Назначение |
|---|---|
| MSISDN_NOT_REGISTERED | Сообщение не отправлено (пользователь с указанным номером телефона не зарегистрирован в Кошельке). |
| ENQUEUED | Сообщение принято к отправке. |
| DELIVERED | Сообщение доставлено на устройство пользователя. |
| OPENED | Сообщение открыто пользователем. |
Диаграмма состояний сообщения, отправленного с помощью Push API:
Ограничения
- Частота отправки транзакционных и сервисных пуш-сообщений партнёром с использованием Push API ограничена. По умолчанию партнёр не может отправить более 1 млн. сообщений в минуту.
- Изображение может быть включено только в рекламные сообщения. Если изображение задано для транзакционных и сервисных сообщений, оно игнорируется.