iOS interactive notifications

Launched with iOS 8, interactives notifications (unlike basic notifications) incorporate buttons and provide the opportunity for mobile users to interact directly with the message displayed on the screen or in the center of notifications without having to open the application. Widely appreciated by mobile users, this message format is now available on your Accengage interface, with our iOS SDK version 5.4.0 and onwards, for push notifications and scheduled alarms.

Discover below all the information you need to setup and use buttons on your push messages or scheduled alarms:

1- Setting up button categories in the application


For iOS, button categories must first be declared in your application.

A category usually contains 2 buttons (but up to 4 buttons can be addded - the display in this case is subject to specific conditions described further on).

Within a category, each button is defined by an (a):

  • ID: value supported by the application
  • Label: this is the text displayed on the button
  • Type: choice between
  • Foreground: is a button which opens the app
  • Background: is a button which does not open the app (can be used to send a transparent tracking request for example)
  • State "Destructive" (or not): a button defined as “destructive” will be red. This color is used to indicate to the mobile user the importance of his action (like deleting a message, for example)
  • Authentication Required" (or not): specifies whether the mobile user has to log on before interacting with the notification received

Preset buttons

Yes No Like Later
Yes Later Like Dislike
Accept Decline Subscribe No, thanks
Accept Later Subscribe Cancel
I agree I disagree Login Close
Satisfied Unsatisfied Create an account Close
Buy now Later Get more Get less
Show me Share  Get more No, thanks
Share Later Call Later
Add to wishlist Later Add to calendar Close
Show offer Share Answer it Close
Show the deal Later Take part Close
Enjoy now No, thanks Give a feedback No, thanks
Add to cart No, thanks Rate the app Later
Show cart Later I have a feedback Later
Access booking Later See more Close
Access details Later Search Close
Man Woman Find Close
Show me Close Read Close
Share No, thanks Let's go Close
Open Close I'm in No, thanks

2- Adding categories of custom buttons on the Accengage interface


Once defined in the application, custom categories of buttons have to be added on the Accengage interface in order to be used for push notifications and/or scheduled alarms.

Follow the steps below :

Go to the Settings menu > Advanced Settings  > Section 7. Categories (buttons of interactive notifications)

  • Fill in each category button in accordance with the criteria defined by the developper within the application, then click on SAVE

3- Creating interactive push notifications and/or scheduled alarms


To add buttons to your push notifications and/or scheduled alarms, follow the steps below:

  • Select your iOS application
  • Go to the Actions menu > Push notifications > New message Or Actions menu > scheduled alarms > New alarm (for the scheduled alarms)
  • In the section 2. Message (or section 4 for scheduled alarms), set all information related to your notification (message, sound, badge, Rich push URL, advanced settings etc...)
  • Check the box " Content available" if you want to notify the application that it has content to download in the background . This pre-downloading  will optimize the display time to the mobinaute
  • Then, unfold the "buttons" field and select the button category you want to use (custom buttons or preset buttons)
  • Choose on click action type between the following propositions : webview, browser, mail, phone, Appstore, sms, Url scheme, Request, no action
  • Add additional parameters if needed
  • Then test your message by selecting your test segment(s)

Specific case : displaying an interactive notification with 4 buttons

iOS allows you to display up to 4 buttons on an interactive notification but only under specific conditions, specified below:

  • The mobile user must choose, in his phone setting's, the "Alerts" format as a preference for notification reception
  • His phone must be unlocked when he receives the notification
  • He must click on the "Options" button in order to display the additional buttons on the notification (as shown below)

Interactive notification with 4 buttons

Due to these constraints, we recommend you create your custom categories with 2 buttons, which is the most common use case on most devices. Here are some examples of common use.

Locked device

Unlocked device

Notifications centre