Deskpro Messenger is supported on Web, iOS, and Android. This setup guide will walk you through installing Android deployments of the messenger widget.

Getting Started

First you’ll need to go Admin > Channels > Messenger (Beta). Once there, you’ll see a menu expand in the nav bar with options to go to Messengers, Chatflows, or Routing. To setup your first messenger, Click on Messengers.

To create a new messenger, click on the + New button

Setup Tab

Give your messenger a name, choose which platform you’d like to deploy it to (in this case, Android), and lastly, select the brand you wish this messenger to be used for. Once you’re done, click on Save and Continue Setup.

Once you click Save, you’ll see that you can select the messenger widget’s default language, as well as other languages you’d like to support through translations. Note: you will need to install Language packs in order to see them populated on this page.

Once you’ve configured the messenger widget’s language, click on the Messenger tab below the messenger’s name to continue setup.

Messenger Tab

The Messenger Tab allows you to configure which individual features you want to include in you widget. Each of the individual features you can add to a widget are called “Cards.”

When customizing your messenger widget, you have the option to choose whether you want a simpler approach to the widget with Messaging Only Mode, or whether you want a more feature rich experience through Card Mode.

The two modes Deskpro supports have the following use cases:

1. Messaging Only Mode: Allows customers to send and receive messages and view message history only.

2. Card Mode: Includes a home page, messaging, help content, news, and more.

Messaging Only Mode

There are two cards that can be configured in Messaging Only Mode.

1. Message card: Allows user to start a conversation with an agent

2. Message History card: Allows user to view and return to previous conversations with agents

Once cards have been added, then you will see a preview of your configured widget appear in the preview panel. Additionally, if you wish to disable a card, flip the toggle on the left of the card. If you wish to delete or rearrange a card, use the functions to the right of the card.

Card Mode

Card Mode allows you to have multiple tabs within your widget for different functions. With Card Mode, you can customize your widget with the following features:

1. Home Tab

   Here you can customize a central place on your widget that can contain help center content, news content, and messaging. You can also style the home page to match your branding by adding logos, background colours/images, and greeting messages.

2. Help Tab

   Here you can enable users to browse and read your Help Center content all within the widget itself. You can pin certain articles you wish to highlight, or pin Knowledgebase categories you know your users browse frequently.

3. News Tab

   The News Tab allows your users to browse and read your latest news content, whether it be release updates, announcements, or latest developments. News posts are ordered chronologically so you know the latest updates are in reach of your users.

Styling Tab

The styling tab provides you with the ability to customize your widget. In Messaging Only Mode, you can only set the action color, however in Card Mode (coming soon), you can customize your widget’s action color and home tab background with solid or gradient colors, background images, and icons.

Lastly, if you are on a Professional or Enterprise plan, then you have the option to remove the “Powered by Deskpro” branding footer. If you are on a Team plan, this setting is locked and cannot be changed.

Once you have configured your widget’s styling and positioning, you can click on the Launcher Tab to configure how your widget should look.

Launcher Tab

The launcher button allows user’s to hide and open the widget. However, it is completely customizable through the Android SDK. Check out our readme in our github repository to configure how you want your app’s launcher button to work

Deployment Tab

Messenger Installation Status

The Messenger Installation Status detects the first time your messenger has been deployed successfully to your Android app.

As soon as your messenger widget is opened wherever you’ve deployed it and Deskpro first detects it, the status will turn green to indicate you have had a successful install.

If it remains amber, then that means your widget is not connecting to Deskpro and there has been an issue with your installation. Please send us an email at support@deskpro.com if you have issues with your setup.

Deployment Options

Below the Messenger Installation Status you’ll see Deployment Options, which allows you to choose how you want to install messenger, using code snippets. We currently support Kotlin and Java deployments of the widget. Once you select your option, the corresponding code snippets will appear.

Once you choose your deployment option, follow the instructions on the page to install messenger on your Android app.

Note: Once your messenger has been deployed to your app, disabling or deleting it does not remove it from your app’s code. If you want to remove it completely from your app, you will need to manually remove the injected code from your code base.

Enable Push Notifications

For Android deployments of the widget, we support Firebase Cloud Messaging (managed through Google). We make it very easy to upload and integrate FCM into your messenger.

FCM

You will need to the following pre-requisites on hand to upload to Deskpro:

1. Download your google-services.json from Firebase

2. Project ID

3. App ID

Once you have gathered this information from Firebase, upload it into the appropriate fields under the FCM settings on the Deployment Tab.

JWT

Apart from specifying trusted domains, you can add an extra layer of security and require JWT authentication to use messenger.

If this is toggled ON, then a user must be authenticated via JWT. If they are not auth'd then they will be unable to access the messenger widget.

If it is toggled OFF, then there is no JWT required to use the widget.