Push Message Transmission
Push Message Types
Push API separates push messages into three types. Type of the message must be specified by the partner when the message is ready for transmission. Each type determines the purpose of a push message:
- Transactional message is a message that informs customer about certain transaction made within the loyalty program such as changing the bonus points amount on the customer’s personal account when a product or service is purchased.
- Service message is a message related to the provision of a service within the loyalty program. For example, a confirmation of order or purchase, message about entering to the self-service system, etc.
- Advertising message is a message that informs customer about any partner’s marketing event (for example, a promotional action or personal discount for the customer, etc.). Such messages usually aimed at increasing customers’ loyalty.
Info
A push message that was not classified by the Koshelek platform as transactional or service message, will automatically classified as advertising.
Message Delivery Statuses
| Status | Description |
|---|---|
| MSISDN_NOT_REGISTERED | The message is not sent because the user with the specified phone number is not registered in the Koshelek app. |
| ENQUEUED | The message is enqueued for delivery. |
| DELIVERED | The message is delivered to user’s device. |
| OPENED | The user has opened and read the message. |
State chart for push messages transmitted by using Push API is presented in the figure below.
Restrictions
- The frequency of sending transactional and service push messages by a partner using Push API is limited. By default, a partner cannot send more than 1,000,000 (1 million) messages per minute.
- An image can be embedded only into advertisement push messages. If an image is added to a transactional or service push message, it is ignored.