Links

Bot Essentials

Gallabox Interface

Our Bot Builder is the heart of the app, where you can create and customize your chatbot to take conversations to the next level. Let's take a closer look at the interface.
Bot Interface

Auto grid alignment

Grid Alignment in Bot Interface
  1. 1.
    '+' (Zoom In): This feature allows you to zoom in on the content displayed on the screen. Useful for focusing on specific details or elements within the content, especially in situations where there's a need for a closer view.
  2. 2.
    '-' (Zoom Out): This feature allows you to zoom out, providing a broader view of the content on the screen. Helpful for getting an overview of the entire canvas or content, especially when you want to see a larger portion of the information.
  3. 3.
    '[ ]' (Fit to Screen View): This feature adjusts the view to fit the entire content within the screen. Useful when you want to quickly see the entirety of the canvas or content without manually adjusting the zoom level.
  4. 4.
    Lock (Enable View-Only Mode): This feature locks the interactive elements on the canvas, preventing the movement of cards or objects. It is particularly helpful when you want to present information without the risk of accidentally moving or modifying the content. This feature is ideal for a view-only or presentation mode.
  5. 5.
    Beautify Flow: This feature automatically rearranges the cards or elements on the canvas to improve readability and maintain a logical flow. The purpose is to enhance the visual presentation of the content, making it more easier to comprehend.

Side panel

The Side panel contains all the blocks you can use to build your bot. To hide or show the Side panel, you just have to click on this arrow:
The Side panel has 5 categories - Send Text, Ask Questions, Actions, Utilities, and Connections. For a quicker way to select a card or node, just start typing the name of the card and it will show:
Side panel in Bot Interface

Test Bot

This feature will let you test the bot on WhatsApp before publishing it. All you have to do is enter your number and then click on Test.
Test Bot Button in Bot Interface

Publish

Every time you make a new change inside your bot, you will need to Publish the bot so it updates. It's very important you remember to do this when you're testing your bot.
Publish Button in Bot Interface

What is a Variable?

In Gallabox bot, a variable is like a digital box where we store all your customer's answers from your questions. Imagine it as a labeled container where we keep different kinds of information.
For example, when you ask a question in the bot, and someone answers, that answer is saved in a variable.
Here are some examples of how you can use variables for your Gallabox chatbot:
  • Store the customer's name so that you can address them by name.
  • Store the customer's email address so that you can send them a confirmation email after the conversation.
  • Store the customer's interests so that you can recommend products or services that they might be interested in.

Format of Variables available in Gallabox

Variables come in different formats based on the kind of information they store. Here are some formats:
  1. 1.
    String (Text): The most flexible type, perfect for storing text, numbers, emojis, hyperlinks, and more.
  2. 2.
    Number: Reserved strictly for numbers; no symbols or letters allowed.
  3. 3.
    Date: Ideal for storing dates within the variables.
  4. 4.
    Array: An advanced feature for developers, allowing the storage of multiple elements of the same data type, such as strings or numbers.
  5. 5.
    Object: A sophisticated container for holding structured data with multiple pieces of information.
  6. 6.
    Boolean: While you can't create or save variables in this type, it's used in Condition blocks to check if agents are online.
Variables in Gallabox

Creating Variables

The value inside a variable changes based on the answers given by users or choices made in the bot flow.
To create a variable inside a Card in Gallabox:
  1. 1.
    Choose a card and scroll down to the "Store response in the variable" field.
  2. 2.
    Name the variable whatever you want, but note it should start with alphabet; Cannot have special characters except underscore (_).
  3. 3.
    Click on create.
Creating Variables in Gallabox
The Name you assign to your variable should be descriptive and understandable to use.
Example - 1
If you have asked your customer for their name, you can save it in the variable "name".
Scroll to "Store response in the variable" in the Ask Text Card, type the name of the variable and then click on create.
Variable to store customer's name
Example - 2
If you have asked your customer for their phone number, you can save it in the variable "phone".
Scroll to "Store response in the variable" in Ask Phone Card, type the name of the variable and then click on create.
Variable to store customer's phone number
The variable name cannot have special characters except underscore (_).

Deleting Variables

To create a variable inside a Card in Gallabox:
  1. 1.
    Choose a card and scroll down to the "Store response in the variable" field.
  2. 2.
    Click on the variable, and hover on the delete button for the variable you would like to delete.
  3. 3.
    Click on Delete on the pop-up confirming if you really want to delete a variable.
Deleting variables
This will delete the variable from the Card. However, if a variable is used in flow A which is connected to another flow B via Jump to card, then the variable will be displayed in the flow B also to use it.

Validation Settings for Cards

Validation settings play a crucial role in ensuring the accuracy of data captured in a BotFlow. These settings help define how Gallabox Bot handles user input and responds to various scenarios during interactions with the bot.

Core Validation Settings

  1. 1.
    Attempt: Specifies the number of attempts allowed for a user to provide valid input.
Attempt count in Core Validation settings
  1. 2.
    Validation Error Message: Optional field to enter a custom error message displayed when user input fails validation.
Validation Error Message
  1. 3.
    Action on Invalid Response: Defines the action to be taken when the user provides invalid input.
Actions to be taken in case of an invalid Response

Additional Validation Settings

  1. 1.
    Minimum Range: Specifies the minimum numeric value considered valid.
  2. 2.
    Maximum Range: Specifies the maximum numeric value considered valid.
  3. 3.
    Regex (Regular Expression): Regex stands for regular expression. It is a way to describe patterns in text. Regex uses special characters to describe patterns.
For example, the regular expression \d{10} matches any 10-digit phone number.
The \d character matches any digit, and the {10} character asks to match the preceding character 10 times.
Here are some examples of regex patterns:
  1. 1.
    \d{3}-\d{3}-\d{4} matches any phone number in the format ###-###-####.
  2. 2.
    [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-z]{2,} matches any email address in the format @.
  3. 3.
    ^https?:// matches any URL that starts with the http or https protocol.
Additional Validation Settings for Bot Cards
Last modified 1mo ago