Краткое введение в обратную связь

ОПРЕДЕЛЕНИЕ:
Функция обратной связи и создание форм позволяет администраторам ботов, созданных с помощью @MenuBuilderBot, задавать различные вопросы пользователям, получая ответы в виде чата, а так же собирать как текстовые данные, так и медиа содержимое. Функционал позволяет отвечать пользователям как из самого бота, где была создана форма с вопросами, так и из группы куда бот может перенаправить ответы юзера. Текстовые данные можно сохранять в переменных, посматривая их в сводных таблицах типа Excel, или отправлять, дублировать аккумулированные в переменных данные в чаты Телеграм при помощи Action-ов.

Функция "Обратная связь" в MenuBuilderBot естественным образом интегрирована в функционал создания меню. Создание форм обратной связи реализуется через кнопки и сообщения.

Форма, по сути, это кнопка с набором сообщений и вопросов в ней. В общем случае, каждое сообщение кнопки в которой создается форма, представят собой отдельный "Вопрос". Вопросы формы могут чередоваться с обычными сообщениями. Обычные сообщения будут показаны юзеру, но не будут отправлены админу при отправке данных формы. Обычные сообщения в форме используются для показа пояснений и прочей информации, которая нужна юзеру и НЕ нужна адимну. Вопросы формы и сообщения будут показаны юзеру по порядку сверху вниз. Переход к следующему вопросу возможен только поле ответа на предыдущий.

ВАЖНО:
Форма не может быть добавлена в "Главном Меню" (в корне) бота.

❖ Типы Вопросов, Фичи и Настройки

ОПРЕДЕЛЕНИЕ:
Вопрос (в контексте создания в формы обратной связи) - это отдельное "поле" куда юзер должен вписать или перенаправить запрошенные в нем данные. Существует несколько типов Вопросов. Тип вопроса определяет тип принимаемых данных и выбирается в зависимости от того, какие данные и в каком виде вам необходимо принять от юзера. В зависимости от типа данных их можно записывать в переменные или только пересылать в чат админу (например картинку нельзя напрямую записать в переменную).

СОВЕТ:
При настройках по умолчанию, отвечая на вопрос юзер может нажать «Отмена», прервав тем самым заполнение формы. Кнопку «Отмена» в некоторых типах вопросов можно спрятать - не давая юзеру возможность отказаться от ответа (см. ниже). Кроме того, существующая механика Вопросов не позволяет юзеру пропускать ответ на вопрос, переходя к следующему. В целом это возможно, однако данную опцию необходимо создавать вручную в кастомной форме используя доступный функционал.

Типы Вопросов

На момент создания руководства существует три типа вопросов в основном функционале и три в расширенном.

Основные:

1.1 Вопрос с одиночным ответом - пользователь может и должен дать свой ответ в одном сообщении.

1.2 Вопрос с мультиответом - пользователь может ответить любым количеством сообщений (одно - обязательно).

1.3 Вопрос с выбором одного варианта - пользователь может и должен дать ответ выбрав его из списка возможных вариантов, предложенных админом.

СОВЕТ:
Все сообщения ответов могут быть максимально разнообразными: с использованием markdown, ссылками, прикрепленной фотографией, документом или медиа файлом.

Расширенные:

ВАЖНО:
Функционал раздела «🧩Расширения»: чтобы опция появилась в вашем меню эта функция должна быть активирована в вашем боте.

Расширенные формы.
Для подключения перейдите в вашем боте:
☞ 🔐Админ | 🧩Расширения | 📂Формы

1.4 Запрос Контакта - требует от юзера отправить боту номер своего телефона.

1.5 Запрос Местоположения - требует от юзера отправить боту данные своего местоположения.

1.6 Бросок Кубика - позволит юзеру сгенерировать случайное число путем отправки боту спец стикера Telegram.
Список доступных стикеров и их особенности:
Генерируют значение от 1 до 6: 🎲 🎯 🎳
Генерируют значение от 1 до 5: 🏀 ⚽️
Генерируют значение от 1 до 64: 🎰

СОВЕТ:
При помощи броска кубика (принимая сгенерированное им число в переменную) можно создавать игры, начисляя выигрыши. Отдельного руководства, на момент написания, еще не существует - поэтому это просто информация для сведения.

Фичи

Ввод переменной

ИНФОРМАЦИЯ:
Ввод переменной - позволяет вам сохранить ответ пользователя в переменой с возможностью впоследствии вывести самому юзеру это содержимое при помощи макроса переменной или просмотреть в файле Экспорта (смотри "Дополнительную информацию" в конце документа), равно как и переслать админу оформленные нужным образом данные ответов.

ИНФОРМАЦИЯ:
Если переменная для ввода текстовая - принимаются любые ответы длиной до 200 символов. Если переменная для ввода числовая - принимаются только ответы, которые являются числом (в том числе - дробным).

ВАЖНО:
«Ввод Переменной» (так же как и любая другая форма) не может быть добавлен в «Главном Меню» бота (в корне).

ВАЖНО:
В Основном функционале Ввод переменной работает только с вопросами «С одиночным ответом». В Расширенном функционале для ввода переменной доступны все вопросы кроме «Вопроса с мультиответом».

Скрытое сообщение

ИНФОРМАЦИЯ:
Функция позволяет добавлять в форму скрытые сообщения. Скрытые сообщения не видны пользователю при заполнении формы, однако отправляются в бот или в группу формы вместе с ответами юзера.

СОВЕТ:
В скрытых сообщениях можно вывести любые дополнительные данные переменных юзера, в том числе и не относящиеся к данным, полученным в самой форме

ВАЖНО:
Функционал раздела «🧩Расширения»: чтобы опция появилась в вашем меню эта функция должна быть активирована в вашем боте.

Невидимые кнопки и сообщения.
Для подключения перейдите в вашем боте:
☞ 🔐Админ | 🧩Расширения | 📂Кнопки

Для включения режима невидимого сообщения, в «📝 Редактор Постов» добавьте обычное сообщение при создании формы, после чего в настройках сообщения по кнопке со звёздочкой [*] (там же где настраиваются инлайн кнопки) включите данную настройку нажав кнопку "Невидимое".

ИНФОРМАЦИЯ:
Скрытые сообщения не видны никому, за исключением режима «Редактор Постов».

Скрытые сообщения обозначены иконкой с глазом 👁‍🗨 (который после копирования некорректно отображается в Браузерах и статьях Telegraph).

Опции

Удалять Ответ

Ответы юзера на все Вопросы Формы (кроме Вопроса с Мультиответом) можно удалять из чата чтобы сохранить конфиденциальность.
Режимы:
Выкл ⏹️ - ответы НЕ удаляются (по умолчанию).
Вкл ▶️ - ответы удаляются.

Например если юзер отправляет какие-либо пароли или другие конфиденциальные данные, они могут быть автоматически удалены ботом сразу после отправки, чтобы не осталось следов в истории чата с ботом.

Настройки

Чтобы изменить Настройки формы перейдите в вашем боте:
☞ Редактор Кнопок.
• Выберите кнопку, нажав её.
• Нажмите инлайн кнопку со звездочкой ( ✱ ) в сообщении с данными кнопки для попадания в её Настройки.
• Нажмите «Настройки Формы», для перехода в настройки.

Количество настроек в разделе может меняться в зависимости от подключённых функций. Например настройки работы бота в группе.

Задать Группу

Позволяет переадресовывать ответы полученные из форм в указанную группу.

Настройка является взаимоисключающей с опцией «Задать Админа». Активной будет опция настроенная последней.

О настройках групп смотри в руководстве по Группам.

Задать Админа

Позволяет переадресовывать ответы полученные из форм указанному Админу.

Настройка является взаимоисключающей с опцией «Задать Группу». Активной будет опция настроенная последней.

О том как добавить Админа смотри в руководстве по Основным Функциям.

Заголовок

Настройка позволяет скрывать заголовок Формы с данными юзера при пересылке ответов.
Режимы:
Выкл ⏹️ - заголовок скрыт.
Вкл ▶️ - заголовок показывается (по умолчанию).

Footer

Настройка позволяет скрывать кнопки «Известить», «Спросить» и «Бан», футера Формы при пересылке ответов.
Режимы:
Выкл ⏹️ - кнопки скрыты.
Вкл ▶️ - кнопки показываются (по умолчанию).

Прислать Вопросы

Настройка позволяет отключить пересылку самих вопросов Формы - админ получит только ответы юзера.
Режимы:
Выкл ⏹️ - вопросы НЕ пересылаются.
Вкл ▶️ - вопросы пересылаются (по умолчанию).

Ответ как «Forward»

Настройка позволяет «Пересылать» (Forward) ответы ЮЗЕРА в Форме, сохраняя ссылку на его аккаунт.
Режимы:
Выкл ⏹️ - без ссылки на аккаунт (по умолчанию).
Вкл ▶️ - со ссылкой на аккаунт.

Кнопка «Отмена»

Настройка позволяет скрывать в Форме кнопки «Отмена», не давая возможности юзерам отказаться от заполнения Формы.
Режимы:
Выкл ⏹️ - кнопка скрыта.
Вкл ▶️ - кнопка показывается (по умолчанию).

Кнопка «Пропустить»

Настройка позволяет показать в Форме кнопку «Пропустить» (Skip), давая возможности юзерам пропустить отдельный Вопрос при заполнении Формы.
Режимы:
Выкл ⏹️ - кнопка НЕ показывается (по умолчанию).
Вкл ▶️ - кнопка показывается.

Добавить Теги

Опция позволяет добавлять к ответам пользователя хэштег с его UserID или UserCode. Это позволит «Отвечать» (Reply) на сообщение пользователя напрямую - не используя кнопки ответов Формы.
Выкл ⏹️ - теги не добавляются (по умолчанию).
UserID - будет добавлен Telegram ID юзера.
UserCode - будет добавлен UseCode юзера в MenuBuilderBot.

❖ Виды форм

Формы по своей структуре могут делится на несколько видов:

Простая форма

Простая форма - форма которая состоит из одного вопроса (обычно с «одиночным ответом») и по сути просто позволяет юзеру связаться с админами бота или задать вопрос.

Комплексная форма

Комплексная форма - эти формы состоят из нескольких вопросов, обычно разных типов и позволяют не просто связаться с админами, но и собрать необходимые данные, до отправки.

Кастомная форма

Кастомная форма - обычно имеет сложную структуру, включат в себя кнопки меню с Action-ами и пересылкой при помощи команд. Такие формы объединяют и комбинируют сторонние функции, открывая при этом возможности, не заложенные изначально в базовый функционал форм и QnA чата.

Пример создания такой формы смотри в Руководствах.

❖ Дополнительная Информация

Условия форм

Для форм с вводом "Одного Варианта Ответа" доступны Условия для проверки введенной юзером информации.

Условия Форм
Для подключения перейдите в свой бот:
☞ 🔐Админ | 🧩Расширения | 📂Формы