A brief introduction to feedback

DEFINITION:
The feedback feature and forms creation allows administrators of bots created with @MenuBuilderBot to ask users a various questions, receiving answers in a form of a chat, as well as collect both text and media content data. The functionality allows you to respond to users both from the bot itself, where the Form with questions was created, and from the group where bot can redirect the user's answers. Text data can be saved in variables, viewed in spreadsheets such as Excel, sent, or duplicate accumulated in variables data to Telegram chats using Actions.

The Feedback function in MenuBuilderBot is natively integrated into the menu creation functionality. Feedback forms are created through buttons and messages.

A form, in fact, is a button with a set of messages and questions in it. In general, message of the button where form is created, will represent a separate "Question". The questions of the Form can be interleaved with regular messages. Regular messages will be shown to the user, but will not be sent to the admin when the data of the form is submitted. Regular messages in the form are used to display explanations and other information that is needed by the user and NOT needed by the admin. Form questions and messages will be shown to the user in a sequence from the top to the bottom. The transition to the next question is only possible after the answer to the previous one.

IMPORTANT:
Form cannot be added in "Main Menu" (in the root) of the bot.

❖ Question Types, Features and Settings

DEFINITION:
The question (in the context of feedback forms creation) is a separate "field" where the user should enter or forward the data requested. There are several types of Questions. The type of question determines the type of data received and is selected depending on what data and in what form you need to receive from the user. Depending on the type of data, they can be written to variables or only sent to the admins chat (for example, a picture cannot be directly stored in a variable).

ADVICE:
With the default settings of answering the question, your user can press "Cancel", thereby interrupting the filling of the form. The "Cancel" button in some types of questions can be hidden - not giving your user the opportunity to refuse answering (see below). In addition, the existing Questions mechanic does not allow the user to skip the current answer, moving strait to the next one. In general, this is possible, but this option must be created manually in a custom form using available functionality.

Types of Questions

At the time of writing, there are three types of questions in the main functionality and three in additional.

Main:

1. Single answer question - the user can and should give his answer in one message.

2. Multiple answer question - the user can reply with any number of messages (one is required).

3. Question with a choice of one option - the user can and must give an answer by choosing it from the list of possible options proposed by the administrator.

ADVICE:
All response messages can be as diverse as possible: using markdown, links, attached photo, document or media file.

Additional:

IMPORTANT:
The functionality of "🧩Extensions" section: for the option to appear in your menu, this function must be activated in your bot.

Advanced forms.
To connect, go to your bot:
☞ 🔐Admin | 🧩Extensions | 📂Forms

4. Contact Request - requires the user to send his phone number to the bot.

5. Location Request - requires the user to send his location data to the bot.

6. Roll the Dice - will allow the user to generate a random number by sending a special Telegram sticker to the bot.
List of available stickers and their features:
Generates a value from 1 to 6: 🎲 🎯 🎳
Generates a value from 1 to 5: 🏀 ⚽️
Generates a value from 1 to 64: 🎰

ADVICE:
With the help of a dice roll (taking the number generated by it into a variable), you can create games by accruing the prizes. A separate manual does not yet exist, at the time of writing - so this is just information for your reference.

Features

Variable input

INFORMATION:
Variable input - allows you to save the user's response in a variable with the ability to later display this content to the user himself using a variable macros or view it in the Export file (see "Additional Information" at the end of the document), as well as send the required response data to admins.

INFORMATION:
If the variable for input is text, any responses up to 200 characters long are accepted. If the variable for input is numeric, only answers that are numbers (including fractional ones) are accepted.

IMPORTANT:
"Variable Input" (as well as any other form) CANNOT be added to the "Main Menu" of the bot (at the root).

IMPORTANT:
In the Main functionality, the Variable Input works only with the "Question with single answer". In the Additional functionality, all questions are available for input, except for the “Question with a multi-answer”.

Hidden message

INFORMATION:
The function allows you to add hidden messages to the form. Hidden messages are not visible to the user when filling out the form, but they are sent to the bot or to the form's group along with the user's answers.

ADVICE:
In hidden messages, you can display any additional data of user variables, including those not related to the data received in the form itself.

IMPORTANT:
The functionality of "🧩Extensions" section: for the option to appear in your menu, this function must be activated in your bot.

Invisible buttons and messages.
To connect, go in your bot:
☞ 🔐Admin | 🧩Extensions | 📂Buttons

To enable the invisible message mode, in the "📝 Post Editor" add a regular message when creating a form, then in the message settings by clicking the button with an asterisk (✱) (in the same place where inline buttons are configured) enable this setting by clicking the "Invisible" button.

INFORMATION:
Hidden messages are not visible to anyone, except for the "Post Editor" mode.

Hidden messages are indicated by an icon with an eye 👁‍🗨 (the emoji of which, after copying, is not displayed correctly in Browsers and Telegraph articles).

Options

Delete Answer

User responses to all Form Questions (except for a Multiple Answer Question) can be deleted from the chat to maintain confidentiality.
Modes:
Off ⏹️ - answers are NOT deleted (default).
On ▶️ - answers are deleted.

For example, if a user sends any passwords or other sensitive data, they can be automatically deleted by the bot immediately after sending, so that there are no traces in the history of a chat with the bot.

 

Settings

To change the Form Settings, go in your bot:
☞ Button Editor.
• Select a button by pressing it.
• Press the inline button with an asterisk (✱) in the message with the button's data to enter its Settings.
• Click "Form Settings" to go to the settings.

The number of settings in the section may vary depending on the connected Extensions. For example, setting of a bot to work in a group.

Set Group

Allows you to redirect responses received from Forms to the specified group.

The setting is mutually exclusive with the «Set Admin» option. The last configured option will be active one.

For group settings, see the Groups guide.

Set Admin

Allows you to forward responses received from Forms to the specified Admin.

The setting is mutually exclusive with the «Set Group» option. The last configured option will be active one.

For information on how to add an Admin, see the Basic Functions guide.

Header

The setting allows you to hide the Form's header with user data when sending responses.
Modes:
Off ⏹️ - the title is hidden.
On ▶️ - title is shown (by default).

Footer

The setting allows you to hide the buttons «Notify», «Ask» and «Ban», of the Form's footer when sending answers.
Modes:
Off ⏹️ - buttons are hidden.
On ▶️ - buttons are shown (by default).

Send Questions

The setting allows you to disable the sending of Form's questions anywhere - admin will receive only the answers of the user.
Modes:
Off ⏹️ - questions are NOT sent.
On ▶️ - questions are sent (default).

Answer as «Forward»

The setting allows to "Forward" the USER's answers in the Form, keeping a link to his account. 
Modes:
Off ⏹️ - without account link (by default).
On ▶️ - with a link to the account.

Button «Cancel»

The setting allows you to hide the «Cancel» buttons in the Form, preventing users from refusing to fill out the Form.
Modes:
Off ⏹️ - button hidden.
On ▶️ - the button shown (by default).

Button «Skip»

The setting allows you to show a «Skip» button in the Form, allowing users to skip a single Question when filling out the Form.
Modes:
Off ⏹️ - the button is NOT shown (by default).
On ▶️ - the button is shown.

Add Tags

The option allows you to add a hashtag with UserID or UserCode to the answers of the user. This will allow you to "Reply" to the user's message directly - without using the Form's reply buttons.
Off ⏹️ - tags are not added (by default).
UserID - the user's Telegram ID will be added
UserCode - the user's MenuBuilderBot UseCode will be added

❖ Types of forms

By their structure, forms can be divided into several types:

Simple form

A simple form is a form that consists of one question (usually with a "single answer") and in fact simply allows the user to contact the bot admins or ask a question.

Complex form

Complex form - these forms consist of several questions, usually of different types and allow not only contacting the admins, but also collecting the necessary data before submitting.

Custom form

Custom form - usually has a complex structure, includes menu buttons with Actions and forwardings using commands. Such forms combine and composite different functions, while opening up opportunities that were not originally included in the basic functionality of forms and QnA chat.

For an example of creating such a form, see the Tutorials.

❖ Additional Information

Conditions of Forms

Conditions are available for Forms with "One Answer Question" for checking the information entered by the user.

Conditions of Forms
To add feature go to your bot:
☞ 🔐Admin | 🧩Extensions | 📂Forms