Engagement
- Send personalised chat blasts to all its users
- Collect answers from your users
- Provide a richer user interface than text

A mass chat blast sent to all or a targeted segment of your users, based on their tags and attributes. Broadcasts are the chatbot version of email marketing.
A method of quickly and automatically collecting information from a large volume of your users. A form can be used to save qualitative answers and update user attributes. As a result, they allow you to create multiple customer segments.
A way to group and categorise information on the BotDistrikt platform. Tags can be currently used on Users, Cards, Documents, and Images. They are especially useful in the Filter Webhook.
A chat element that upon being clicked on by a User, performs a certain task. Buttons help to create a quicker chat flow with your bot, as users may just click buttons instead typing full text to interact with your bot. Buttons can do 4 things:
- URL - Visit a website URL
- Story - Start another Story
- Phone - Call a phone number
- Text - Send the text of the button as a message
They stack vertically, and your bot may display up to 3 buttons per stack. The elements that buttons attach to include
- a Text response
- a Card response
- a Video response
- an Audio response
- Persistent Menu

3 buttons attached to a Text Response
Buttons are permanently visible after they appear on your user's chat screen
A special type of Button that can only be attached to the bottom of a Story. A quick reply can do 5 things:
- Text - Send the text of the quick reply as a message
- Return - Similar to text, but shows a "❮" character to indicate "Back", like to a Web browser's "Back" button
- Location - Send the user's current location **
- User Email - Send the user's email **
- User Phone Number - Send the user's phone number **
They stack horizontally, can be side-scrolled, and your bot may display up to 10 quick replies per Story

2 quick replies attached to a Story
**limited to messaging apps that support them
Quick Replies are temporarily visible once they appear in your bot's response. When the user sends a message after seeing some quick replies, the quick replies disappear.
A text-based response in a Story. Text can have one or many variants. When a bot has to respond with text, it will randomly choose a text response from the text itself or its variants. Text can also have up to 3 buttons for a richer user interface.

A text response in a story
A card-based response in a Story. A card is a simple structured message that that includes
- a title
- a subtitle
- an image
- up to 3 buttons
A single response can have one or many cards, and they can be browsed with a side-scrolling carousel on most messaging apps. Cards are extremely useful to create a browsing experience in your chatbot - to browse your products, features, events, and more. Cards also have tags and can be filtered with the Filter Webhook.

A cards response in a story
An image-based response in a Story. The platform accepts PNGs, JPEGs, and GIFs. An image always has a name, and can be re-used in multiple stories by searching its name. Images also have tags and can be filtered with the Filter Webhook.

A image response in a story
Images have a maximum upload file size of 10 MB
A video-based response in a Story. The platform accepts MP4s, MOVs, and AVIs. A video always has a name, and can be re-used in multiple stories by searching its name.

A video response in a story
In some messaging apps, videos can also be presented in the form of a card with a title, subtitle, and up to 3 buttons.

A video response in a card format
Videos have a maximum upload file size of 20 MB
An audio-based response in a Story. The platform accepts MP3s and WAVs. An audio always has a name, and can be re-used in multiple stories by searching its name.

An audio response in a story
In some messaging apps, audios can also be presented in the form of a card with a title, subtitle, and up to 3 buttons.

An audio response in a card format
Audios have a maximum upload file size of 10 MB
A downloadable file response in a Story. Documents can be used to share digital files like PDFs, DOCs, PPTs, and XLSs from your bot. A document always has a name, and can be re-used in multiple stories by searching its name. Documents also have tags and can be filtered with the Filter Webhook.

A document response in a story
Documents have a maximum upload file size of 10 MB
A typing response in a Story. This is displayed as a typing indicator to the user in their own messaging app. Typing indicators are useful for when you want to control the speed of responses sent from the bot, especially when there is a lot of text information to be digested at once.

A typing response in a story
BotDistrikt automatically provides typing indicators for your bot when you connect a messaging app. You may use this Typing response for your own additional Typing indicators.
A sticker response in a Story. Stickers are limited to messaging apps which allow bots to share them. Each sticker is associated to an emoji, which are by similar to Telegram's emoji tooltips. Emojis are useful for when you want to send a certain sticker based on a certain emoji.
For messaging apps that do not support stickers, an Image is sent instead.

A sticker response in a story
BotDistrikt uses Facebook Messenger's preset stickers based on the emojis below
# | Emoji | Sticker | Description |
1 | 🙂 | ![]() | Smiley |
2 | 😝 | ![]() | Tongue out |
3 | 😄 | ![]() | Happy laugh |
4 | 😍 | ![]() | Heart eyes |
5 | 😂 | ![]() | Laugh with tears |
6 | 😥 | ![]() | Sad with sweat drop |
7 | 😕 | ![]() | Confused |
8 | 😭 | ![]() | Crying |
9 | 😱 | ![]() | Wide eyes scream |
10 | 😘 | ![]() | Kissy face |
11 | 🤩 | ![]() | Starry eyes |
12 | 😆 | ![]() | Closed eyes open mouth laugh |
13 | 😑 | ![]() | Expressionless |
14 | 😁 | ![]() | Showing teeth smile |
15 | 🤓 | ![]() | Glasses nerd |
16 | 😰 | ![]() | Distraught blue forehead |
Stickers are configured differently for the Telegram integration. A Sticker Pack URL has to be provided. A Telegram sticker is then selected from the sticker pack based on the Sticker Emoji, and if a sticker emoji is not provided, one is randomly picked from the pack

Telegram sticker pack configuration
If a User sends your Bot a sticker Message, the message will have 2 fields filled in. You may re-use these message fields as merge tags to send a response with the same sticker pack to the user. The fields are
Context | Field | Description |
message | sticker_emoji | The emoji of the sticker in the user's message |
message | sticker_set_name | The sticker pack username of the sticker in the user's message |
If you set a configuration like below

Telegram Sticker configuration re-using the sticker pack of the user's message
You can create an experience where the bot sends a sticker from the same pack to the user, thus creating a sense of personalisation and better engagement

Using the same sticker pack from the user's message
A bot's "main menu" that is always-on that can be set up under the Profile section in the Personality page. This menu is an easy way to help people discover and access the core functionality of your bot at any point in the conversation.

Setting the bot's persistent menu

How the persistent menu appears to a user
A bot's "main menu" quick replies that can be set up on the Personality page. Although these are not visible to the user at all times like the Persistent Menu, they are helpful for remembering the main-menu quick replies, and can be added with one click in a Story.

Setting up your Default Quick Replies

Using the Default Quick Replies in a Story
Last modified 1yr ago