Links

Engagement

User engagement is key to building product stickiness. Your bot can
  • Send personalised chat blasts to all its users
  • Collect answers from your users
  • Provide a richer user interface than text

Broadcast

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.

Form

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.

Tag

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.

Button

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

Quick Reply

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.

Text

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

Card

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

Image

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

Video

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

Audio

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

Document

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

Typing

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.

Sticker

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

Persistent Menu

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

Default Quick Replies

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