Salesforce Docs Portal

Configure the External Client App’s Push Notification Settings and Policies for iOS

To set up push notifications for iOS versions of your mobile app, collect information from Apple App Store Connect and from your Apple Developer account. Then, configure the external client app’s push notification settings and policies in External Client App Manager.

Required Editions

Available in: Lightning Experience
Available in: Professional, Performance, Unlimited, and Developer Editions
User Permissions Needed
To configure push notifications for an external client app: Create, edit, and delete External Client Apps
  1. In App Store Connect, record your iOS app’s Bundle ID.
    To configure the required authentication for iOS push notifications, you submit either a private key (.p8 file) or a TLS certificate (.p12 file) in External Client App Manager. To configure a private key (.p8 file), continue to Step 2 and skip Step 3. To configure a TLS certificate (.p12 file), skip Step 2 and continue to Step 3.
  2. To configure push notifications with a private key (.p8 file), collect this information.
    1. Generate and download a private key (.p8 file) with Apple Push Notification service (APNs) enabled. See Create a private key to access a service in Apple Developer documentation.
    2. After you create the key, record the key identifier. See Get a key identifier in Apple Developer documentation.
    3. In the membership details of your Apple Developer account, record the Team ID.
  3. To configure push notifications with a TLS certificate (.p12 file), generate and export a TLS certificate with Apple Push Notification service (APNs) enabled. See Communicate with APNs using a TLS certificate in Apple Developer documentation.
  4. In External Client App Manager, create an external client app.
  5. Enable the OAuth plugin for the external client app. Enabling OAuth is required for sending push notifications.
  6. In the external client app’s settings, click Push Notification Settings to expand the section. Then, complete these fields.
    1. Select Enable Push.
    2. In the Mobile Platform field, select iOS.
    3. In the Environment field, select Production or Sandbox to indicate the Apple Push Notification service environment.
    4. In the App Bundle ID field, enter the Bundle ID that you recorded in Step 1.
    To configure a private key (.p8 file), continue to Step 7 and skip Step 8. To configure a TLS certificate (.p12 file), skip Step 7 and continue to Step 8.
  7. To configure push notifications with a private key (.p8 file), submit this information.
    1. In the Signing Key field, upload the key with APNs enabled that you downloaded in step 2.
    2. In the Key Identifier field, enter the key identifier that you recorded in step 2.
    3. In the Team ID field, enter the Team ID that you recorded in step 2.
  8. To configure push notifications with a TLS certificate (.p12 file), submit this information.
    1. In the Apple Push Notification Service Certificate field, upload the TLS certificate with APNs enabled that you exported in step 3.
    2. In the Certificate Password field, enter the password for the TLS certificate.
  9. Click Create.
  10. To optionally configure push notifications to display the full notification title and body text, update the external client app’s push notification policies.
    Note
    Note By default, standard notifications display a generic message and custom notifications display only the notification title.
    1. Return to the list of external client apps in External Client App Manager, and then click the external client app that you created.
    2. Click Push Notification Policies to expand the section.
    3. Select Display full content push notifications.
    4. Save your work.