# Flow builder overview

This section will give you an overall idea about how to use the chatbot flow builder. You can open a flow and try side by side when you learn it.

IMPORTANT

{% hint style="info" %}
💁 Please make sure you go through every detail on this page before you start building bots.
{% endhint %}

### Flow, Sub Flow and Step <a href="#flow-sub-flow-and-step" id="flow-sub-flow-and-step"></a>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FPiUSfo9A6RyCixrbKLvy%2Fflow.0a01bdf5.png?alt=media&#x26;token=0af12f0e-4477-40ec-a7cf-a5dedd6c1315" alt=""><figcaption></figcaption></figure>

### Flow Type <a href="#flow-type" id="flow-type"></a>

To begin with, you need to create a **flow**. Currently, Flochat provides you with 11 types of flow:

<img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FEIgY2GVhiYkgk1GphtRA%2Fflow_type.6ebfa00c.png?alt=media&#x26;token=64dfa29c-94b1-4246-8cf4-82a1733c7979" alt="" data-size="original">

### Sub Flow Type <a href="#sub-flow-type" id="sub-flow-type"></a>

Flow consists of **sub flows**. There are 3 types of sub flow:

| Sub Flow                                                                                                                                                                                                                       | Usage                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| ![](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FZ6YJzCjo2ScwjRrrfu3a%2Fdownload%20\(4\).png?alt=media\&token=a2de2892-8ac2-46cf-ad53-cf7aff0ed9d2) | general sub flow, varies in flow type |
| ![](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FNH0nuWi1uiU4RLIQMFCd%2Fdownload%20\(5\).png?alt=media\&token=663eb999-c5d0-43fe-a5ca-d78cccc25406) | call / trigger background tasks       |
| ![](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2F3pWKh6p47QjlYSXUV4GT%2Fdownload%20\(6\).png?alt=media\&token=5391bd11-04ed-4774-b825-2006aa6e4f28) | process repetitive tasks              |

### Step Type <a href="#step-type" id="step-type"></a>

Sub Flow consists of **steps**. There are 8 types of steps:

| Step                                                                                                                                                                                                                                | Usage                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FzMZYgyifPyGCUHbKUe4s%2Fdownload%20\(3\).png?alt=media\&token=e4210a3a-272c-41a6-b024-f72df4055e31)  | display information                                             |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2F3Hh6pIKnPxTdUPNBJDw7%2Fdownload%20\(7\).png?alt=media\&token=bb42b771-239d-4656-ac23-e2c2a261277a)  | ask question and wait for user input                            |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FBtk612gmd8IMc2YugxOY%2Fdownload%20\(8\).png?alt=media\&token=d624f768-2f2d-4c63-b55b-1130533c18d4)  | process data and tasks via integrations, APIs, notifications... |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2F2kzLYXMDZlLb1RVpraqQ%2Fdownload%20\(9\).png?alt=media\&token=c97002fb-ebfc-4cd7-a24f-9e54333f303c)  | go different steps depend on conditions                         |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FGg7M6yLKjISSG5r7Kepy%2Fdownload%20\(10\).png?alt=media\&token=2641ad8f-c55a-449b-85de-150867e2fbe3) | go different steps depend on probability                        |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FrCBlxRXkh4TIm6yUKGK0%2Fdownload%20\(11\).png?alt=media\&token=d14c94a1-4ece-4846-842c-28e7744f8e59) | send full email instead of short email notification             |
| ![step](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FTdSbdXuNIB43v6abMnGj%2Fdownload%20\(12\).png?alt=media\&token=83d03fea-4a84-4903-9f8a-cea0d17d8cca) | jump to a step or sub flow rather than using a line connector   |
| ![](https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FTQ4V6kOt9zT7tN8RyQ2C%2Fdownload%20\(13\).png?alt=media\&token=815b89e5-3eb9-4c7f-a1d4-1146a686e453)     | define output for the function flow                             |

{% hint style="info" %}
The differences among different types of flow are **Flow Setup**, **Send Message Step** and **Question Step**. Each channel has its own limitation of message types. For example, you can display a product gallery in Facebook Messenger while the SMS channel doesn't support that.
{% endhint %}

### Publish Version & Draft Version <a href="#publish-version-draft-version" id="publish-version-draft-version"></a>

Each flow has a Publish Version and a Draft Version.

* Publish Version

  > Your bot talks to clients using the publish version.
* Draft Version

  > Any editing of steps will be saved automatically to the draft version. you can edit your flow without influencing the bot and test the draft version before you "Publish".

#### From **Publish Version** to **Draft Version**, 1 way: <a href="#from-publish-version-to-draft-version-1-way" id="from-publish-version-to-draft-version-1-way"></a>

* click "Edit Flow" on the upper left/right corner of the flow to enter the draft version

<div align="left"><figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FMYFOlzjLoQ6sk40CAHfg%2FCapture.PNG?alt=media&#x26;token=44f361cc-9856-4a07-b1b0-dc5863a1c49a" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
You must enter Draft Version before you edit a flow.
{% endhint %}

#### From **Draft Version** to **Publish Version**, 3 ways: <a href="#from-draft-version-to-publish-version-3-ways" id="from-draft-version-to-publish-version-3-ways"></a>

* click "Publish" to save your draft to a new Publish Version
* discard changes and revert to the newest Publish Version
* keep draft and switch to Publish Version (by doing this, you can have a look at your publish version and when you click edit and come back, your draft is still here)

<div align="left"><figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FqYZHM0gDTXrgShbUGAZ3%2Ftempsnip.png?alt=media&#x26;token=22782eca-85f1-4d7d-b690-2a948133f1d1" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Don't worry if you accidentally quit during your editing, the system will keep all your modifications in Draft Version. So when you come back, simply enter Draft Version again and you can see your modifications remain intact.
{% endhint %}

{% hint style="success" %}
**TIP**

You might want to create a flow first, then open the flow side by side when you read the following instruction.
{% endhint %}

After entering a flow, this is what you will see:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FGP3Wjd02ZgzM1nrbJhmk%2Ftempsnip%20(7).png?alt=media&#x26;token=ac19fec7-768d-40a4-af89-fd3c50560bbc" alt=""><figcaption></figcaption></figure>

### Preview Feature

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FLSfG9DOI7BjCeMIHXFRz%2FCapture.PNG?alt=media&#x26;token=786018e1-76f3-4eac-a22b-0ceae262c007" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please note that "Preview" feature is not supported in all channels. Channels support "Preview": Web, Facebook, Instagram, Telegram, WhatsApp, Line and Viber.
{% endhint %}

On the left-hand side, there is a sidebar. From top to bottom there are:

| Section      | Usage                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Flow Builder | build subflows here                                                                                                                   |
| Flows        | manage all your subflows                                                                                                              |
| Analytics    | bot data analysis                                                                                                                     |
| Live Chat    | inbox for all the conversations, make a human reply here                                                                              |
| Bot Users    | manage bot user profile. import, export, search or delete bot users                                                                   |
| Automation   | manage keywords, sequences, triggers and comments                                                                                     |
| Contents     | manage custom fields, tags, OTN, personas, user menus and customer feedback                                                           |
| Tools        | manage error logs, draft version tester, bot admins, widgets, multiple language and shortcuts, Facebook Ads, inbound webhooks         |
| Broadcasts   | send/manage broadcasts                                                                                                                |
| Settings     | (some are owner only) manage bot users limit, Facebook greeting text, chat widget customization, ice breakers and authorized websites |

{% hint style="info" %}
Features in Automation, Contents, Tools and Settings can be different from channel to channel. In Settings, usually owner can see all the settings like bot user limit while admin and member only see part of them.
{% endhint %}

### Flow Builder <a href="#flow-builder" id="flow-builder"></a>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FQ7qUq3FWXHGbcnPZPf5y%2Ftip1.a27dedcc.gif?alt=media&#x26;token=e62c0743-735e-4fe3-88d7-af0ffbfe0491" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FvwFsCOANjLRzQkkRcr9g%2Ftip2.a057f4cb.gif?alt=media&#x26;token=d506b2ce-cfe0-4fdb-b714-01ffaa3478c3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fan51O1fuemimzGfwunYT%2Ftip3.69bd3943.gif?alt=media&#x26;token=6097bd08-f2fb-4f4d-b7e9-393850e737ce" alt=""><figcaption></figcaption></figure>

### Change Themes <a href="#change-themes" id="change-themes"></a>

Before you start, you can pick your favourite theme by clicking "Change Theme":

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fk9bRJtyqCxG8j52m6ddZ%2Fdownload%20(38).png?alt=media&#x26;token=6aabf7df-0f52-4a9a-9703-b06465e7ed91" alt=""><figcaption></figcaption></figure>

choose one of them and "Apply Change".

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FzlgFtyLOOy4OiM5SnmCp%2FCapture.PNG?alt=media&#x26;token=c763d883-fbe0-484e-ae5c-375010236e2e" alt=""><figcaption></figcaption></figure>

### Available Themes

PS:JelllyBean is the most popular 🤗

{% tabs %}
{% tab title="IceCream" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fn464B3RRzjSCNtw9iDO0%2FCapture.PNG?alt=media&#x26;token=7e8d9881-7260-4d03-aada-ffdd24f93f30" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Honeycomb" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FZN88MzTMbFoWDswprzKR%2FCapture.PNG?alt=media&#x26;token=295c0113-9556-44bd-8cde-b20a383557fa" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="GingerBread" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fv7bd2QUpY1NkztDaB1lS%2FCapture.PNG?alt=media&#x26;token=f030f36b-df6e-4a5c-b16f-a291c9fcb5fc" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Froyo" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2F04HYAcmKftr9avCy8MwW%2FCapture.PNG?alt=media&#x26;token=860fc343-c3d7-4db6-8a8d-452e41320242" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Eclair" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FlEjQ6mYu7qs3PQ6uFSSk%2FCapture.PNG?alt=media&#x26;token=3944cf0b-8321-44f9-82e4-cf72171fe5df" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Donut" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FjOMqMFbcDyOABptIRwvH%2FCapture.PNG?alt=media&#x26;token=2b888005-0faf-4a7c-8efc-90a491616130" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="CupCake" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FfBD0XJMzS9FkYw0Shqq1%2FCapture.PNG?alt=media&#x26;token=569a18e2-9059-4550-8a03-b4518b0c08c8" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Banana" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FpNGRorqTCgXkAr82RSCM%2FCapture.PNG?alt=media&#x26;token=d5209dba-b96a-4b53-8d2d-34c0c67fe888" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Apple" %}

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Frlfp513DOszu2UTdrrly%2FCapture.PNG?alt=media&#x26;token=3d40e94f-3386-4215-b10b-a5ad26155831" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Hide Mini-map or Tooltips <a href="#hide-mini-map-or-tooltips" id="hide-mini-map-or-tooltips"></a>

<div align="left"><figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fp9b6cX8lgYYMf3aHzvyP%2Fchange_theme3.369d6b4b.png?alt=media&#x26;token=bf665d28-9fea-491d-8e1e-382fa89855a9" alt=""><figcaption></figcaption></figure></div>

With tooltip, you can see description for every feature you see in the flow builder like this:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FOncr9rFNeiSrIc6LTlsj%2Fchange_theme4.7c9fcd6b.png?alt=media&#x26;token=9d862d8a-16b6-4ec4-a167-9ef3b69d9c2b" alt=""><figcaption></figcaption></figure>

The tooltip includes a title, description, image, video link and documentation link. It is friendly to new users. For users who are already familiar with the system, you can choose to disable the tooltip by clicking the "Hide Flow Tooltips" option.

### Basic Operations to Build Flows <a href="#basic-operations-to-build-flows" id="basic-operations-to-build-flows"></a>

#### Edit Step: <a href="#edit-step" id="edit-step"></a>

Click on a step to edit it, "Edit Panel" will show next to the sidebar.

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FRbfDSJ5wpLezqZbDPXPS%2Fworkspace1.f2c327b9.png?alt=media&#x26;token=bff56e83-d110-44ee-ae94-d6bc686d6cb0" alt=""><figcaption></figcaption></figure>

Click step name to edit it. You can choose the next step at the bottom of the edit panel or drag connectors from the circle to the tile of another step.

### Connect Steps: <a href="#connect-steps" id="connect-steps"></a>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FLtQkRPpxxIFwDIJId5jP%2Fworkspace2.7ae21c04.png?alt=media&#x26;token=4a688278-aea4-43e3-bf57-fd6a66ea17cf" alt=""><figcaption></figcaption></figure>

Create a new step or choose an existing one to be the next step. For dragging connectors, see below:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FsIvujLGfvuruK0kSntrj%2Fconnect_step1.83458edd.gif?alt=media&#x26;token=0dfb71a0-51e8-493f-aad8-81db1d5f9e26" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FJwowMhAG7YB6BFLjsbhL%2Fconnect_step2.f19da962.gif?alt=media&#x26;token=75059f43-7d6b-4c53-89f7-8804714013de" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
When you choose an existing next step, a line will be connected from the current step to the next. Too many lines can be messy, get a Goto step to help you organize! In a Goto step, you can nominate the next step without creating a line connector.
{% endhint %}

### Select Multiple Steps (Move to Canvas/Sub Flow) <a href="#select-multiple-steps-move-to-canvas-sub-flow" id="select-multiple-steps-move-to-canvas-sub-flow"></a>

We've just learned how to move the builder by clicking and dragging. For selecting multiple steps, it's a bit similar. Hold the **Shift** key then click and drag to cover the steps you would like to select:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FJ0UdXoxWdReci44lSJWt%2Fselect_steps1.aa273864.gif?alt=media&#x26;token=e3395ab9-a676-4442-99a9-683dd69d9bc2" alt=""><figcaption></figcaption></figure>

Alternatively, ctrl + click them one by one:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2FXU1cTYlQ2DddI7rSF6TY%2Fselect_steps2.0b0ad2ad.gif?alt=media&#x26;token=7d7705cb-777a-44c3-b7a2-2088bb7cd4d0" alt=""><figcaption></figcaption></figure>

The selected step has a green border. After selecting multiple steps, click "Create New Canvas" to organize these steps in a canvas box, or move them to an existing sub flow. To **delete** multiple steps, hit the "delete" button on your keyboard after choosing several steps:

<figure><img src="https://2836971782-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRaLazqQDW4JMiGe2iyKg%2Fuploads%2Fk5wxhnhfwlSHBDPrMLsP%2Fdelete_steps.9455f5d0.gif?alt=media&#x26;token=e6a39932-357f-402b-86a2-990d8b9eba24" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Delete on Mac**

On Mac OS computer, hold **fn** and hit **Delete** to remove steps. Or use the "**Delete Selected** button in the editing panel.
{% endhint %}

{% hint style="success" %}
The green start point is the entrance of a sub flow. It can't be moved to other sub flows or deleted even you include it in a group of steps.
{% endhint %}

### Copy and Paste Steps <a href="#copy-and-paste-steps" id="copy-and-paste-steps"></a>

After you select a step or multiple steps, use **Ctrl + C** to copy and **Ctrl + V** to paste it to:

* the same subflow
* different subflows in the same bot/flow
* different bots/flows but the same channels (associate custom fields will be created automatically)
* different channels (unsupported features will be removed)

{% hint style="info" %}
Please note that you can only paste ONCE. Copy again for another paste. This is to prevent bulk pasting which can quickly blow up the flow.
{% endhint %}

That's all about it for Flow Builder Overview!! 🎉 Try building your first flow now. 😎
