Setting Up Push Notifications

To send push notifications to mobile devices, use the Push Notifications subsection:

Set parameters depending on the OS type in use:

• Firebase Cloud Messaging. The section for setting up Android service:

• Firebase. Select the checkbox to use the service and set the displayed parameter:

• Authorization Key. Specify authorization key. The box is mandatory.

• Apple Push Notification service. The section for setting up iOS service:

• APNs. Select the checkbox to use the service and set the displayed parameters:

• Via Firebase Cloud Messaging. If required, select the checkbox to use the Firebase service and specify authorization key in the Authorization Key box.

NOTE. The Authorization Key box is available only if the Via Firebase Cloud Messaging checkbox is selected and the box is mandatory. When the Firebase service is used, the APNs parameters specified below become not available.

• Bundle ID. Specify iOS application identifier. The box is mandatory.

• Apns Certificate as File. Select the file with APNs certificate on clicking the Choose File button. The parameter is mandatory.

• Apns Server. Select the APNs server type in the drop-down list: Development, Production.

• Windows Push Notification Services. The section for setting up Windows service:

• WNS. Select the checkbox to use the service and set the displayed parameters:

• Client ID. Specify Windows application identifier. The box is mandatory.

• Client Secret. Specify Windows application secret key. The box is mandatory.

• Set Up Proxy Server for Sending Push Notifications. If required, set parameters for sending push notifications with the use of proxy server:

• Proxy Address. Specify IP address or DNS proxy server.

• Port. Specify the TCP port, via which the proxy server is available. The 80 value is set by default.

NOTE. To work with APNS server, authentication and SSL traffic inspection are required on the proxy server.

• Set Up Push Notifications Storage. If required, set the parameter to store messages:

• Storage Time for Push Messages on Server (days). Specify the storage time in days for push messages on mobile platform server. The 180 value is set by default.

After setting up push notifications parameters click the Save button.

Sending Push Notifications

Push notifications sending algorithm:

1. User authentication with specifying device DeviceID. The response contains api_sessionid used in further requests.

2. The device token request from the corresponding push notifications service (for Android - Firebase, for iOS - APNS, for Windows - WNS) on a mobile device.

3. Token sending to mobile platform server with a link to device and specifying platform, service, and token itself.

NOTE. If the sent token is already in the project, but is linked to other user, the server returns error. To relink the token, authenticate as the user, to who the token is linked, and send a request to delete token from server.

4. Send a request:

• With specifying template and user on sending push notifications to a specific user.

• With specifying template and topic on sending push notifications to a group of users.

Methods and requests to send push notifications are given in the Methods for Working with Push Notifications section.

To check state of push notification sending, see the Checking State of Push Notification Sending section.

See also:

Setting Up Environments and Projects | Adding a Message Topic | Adding Push Notification Templates | Checking State of Push Notification Sending