Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Setting up Mobile Messaging SDK connection

Updated on April 11, 2023

Digital Messaging Manager of your Digital Messaging interface includes two mobile messaging channels for Android and iOS. You can add the Android or iOS mobile apps as connections to integrate them into your native mobile app.

Pega Customer Service Implementation Guide Pega Customer Service Implementation Guide

The following figure shows the Mobile Messaging SDK connection that you can configure in Digital Messaging Manager:

Note: The following image displays the UI of Digital Messaging Manager for the 8.7.2 version. In the 8.7 version, you had to create separate connections for iOS and Android apps.
Multiple channel connections
Multiple channel connections

Creating a Mobile app connection

Add a mobile app connection in your Digital Messaging interface, and then configure the general, security, context data, and push notification settings. After you configure the settings, download the iOS and Android SDKs to integrate into your application. By doing so, Mobile Messaging SDK helps you embed Web Messaging in your native Mobile app.

Before you begin: Add a channel connection. For more information, see Adding a social messaging channel connection.
Note: From the 8.7.2 version, you can download the iOS and Android SDKs from the same Mobile Messaging SDK connection, instead of creating two distinct connections.
  1. On the General tab, in the Name field, enter the name for the Android App Messaging connection.
  2. Click Save.
    Result: The system displays the connection name and the additional tabs.
  3. To configure the chat context data to display to the CSRs, on the Context data tab, in the General information section, select the context data that you want to capture, and then click Save:
    Context data optionDescription
    IP addressThe IP address of the mobile device
    LocationThe physical location of the mobile device based on IP address
    Device/OSThe mobile operating system and device type
    Note: You can display the context data to CSRs with no configuration in SDK.
  4. On the Security tab, perform the following actions:
    1. To display the conversation history to the authenticated customers, in the Conversation history section, select the Show previous interactions to authenticated customers check box.
      Note: The Conversation history section is available from the 8.7.2 version.
    2. To view the token, on the Security tab, in the JWT Secret section, click Show JWT Secret.
    You can use JWT API token to sign requests when the Digital Messaging service and your Android app communicate.
  5. On the Installation tab, in the Mobile SDK section, perform the following steps:
    1. Copy the generated values for Api id and Api url to a local file or the clipboard.
      You later specify these values in the Java code for Mobile app.
    2. Download Pega Mobile Messaging SDK for iOS to your computer by clicking Download iOS SDK.
    3. Download Pega Mobile Messaging SDK for Android to your computer by clicking Download Android SDK.
  6. On the Push notifications tab, perform the following steps:
    1. In the URL field, enter the webhook URL for your Android App that can receive messages when the user is away from the app, and then click Save.

      SDK does not send push notifications directly to the device.

    2. In the Custom headers section, in the Header key field, enter a header key.
    3. In the Header value field, enter a header value.
    4. Click Add.
    5. To add more headers, repeat steps 6.b through 6.d.
What to do next:
  • Download the Mobile Messaging SDK for iOS from step 5b, and then configure it in the Xcode project.

  • Download the Pega Mobile Messaging SDK for Android from step 5c, and then configure it in Android Studio for your Android app project.


Pega Customer Service 8.7 Pega Customer Service for Communications 8.7 Pega Customer Service for Financial Services 8.7 Pega Customer Service for Healthcare 8.7 Pega Customer Service for Insurance 8.7

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us