Chatbots for Health - User Documentation

Overview

Welcome

This help documentation is constantly updated, as soon as new elements are available. Feel free to contact us directly for any question. It will help us to improve this documentation.


Getting started

Bot properties

The bot properties are available from the dashboard with this menu: Bot settings from dashboard
and they are available from the bot from the top menu: Bot settings from dashboard

Bot builder

The bot builder can be looked at in three parts

  • Top horizontal menu
  • Vertical left bar containing all available elements and connectors
  • Main board on which draging elements

Element properties

When putted on the main board, you can specify information about each used element.
Elements are contained in a bloc. You can put one or several elements in a bloc.

The bloc has properties, accessible by clicking on the pen in each bloc title bar, where you can change the bloc name and the bloc color Bloc properties

Each element has specific properties you can access by clicking on the key in each element top right corner

Bot sharing

You can share a bot design in order to co-create it. You just have to go to the bot settings and specify the email address of the user you want to share the bot with Bot sharing

You can access a bot shared with you from the dashboard, at the end of your bot list, in the section named "Delegated chatbots list" Bot sharing


Bot connection

Facebook Messenger

SMS

Skype


Elements

System blocs

Default blocs

When you start to create a bot, 3 blocs are already shown & available:

  • Welcome bloc
  • This bloc is the one where the bot start when a user start the bot with facebook messenger. You can put whatever element you want into this bloc.

  • Default bloc
  • This bloc is the one where the bot fall back when it has an unexpected user interaction. You can put whatever element you want into this bloc.

  • Rating bloc
  • This bloc is standard. You can decide to use it or not, just link it into your process to use it.
    Using this bloc will allow to show a user satisfaction and, for instance, analyze the chat sessions that people didn't liked.
    You can only choose the langage used to ask the user about his experience. Rating bloc langage choice
    When you use this bloc in your process, the result is as follow Rating the bot in action

Text

The text element has the following properties: Rating bloc langage choice
You can specify the text the bot has to write in the "Card text" zone. You can add up to 3 buttons.

Image

The image element has the following properties: Rating bloc langage choice
You can put an image directly from an URL to be written int the "Paste image url" zone or from your computer by choosing a file after clicking in the "Or upload image" zone.

Title is optionnal and change the behavior:
  • Whithout title, the image will be show as is
  • With a title, the image will be cropped in a bloc having the title you specify

The list element has the following properties: Empty list or carousel element
You have to add 2 or more cards. It will not work with only one card.
You can choose 2 way of showing it into your bot: it can be a "List", meaning shown vertically, or a "Carousel", shown horizontally.

You have to add some cards by filling all the needed parameters for each one
Card list or carousel detail

Here is a result of this element showing 3 cards in a list format:
List example

Here is a result of this element showing 3 cards in a carousel format:
Carousel example

Video

Quick reply

In order to use a quick reply elment, you have to write a text (error message if this field is empty) and you can add as many buttons as you want. They will be shown as possible answers to the user. Quick reply parameters
In the builder, you see that this element has as connectors regarding each button plus one more choice to manage an "unexpected answer" Quick reply in the builder
Then, the bot show it like this to the user: Quick reply parameters
The link element is a connector allowing you separate one bloc in several and to linkk them whithout needing a user interaction
Link element in the builder

Email

Here are the setting for this element: Email element settings
  • From: this field is non modifiable
  • Reply to: this field is non modifiable. It is the bot creator email.
  • To, subject & body: these fields are to be set according to your specific needs

API generic connector

This element allows you to make your bot make an external API call. Parameters are like this:
Email element settings
Some fields are compulsory:
  • Method: four API call methods are available: POST, GET, PUT & DELETE
  • Variable: there, you have to name a variable storing the result of your API call in order to use this result into the bot behavior
  • URL: the API call URL
Some fields are optionnal depending on your needs: you can fill Headers and Body fields

Variable

Computed variable

This element allows you to compute a variable in order to use it later. Parameters are like this:
Computed variable element settings
You have to fill the "Computed variable name" field which will store the result of the operation.
The expression can be a computation like "1 + {{age}}" or a text concatenation like "Welcome {{name}}, at {{age}} you're still young".
The default field will be used to fill the variable if the expression is not understandable.

Condition

Random

Schedule

This documentation will be updated frequently according to new elements and evolution