Groups

What is a group?

A group is an element of the structure that allows for the categorization of blocks, similar to folders and files. Use groups to aggregate blocks related to the same topic, time of year, or containing the same type of response.

Creating a group

To create a group, click the “Add Group” button located at the very top or bottom of the block list. The new group will appear either as the first or last item on the list, respectively.

When a new group is created, you can add new or existing blocks to it.

Group names should be understandable to you and other platform users. You can use emojis to better describe what each group represents.

Managing existing groups

Moving a group

The order of groups is important for navigation in the dashboard and working with the bot, but it does not affect the order in which blocks are displayed to the end user. You can change the order of groups by hovering over the group name, clicking the arrows that appear to its left, and dragging it to a new position.

The most popular order of groups is: welcome, menu, thematic groups according to the order of categories in the menu, FAQ, default responses.

Changing group name

To change the name of a group, simply click on it. This will activate the name edit field. To apply the change, click anywhere outside the group name.

Copying the groups

You can duplicate a group along with its contents. To do this, click on the three dots on the right side of the group name and select the appropriate option. Duplication includes the group name and all blocks contained within it.

Exporting the group

You can export a group to your chosen file format (.csv or .json) by clicking on the three dots on the right side of the group name and selecting the appropriate option.

The file will be saved in the “Downloads” folder or another location specified in your browser settings.

Export to .csv file

The .csv file contains data including:

• Block IDs within the group,
• Group name,
• Block name,
• Block elements,
• Specific information related to individual block elements (e.g., descriptions of buttons below the message).

Export to .json file

The .json file contains more detailed data compared to the .csv file:

• Block IDs within the group,
• Block name,
• IDs of elements used within each block,
• Specific information related to individual block elements (e.g., descriptions of buttons below the message).

Importing group from .json file

To import a group into the structure, click on the three dots to the right of the STRUCTURE label located in the top left corner of the screen. Then select or drag and drop the chosen .json file. If the group contains references to blocks outside it, an additional block containing an emoji will be created. If you want to skip this step, simply add the following parameter to the file:

disable_temporary_redirects: true

Deleting the group

To delete a group, click on the three dots on the right side of the group name and select the option “Delete group”. Remember that deleting the group will also delete all blocks assigned to that group, which can negatively impact the bot’s functionality. To avoid this, ensure that the group is empty or that the blocks within it are not linked to other blocks in the bot configuration.