Messenger installation

Learn how to install the Messenger widget into your app to support your customers from where they are.

Provide frictionless support straight from your product, with Messenger. Aside from the live chat, Messenger allows your customers to view help articles, access changelog updates, submit feedback, and much more.

👨‍💻 This should take around 10 minutes to set up for an engineer. If you're uncomfortable with this, share this guide with a technical team member who can assist.

Installation

The widget can be installed using our JavaScript SDK. Here are some examples of popular JavaScript frameworks:

⚠️VERY IMPORTANT: To prevent user impersonation attacks and ensure the data provided can be trusted, we highly recommend securing your installation by following this guide →

Field descriptions

Here’s a list of all the main parameters you can include inside the boot function:

  • appId - (Required) Your Featurebase organization ID (not name), which can be found here.

  • email - User’s email address.

  • userId - The user’s unique ID in your application.

  • createdAt - When the user’s account was created.

  • theme - If the dark or light theme of the widget should be shown.

  • language - The language of the widget, you can check available languages from Localize Featurebase to work with multiple languages

Adding custom data about the user

You can include any custom data you want in the boot function as long as the required parameters are set.

This means you can add params like userPlan, userSubscriptionId, etc.. all in the same object. You can even add more complex nested parameters.

NB! To make sure custom attributes are added for users, please make sure to configure them by following this guide →

Leaving out user data

If you’d like to treat the communicating user as a lead instead, you can remove userHash and all other user identifying data.

Next steps

FAQ