Set Up Messaging Push Notifications for iOS

With push notifications, your customers can be alerted about messaging activity even when they aren't viewing the conversation. When an agent sends a message, your customer receives a notification on their device.

This article applies to the following implementations:

UI SDKCore SDK

Before you add code in your app for notifications, set up Apple Push Notifications as described in the Apple documentation. Then follow Salesforce org setup instructions at Set Push Notifications for Messaging for In-App.

Notifications don't appear under these circumstances.

  • The app isn't installed.
  • The app isn't installed.
  • The device isn't online.
  • The conversation is already displayed in the foreground.

When the app successfully registers with the Apple Push Notification service (APNs), pass device token information to the Messaging for In-App server using CoreFactory.provide(deviceToken). See the CoreFactory reference documentation.

By default, when a user taps on the notification, your app launches to the last view that was showing. If you want to take them to the updated conversation, extract the conversationId property, and then use that value to open the correct messaging conversation.

You can get push notifications when the app is open and in the foreground by default. To suppress notifications when the app is open, add the userNotificationCenter function in the AppDelegate.m file and include this code.

See also Apple’s UNNotificationPresentationOptions object reference documentation.