Skip to main content

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

Setting up the IVA for Android app messaging

Updated on March 23, 2022

Enable users to interact with Pega Intelligent Virtual Assistant™ (IVA) from a native Android app by using Pega Mobile Messaging SDK. As a result, you make your mobile app user experience seamless and more interactive.

For example, users can use your Android app to quickly interact with a chatbot that provides support for a financial organization, helping them to resolve issues with loan applications.
Before you begin:
You access Digital Messaging Manager in the Digital Messaging channel to configure individual messaging accounts from one place for your application.

If your security team requires JSON Web Token (JWT) authentication for communication between your IVA for Digital Messaging and social messaging platforms, you can configure this alternative security method for your channel. JWT authentication is an industry-standard method that permits the sender to sign a request with a unique token that the receiver later verifies to ensure that the obtained request is valid and that the token did not expire.

Note: After you update Pega Platform or Pega Customer Service, to use the latest Digital Messaging Manager features, save your existing Digital Messaging channel.
  1. In the navigation pane of App Studio, click Channels.
  2. In the Current channel interfaces section, click the icon that represents your existing Digital Messaging channel.
  3. In the Digital Messaging channel, click the Connection tab.
  4. Click Manage connections.
  5. In the Digital Messaging Manager window, click Add Connection, and then click the Android App Messaging icon.
  6. On the General tab, in the Name field, enter a name for the Android App Messaging connection.
  7. Click Save.
  8. Optional: To configure the chat context data to display to CSRs when they interact with users:
    1. Click the Context data tab.
    2. In the General information section, select the context data to capture during interaction with a user:
      Context dataDescription
      IP addressThe IP address of the mobile device.
      LocationThe physical location of the mobile device based on GPS settings.
      Device/OSThe mobile operating system and device type.
    3. Click Save.
  9. Optional: To configure security options for Android app messaging:
    1. Click the Security tab.
    2. Optional: To sign requests during communication between IVA for Digital Messaging and your Android app, in the JWT Secret section, click Show JWT Secret, and then use this key for your token during JWT authentication.
      You select the JWT authentication method for the Digital Messaging channel in the application rule. For more information, see Configuring Digital Messaging channel security.
  10. Click the Installation tab.
  11. Copy the generated values for Api id and Api url to a file.
  12. Click Download Android SDK to download Pega Mobile Messaging SDK for Android to your computer.
    Pega Mobile Messaging SDK helps you embed web messaging in your native Android app.
    For example: The following figure shows the installation settings for an Android app messaging connection in Digital Messaging Manager:
    Installation tab settings for an Android app messaging connection in a Digital Messaging channel.
    The configuration settings for an Android app messaging connection on the Installation tab.
  13. Optional: To configure the ability to receive messages in your Android app when a user is away:
    Note: Pega Mobile Messaging SDK for Android does not send push notifications directly to devices.
    1. Click the Push notifications tab.
    2. In the URL field, enter the Webhook URL for your Android app.
    3. In the Custom headers section, in the Header key field, enter a header key.
    4. In the Header value field, enter a header value.
    5. Click Add.
    6. To add more headers, repeat steps 13.c through 13.e.
What to do next: In Android Studio, prepare your native Android app for messaging with the chatbot:
  • Set up the Pega Mobile Messaging SDK that you downloaded in step 12 for Android app development.
  • Add custom Java code that uses Pega Mobile Messaging SDK in your Android app project, including the Api id and Api url values from step 11.
  • Build your Android app.
For more information, see Mobile Messaging SDK configuration in your Android app project.

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