Push Notifications

A notification alerts a user about relevant and timely events. Notifications are of two types, local notifications and remote notifications.

  • A local notification is scheduled by an app and delivered by the platform on the same device, regardless of whether the app is currently running in the foreground.
  • A remote notification is also known as push notification is sent by an app’s remote server to the Push Notification service, which pushes the notification to all devices that have the app installed. For example, a news app that alerts its users with important events as they happen.

📘

IMIconnect does not support local notifications.

What are interactive notifications and why do I need them?

A notification can be an interactive or non-interactive. A notification that supports actions are known as interactive notifications. Traditional notifications alert you when a message is received by your device. The notification does not allow you to do anything with the message after reading it.
To respond to a traditional notification, you have to open message box and then open the message you received. Finally, click the reply button.

Interactive notifications let you respond without switching between the apps. When you receive a message, you will have one or two buttons configured along with the message. You can click one of the buttons to respond. Interactive notifications are secure and cannot be used to spread malicious activity from one app to another.

For example, if someone sends you an invite to a movie, you can accept or reject the invitation.


How do I send interactive notifications?


Interactive notifications can be send through the following channels:

  • RTM
  • PUSH

You can configure the channels using IMIconnect platform or IMIconnect SDK for Android and iOS platforms. Refer to messaging API for more details.

Interactive Notification Actions

Following are the actions available for PUSH and Real Time Messaging:

ActionPUSHRTMDescriptionExample
OPEN_APPOpens an app.Not Applicable
OPEN_URLOpens a URL.http://www.google.com
DEEPLINKDeep link a page on an app. The format is ://command/RT09142800://command/preferences
OPENWEBVIEWOpens a link in a Webview.http://www.google.com
SHAREOpens share intent in your app.Text to be copied to clipboard
INLINE_REPLYOpens an inline reply box.Not Applicable
TRIVIAL_REPLYSends a trivial reply.This is a sample text.

Interactive Notification Categories

Following are the interactive notification categories and allowed actions for buttons:

Category

Button 1

Allowed Actions for Button1

Button2

Allowed Actions for Button2

SINGLE_DISMISS

DISMISS

DISMISS

Not Applicable

Not Applicable

SINGLE_OPEN

OPEN

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

Not Applicable

Not Applicable

SINGLEREPLY
(_Applicable only for RTM
)

REPLY

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

Not Applicable

Not Applicable

SINGLE_SHARE

SHARE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

Not Applicable

Not Applicable

SINGLE_SUBSCRIBE

SUBSCRIBE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

Not Applicable

Not Applicable

SINGLE_UNSUBSCRIBE

UNSUBSCRIBE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

Not Applicable

Not Applicable

DOUBLE_ACCEPT_CANCEL

ACCEPT

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

CANCEL

DISMISS

DOUBLE_BUY_NOW_BUY
_LATER

BUY NOW

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

BUY LATER

DISMISS

DOUBLE_LATER_NOW

LATER

DISMISS

NOW

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DOUBLE_LIKE_SHARE

LIKE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

SHARE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DOUBLE_OK_LEARN
_MORE

OK

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

LEARN MORE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DOUBLE_PLAY_NOW
_PLAY_LATER

PLAY NOW

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

PLAY LATER

DISMISS

DOUBLE_REPLY_DISMISS
(Applicable only for RTM)

REPLY

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DISMISS

DISMISS

DOUBLE_REPLY_NO
_DISMISS (Applicable only for RTM)

REPLY AS NO

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DISMISS

DISMISS

DOUBLE_REPLY_YES
_DISMISS (Applicable only for RTM)

REPLY AS YES

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DISMISS

DISMISS

DOUBLEREPLY_YES_NO
(_Applicable only for RTM
)

REPLY AS YES

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

NO

DISMISS

DOUBLE_SHARE_CANCEL

SHARE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

CANCEL

DISMISS

DOUBLE_SHOPNOW
_CANCEL

SHOP

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

CANCEL

DISMISS

DOUBLE_SUBSCRIBE
_UNSUBSCRIBE

SUBSCRIBE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

UNSUBSCRIBE

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

DOUBLE_YES_NO

YES

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY

NO

  • OPEN_APP
  • OPEN_URL
  • DEEPLINK
  • OPENWEBVIEW
  • SHARE
  • INLINE_REPLY
  • TRIVIAL_REPLY