Transcript
  • Configure Push Notifications

    • Push Notifications Overview, on page 1• Push Notifications Configuration, on page 5

    Push Notifications OverviewWhen your cluster is enabled for Push Notifications, Unified Communications Manager and the IM andPresence Service use Google and Apple’s cloud-based Push Notification service to push notifications forvoice and video calls, instant message notification to Cisco Jabber or CiscoWebex on Android and iOS clientsthat are running in suspendedmode (also known as backgroundmode). Push Notifications allows your systemto maintain a persistent communication with Cisco Jabber or Cisco Webex. Push Notifications is requiredboth for Cisco Jabber and Cisco Webex on Android and iOS clients that connect from within the enterprisenetwork, and for clients that register to an on-premise deployment through Expressway's Mobile and RemoteAccess (MRA) feature.

    How Push Notifications Work

    At startup, clients that are installed on Android and iOS platform devices register to Unified CommunicationsManager, the IM and Presence Service and to the Google and Apple cloud. With MRA deployments, theclients registers to the on-premises servers through Expressway. So as long as the Cisco Jabber and CiscoWebex client remains in foregroundmode,Unified CommunicationsManager and the IM and Presence Servicecan send calls and instant messages to the clients directly.

    However, once the Cisco Jabber or Cisco Webex clients moves to suspended mode (for example, to maintainbattery life), the standard communication channel is unavailable, preventing Unified CommunicationsManagerand IM and Presence Service from communicating directly with the clients. Push Notifications providesanother channel to reach the clients through the partner clouds.

    Cisco Jabber and CiscoWebex is considered to be running in suspendedmode if any of the following conditionsare true:

    • the Cisco Jabber or Cisco Webex application is running off-screen (in the background)

    • the Android or iOS device is locked

    • the Android or iOS device screen is turned off

    Note

    Configure Push Notifications1

  • Figure 1: Push Notifications Architecture

    The above diagram displays what happens when Cisco Jabber or Cisco Webex for Android and iOS clientsrun in the background or are stopped. The figure illustrates: (1) an MRA deployment where the clients thatconnects with an on-premises Cisco Unified Communications Manager and IM and Presence Servicedeployment through Expressway, and (2) a Cisco Jabber or Cisco Webex for Android and iOS clients thatconnects directly to the on-premises deployment from within the enterprise network.

    As of iOS13 for Apple clients and supported Android clients, voice calls and messages use separate PushNotifications channels ('VoIP' and 'Message') to reach a client that is running in background mode. However,the general flow is the same for both channels. With iOS 12, voice calls and messages are delivered using thesame channel.

    Note

    Push Notifications Behavior for Cisco Jabber and Cisco Webex

    The following table describes the behavior under iOS 12 and iOS 13 for Cisco Jabber or Cisco Webex iOSclients that are registered to Unified Communications Manager and the IM and Presence Service.

    Configure Push Notifications2

    Configure Push NotificationsPush Notifications Overview

  • Cisco Jabber is running on an iOS13 Deviceor Android Device

    Cisco Jabber is running on an iOS12 DeviceCisco Jabber or CiscoWebex client is runningin...

    The behaviour is the same as with iOS12.Voice and Video Calls

    Unified Communications Manager sendsvoice and video calls to Cisco Jabber or CiscoWebex clients directly using the standard SIPcommunications channel.

    For calls, Unified Communications Manageralso sends Push Notifications to Cisco Jabberor CiscoWebex clients that are in foregroundmode. However, the standard SIP channelgets used to establish the call, rather than thePush Notifications channel.

    Messages

    The IM and Presence Service sends messagesto the client directly using the standard SIPcommunication channel. For messages, PushNotifications are not sent to clients that arein foreground mode.

    Foreground Mode

    Configure Push Notifications3

    Configure Push NotificationsPush Notifications Overview

  • Cisco Jabber is running on an iOS13 Deviceor Android Device

    Cisco Jabber is running on an iOS12 DeviceCisco Jabber or CiscoWebex client is runningin...

    With iOS13, call traffic and message trafficis split into separate Push Notificationschannels: a 'VoIP' channel for calls, and a"Message" channel for messaging.

    Voice or Video Calls

    Standard communication channel isunavailable. Unified CM uses PushNotifications 'VoIP' channel.

    Upon receiving the VoIP notification, Jabberlaunches CallKit with Caller ID.

    This behavior holds for Cisco Jabber or CiscoWebex iOS clients.

    Messaging

    Standard communication channel isunavailable. IM and Presence Service usesPush Notifications 'Message' channel.

    1. IM and Presence Service sends the IMnotification to the Push REST service inthe Cisco cloud, which forwards thenotification to the Apple cloud.

    2. The Apple cloud pushes the IMnotification to the Cisco Jabber or CiscoWebex client.

    3. When the user clicks the notification,Cisco Jabber or Cisco Webex clientmoves to foregroundmode. Cisco Jabberor Cisco Webex client resumes thesession with the IM and Presence Serviceand downloads the message.

    While Cisco Jabber or CiscoWebex client is in suspendedmode, the user Presence displaysas Away.

    Note

    Voice or Video Calls

    Standard communication channel isunavailable. Unified CM uses the PushNotifications channel.

    Upon receiving the notification, the CiscoJabber or Cisco Webex client re-entersforegroundmode automatically, and the clientrings.

    Messaging

    Standard communication channel isunavailable. IM and Presence Service usesthe Push Notifications channel to send IMnotifications as follows:

    1. IM and Presence Service sends the IMnotification to the Push REST service inthe Cisco cloud, which forwards thenotification to the Apple cloud.

    2. The Apple cloud pushes the IMnotification to the Cisco Jabber or CiscoWebex client and a notification appearson the Cisco Jabber or Cisco Webexclient.

    3. When the user clicks the notification, theCisco Jabber or Cisco Webex clientmoves back the foreground. The CiscoJabber or Cisco Webex client resumesthe session with the IM and PresenceService and downloads the instantmessage.

    While the Cisco Jabber or CiscoWebex client is in suspendedmode, the user's Presence statusdisplays as Away.

    Note

    Suspended Mode(Background mode)

    Supported Clients for Push Notifications

    Cloud ServicePlatform CloudOSClient

    Apple Push NotificationService (APNS)

    AppleiOSCisco Jabber on iPhoneand iPad

    Android PNS ServiceGoogleAndroidCisco Jabber on Android

    Apple Push NotificationService (APNS)

    AppleiOSWebex on iOS

    Configure Push Notifications4

    Configure Push NotificationsPush Notifications Overview

  • Cloud ServicePlatform CloudOSClient

    Android PNS ServiceGoogleAndroidWebex on Android

    Push Notifications ConfigurationFor details on how to configure and deploy Push Notifications, refer toDeploying Push Notifications for CiscoJabber on iPhone and iPad at https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.html.

    Configure Push Notifications5

    Configure Push NotificationsPush Notifications Configuration

    https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.htmlhttps://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.html

  • Configure Push Notifications6

    Configure Push NotificationsPush Notifications Configuration

    Configure Push NotificationsPush Notifications OverviewPush Notifications Configuration