Last updated 161 days ago

Steps

After creating your first flow, open it, click “Edit Flow”, have your bot side by side and here we go! 😆

Let’s take web chat as an example. Other flows share similar processes where the main difference is message type.

https://cdn.iframe.ly/vmGzje1

A few simple steps to send out your first message:

  • click the green start point
  • in the edit panel, “Select Next Step”
  • choose “Send Message” step
  • click the “Send Message” step
  • click text type message
  • enter your message
  • “Publish”

That’s it! Let’s test!

Click “Preview” from the navigation bar and “Open the flow”.

Preview Feature

Please note that “Preview” feature is not supported in all channels. Channels support “Preview”: Web chat, Instagram, Facebook, Telegram, WhatsApp, Line and Viber.

  • Preview in pop up: This opens a preview window in your flow builder
  • Open in web browser: Opens flow in a new web browser tab
  • Copy Ref Url: A unique shareable link to your flow

Congrats! Your bot is working now. 🤖🤖

Let me show you some more details about Send Message step. These are the message type in common for all/some of the Channels. Check by type below:

Insert Custom Field Value and Emoji

Wherever you see “</>”, you can insert emojis or variable values to the text.

Or simply type “{{” to call the field list:

Send Image / Audio / Video / File

There are multiple ways to send media type within a message:

  • upload from your computer (size limited)Media TypeMaximum Upload Sizevideo10MBaudio5MBfile5MBothers(e.g. image)2MB

Sending image files

  • Sending images from an URL link (RECOMMENDED)You can search pictures online and copy their direct URL links. But this direct link might change. Alternatively, you can upload photos to your server or other third-party photo storages like imgur.com, then get your direct URL links from that. Direct URL link means the link is pointing to a specific photo, not a website, ending with .jpg or .png, etc.
  • search from GIFs galleryWe provide you with a GIFs gallery, you can search what you need here.
  • from LibraryLibrary is the place you can see all the photos, GIFs, audios and videos you have uploaded before. So that you don’t need to re-upload the same media, just find them in your library.

Send Card

Card is used to display a serious of information nicely like product information. There are 4 elements in a card: Image, title, subtitle and button.

Please note that to show a card, you must have a title and at least one other factor, picture, subtitle or button.

Send “For Each”

This message type is also showing cards but in a more automatic way. With “For Each”, you don’t need to type in each card yourself. It automatically displays all items in a JSON variable. Check Action Step – What is JSON variable.

  1. 1.choose a JSON variable first
  2. 2.click “</>” or type “{{” in the text box
  3. 3.choose “ITEM” to get a sample item from the JSON variable

Value in the JSON variable:

Value in “ITEM”:

The “Sample data” is to quickly fill in the “JSON Path” field. For example, as shown in the picture, click the “price” row, and “$.price” appears in the “JSON Path” itself. This means that, we are displaying the price of each item here. If there is no sample data prompted, you can fill in the path yourself by typing “$.”, which refers to each item in the JSON variable, followed by the key of a value.

Value Format

Moreover, for numbers like percentage and price, for date value and time value, we have different formats listed for you. For example, in the above picture, the price value is “5” and after choosing a “F03” format, the bot will display it as “$5”. While the value in the variable is still the number “5” so that you are able to use it in math calculation or condition comparison without malfunction.

Hidden Keys

Apart from the keys in the JSON variable, there are 3 hidden key you might need:

Key NameDescription
INDEXindex of the item started from 1
KEYkey name of the item
VALUEvalue of the item = the item itself

INDEX Example

When you have a JSON with a list of JSONs in it, use INDEX for checking the sequence number of an item. Let’s add an index number before the item name:

Testing result:

KEY/VALUE Example

When you have a JSON as shown in the following picture instead of a JSON holding a list of JSONs,

These are what you will get by using the three keys:

Testing result:

Send SELECT after “For Each”

When you add a button to your “For Each”, the button is going to show with every card. Usually, you might want to put a “Buy” or “Select” button here in the case that you are listing some products or options.

How does the the bot know that which card did the user select?

When you select next step for the button, choose “Select”:

Then select a next step as you usually do, like a Send Message Step to show the selected item or Action Step to deal with the data. You can then access the selected item in “SELECT”:

For example, let’s add a Send Message step, find the system field “SELECT”:

  1. 1.click the row “item” to get the path “$.item” or type in the path directly
  2. 2.in the JSON path, add key name if needed. In this case, let’s show the name of the selected item. So add “.name” after the path.

You will see this when you test it:

Send Dynamic Content

Dynamic Content helps you send out an API request, to your server or a third-party server, in order to get a response to display. The server can reply differently each time. In this way, your bot is able to display dynamic content to your users.

This feature is practical when your bot logic is complex and rely heavily on other servers. For example, you have your own AI algorithm to analyze users’ questions and calculate corresponding response on your server, in this case, you can send the question in the API request. And the server can generate a response based on the question. Finally, the server sends the response back to the chatbot to display to your users.

A response message can contain several messages, buttons and quick replies with actions. You can even apply simple actions like add tag directly in the response JSON.

Send Location

To send a location, search it on a map, then right-click it to copy its latitude and longitude values:

Enter your location name, paste the data and add a label if needed. A label gives additional information like floor or room number.

Send Ecommerce Product

Check Ecommerce for how to setup and use built-in ecommerce system.

Facebook – Send Message

Facebook allows the bot to send texts with 3 buttons and 10 quick replies at most.

Send Text with Button & Quick Reply

The difference between button and quick reply on Facebook Messenger:

TypeUsage
buttononce sent, always in the conversation to be pressed
quick replysimilar to button, but disappear when used

Try to add some buttons, quick replies and test it. You will see their differences.

Telegram – Send Message

Telegram flow is our newly added flow type. It is similar to Facebook flow except for some exclusive features with Facebook. Text tutorial about Telegram flow will be updated shortly.

WeChat – Send Message

WeChat allows the bot to send texts with 10 buttons at most. Message type with WeChat:

Send Article

This is how it looks like in the chat:

Send Mini Program

You can also send mini-programs that associates with your official account.

WhatsApp – Send Message

Message types with WhatsApp:

Button in WhatsApp is a bit different from that in Facebook. A button in Facebook can be pressed for multiple times while in WhatsApp, only once.

SMS – Send Message

SMS bot can send only text and image.

Voice – Send Message

Send Text / Audio

You can have the bot read out the text with a specified language or record your own audio and upload it.

For voice bot, you can set a default language at the Green Start Point or set it separately for each send message/question step.

We have a Mini-App called “VoiceMaker” using a third party API which provides you with a better quality of text-to-voice conversion! Download the Mini-App in integration section.

Google My Business – Send Message

Message types with Google my business flow:

All types are covered above, please check message type in common for all/some of the channels. Find location type in “Rich Media”.

Was this article helpful to you? Yes 2 No 4

How can we help?