Creating a Web Messenger

The Flow XO Web Messenger is a bot interface that can be embedded in any website, landing page or web app. It can be accessed through a website control, directly via it's own URL, or can be embedded within the body of a webpage.

Follow these steps to create a web messenger:

  1. In Flow XO, click Bots on the left menu bar, then choose + New.
  2. Now choose Web as the platform.
  3. Type in a descriptive name for the messenger.
  4. In the Welcome Text field, you can optionally provide some welcome text. If you leave this blank default welcome text will be used.
  5. Select the Language and enter a Custom Prompt Message as required. View the guide on International Language support for more information.
  6. Select if you want to Forget conversation history when the user closes the messenger. 
  7. Select if you want to Disable text input in the messenger. This removes the text composer and limits the user to the choices you've defined.
  8. You can change the Theme Color if you wish, which is the main color that will be used on the messenger window.
  9. Add an Icon if required.
  10. For Header Text, provide the text that you want to display on the widget label and as the title of the messenger control. You can leave it blank to use the default text, 'Message Us'.
  11. For Widget Popup Message, provide the text that you want to show up alongside the widget icon to attract your visitor's attention. (Shows after a short delay of 5 seconds, once every 30 days per visitor).
  12. Click Next to save your bot.
  13. The final step allows you to test the messenger (you'll see a test widget in the bottom right corner of the screen), and to copy and paste code to display on your website.
  14. Click Done to finish.

Installing the Web Messenger

The web messenger can be installed on your website, landing page or web app. The final step when creating/editing your web messenger will give you some code to display a control that opens the web messenger.

You should paste this code just before the closing </body> tag on your web page. The web messenger is designed not to slow down your page.

Welcoming a New User

When the user opens the web messenger for the first time, the message 'start' will be sent to it. You can look for the presence of this and welcome the user if you like.

Web Messenger API

You can control the web messenger from within the page using the Web Messenger API. This JavaScript API lets you open/close the messenger, send a message as the user, and receive events about the state of the messenger.


Does the web messenger maintain state?

The first time a unique visitor opens the messenger, a session is stored in their browser (they'll also see the bot's welcome message too, if configured). When they return to your site, they'll see all their message history. Select Forget conversation history when the user closes the messenger if you want to load the web messenger with an empty conversation at the start of the next session. This may be useful if your users share PCs, for exchanging confidential information or on compliance grounds. 

A Reset conversation option is also given to the user in the top right corner of the web messenger. This will clear all conversation content from the web messenger and will end the current conversation and restart it.

If you select the option to Disable text input in the messenger, then the the web messenger is loaded with an empty conversation at the start of each new session.

No option above deletes any data from the database. If the browser's storage is reset, the history will be lost.

What is the user's name and handle set to?

The web messenger is anonymous, and so the user name and user handle properties will be empty when you interact with a web visitor. You can always ask the user for their name.

Can the visitor send a file/location/image?

Yes, the visitor can send files and images. It's not possible to send a location just yet, sorry.

Can I broadcast to the web messenger?

Yes, the web messenger works like any other platform. If you broadcast to a web messenger user, the next time the user visits your site and opens the messenger, they'll see the message(s).

Is it possible to control how/when the messenger is displayed?

Yes, you can use the Web Messenger API to control the messenger from any page that it's installed on.

Can I send metadata?

Yes, either by using the Web Messenger API or by adding parameters to the query string when you use the web messenger's direct URL (for example, &foo=bar).

Metadata will be available inside the metadata output when you receive a new message through the bot.

Let us know how we can improve Flow XO on our feedback site.

Still need help? Contact Us Contact Us