To integrate Proactive or IVR Deflection to App messaging, brands must follow these configurations steps when implementing the SDK (minimum version iOS SDK 6.2 more below):

  • Text only content is not supported until 6.8.0. Rich formats are supported since 6.2.0.

  • Make sure the brand app already has push notification set up in order to enable their consumers to receive notifications. You can find detailed instructions on how to set up LivePerson's push notification service here.

Limitations

  • Currently, the proactive messages only work for Push Notifications that are received when the application state is not active, and the notifications are tapped.
  • Processing InApp Notifications for Proactive and IVR Deflection messages is only supported when using the default In App Notification provided by the LPMessagingSDK.
  • When using Custom InApp Notifications, Host App has to call handleTapForInAppNotification to notify the SDK an InApp Notification was tapped.

Send push notifications in logout state (new Logout API)

Consumers can now receive push notifications even in logged out state. SDK has introduced new enum configurations to let brands decide If they want consumers to receive notifications when logged out. Brands can choose either of the following configurations to unregister user from pusher:

func logout(unregisterType: LPPusherUnregisterType,
                       completion: @escaping ()->(),
                       failure: @escaping (_ errors: [Error])->())

LPPusherUnregisterType

All: unregister for all types of push notification messages

None: do not unregister from the pusher at all

Agent: Unregister only for agent push notification messages. Consumers can still receive outbound push notifications sent from the Proactive or Connect to Messaging (IVR) services.

Processing InApp notifications when the app is active

To enable processing of Proactive and IVR Deflection while the Application is active, the following configuration needs to be enable:

enableInAppProcessingForActiveState = true
enableInAppProcessingForActiveState

Enable or disable the ability to display Proactive and IVR Deflection messages on Conversation Screen

  • Type: Bool
  • Default Value: false
  • Preconditions:
    • Consumer to be registered for Push Notifications
    • Consumer tapped InApp Notification
  • Available since: 6.4.1

This flags enables SDK to process InApp Notifications for Proactive and IVR Deflection messages, is not related to Push Notifications received when the Application is not active.

Fetching Pending Proactive Messages

The host application can fetch pending proactive messages to present them to the consumer,

  • This fetching can be done implicitly enabling fetchPendingProactiveMessagesImplicitly, implicit fetching will fetch the pending proactive notifications for the host app on different lifecycle events to show them on conversation screen launch.
  • This fetching can be done explicitly using the getPendingProactiveMessages API to have more control over when to make the request related to this.

Optional: Overriding InApp notifications

When using the LPMessagingSDKNotification(customLocalPushNotificationView notification: LPNotification) protocol to override the InApp Notification, Host App has to call the following method to notify the SDK an InApp Notification was tapped:

public func handleTapForInAppNotification(notification: LPNotification)