Перейти к содержанию

Передача пуш-сообщений

Типы передаваемых сообщений

Интерфейс Push API различает три типа пуш-сообщений. Тип сообщения указывается партнёром при отправке и определяет назначение сообщения:

  • Транзакционное сообщение — сообщение, информирующее клиента о конкретной совершённой операции (транзакции) в рамках программы лояльности. Например: начисление или списание бонусных баллов с персонального счёта клиента при покупке товара или услуги.
  • Сервисное сообщение — сообщение, связанное с предоставлением сервиса / услуги клиенту в рамках программы лояльности. Например, подтверждение заказа или покупки, или сообщение о входе в систему самообслуживания.
  • Рекламное сообщение — сообщение, информирующее клиента о проведении партнёром маркетингового мероприятия (например, о проведении специальной акции или предоставлении персональной скидки) и направленное на повышение лояльности.

Info

Пуш-сообщение, не отнесённое платформой «Кошелёк» или партнёром к классу транзакционных или сервисных, будет автоматически отнесено к рекламным.

Сообщения с предварительной фильтрацией

В Push API предусмотрена отправка сообщений, требующих предварительной фильтрации на стороне Кошелька перед началом отправки конечным пользователям. Опция доступна начиная с версии Push API v1.2.0.

Статусы доставки сообщений

Статус Назначение
MSISDN_NOT_REGISTERED Сообщение не отправлено (пользователь с указанным номером телефона не зарегистрирован в Кошельке).
ENQUEUED Сообщение принято к отправке.
DELIVERED Сообщение доставлено на устройство пользователя.
OPENED Сообщение открыто пользователем.

Диаграмма состояний сообщения, отправленного с помощью Push API:

Жизненный цикл сообщения, отправленного с помощью Push API

Жизненный цикл сообщения, отправленного с помощью Push API

Ограничения

  1. Частота отправки транзакционных и сервисных пуш-сообщений партнёром с использованием Push API ограничена. По умолчанию партнёр не может отправить более 1 млн. сообщений в минуту.
  2. Изображение может быть включено только в рекламные сообщения. Если изображение задано для транзакционных и сервисных сообщений, оно игнорируется.