Шаблон для проведения опросов

Вы можете быстро сделать бота, который будет проводить опрос

Правила заполнения таблицы

Пример заполненной таблицы https://docs.google.com/spreadsheets/d/1wAb3NshmpnyEQISQkgARzwHs6K3oiPKjmHyl4zgMlbY/edit#gid=0

Важен порядок столбцов и нумерация вопросов в первой колонке A

Первая строка вопроса главная: из нее берется сам текст вопроса и некоторые поля (картинка F, Доп 1 G, Доп 2 H).

Если вопрос с произвольным ответом, то не заполняем этому вопросу варианты ответов столбец C.

Столбец E номер следующего вопроса: можно оставить пустым, тогда вопросы будут задаваться подряд, либо заполнить по своему усмотрению и в зависимости от ответа пользователя.

Если баллы вам не нужны, заполняем столбец баллов D нулями и убираем вывод баллов из блока Вывод результатов.

Описание шаблона

Первый - входной блок: в нем обнуляются переменные с предыдущих опросов. Тут ничего изменять не нужно.

Следующий блок настроек, где нужно заполнить следующие переменные:

id = 'ид таблицы опроса’' text_add_number_str = ''Текст'' - если работа через список (без кнопок), то выводится внизу это сообщение (можно удалить, если не нужно выводить) text_write_answer = 'Текст' - если вопрос без вариантов ответа error_answer = ''Текст'' - при ответе на вопрос с отсутствующим вариантом ответа stop_word = 'stop' - стоп слово: ввести в любой момент опроса, и опрос завершится turn_on_button = 1 - отображение вариантов ответов как кнопки (чтобы отключить поставьте 0)

Параметры запроса:

! URL запроса: https://store.salebot.pro/function/polls_gsheets

! Json параметры:

{ "id": "#{id}", "text_write_answer": "#{text_write_answer}", "turn_on_button": "#{turn_on_button}", "text_add_number_str": "#{text_add_number_str}", "data_sheet": "#{data_sheet}", "stop_word": "#{stop_word}", "total_points": "#{total_points}", "user_answer": "#{q_answer}", "q_status": "#{q_status}", "current_question_data": "#{current_question_data}", "current_question_number": "#{current_question_number}", "all_answers": "#{all_answers}" }

Каждый запрос отправляет следующие параметры:

"id": "#{id}", - ид таблицы, можно также передать "text_write_answer": "#{text_write_answer}", - описание выше "turn_on_button": "#{turn_on_button}", - описание выше "text_add_number_str": "#{text_add_number_str}", - описание выше "data_sheet": "#{data_sheet}", - дамп вашей таблицы, служебная "stop_word": "#{stop_word}", - слово или фраза по которой останавливается тест "total_points": "#{total_points}", - общее количество баллов "user_answer": "#{q_answer}", - ответ пользователя "q_status": "#{q_status}", - статус 1 еще есть вопросы, 0 закончить опрос, err - ошибка "current_question_data": "#{current_question_data}", - дамп текущего вопроса, служебная "current_question_number": "#{current_question_number}", - номер текущего вопроса "all_answers": "#{all_answers}" - вопросы с ответами пользователя

Сохраняемые параметры из запроса:

q_status -> q_status; - описание выше в запросе total_points->total_points; - описание выше в запросе current_question_number->current_question_number; - описание выше в запросе question->output_question; - описание выше в запросе current_question_data->current_question_data; - описание выше в запросе data_sheet->data_sheet; - описание выше в запросеbuttons->buttons; - кнопки вариантов ответов answers_list->answers_list; - если кнопки выключены, тут будет список вариантов ответов checker->checker; - используется для проверки введенных данных, если есть варианты ответов, то лишнее ввести не даст picture->picture; - ссылка на картинку, если есть value_1->value_1; - дополнительное поле из таблицы value_2->value_2; - дополнительное поле из таблицы err->err; - описание ошибки all_answers->all_answers

Существует 2 дополнительных столбца: они возвращаются вместе с новым вопросом. Вы можете передать свои данные для кастомизации работы опросника - это параметры value_1 и value_2 (берутся из строки с вопросом)

Опрос заканчивается, когда переменная status получает значение end

Чтобы досрочно завершить опрос пользователь должен ввести указанное вами стоп слово в переменной stop_word.

Все ответы на вопросы сохраняются в переменной all_answers

Дополнительные возможности

К вопросу можно добавить картинку: для этого в строке с вопросом укажите URL картинки.

Если картинки вы не используете ни в одном вопросе, то можно переместить выделенную стрелку (на скрине выше) к следующему блоку Вывод вопроса.