У кого много ботов в qnext, для вас в разделе 🤖Боты появилась возможность создавать 📂каталоги, чтобы структурировать своих ботов.

​
В меню теперь вы можете указать на кнопках и ссылках выражения ($переменные и !макросы). Также теперь можно создавать неограниченное количество страниц (раньше можно было максимум 8).

@QNextBot #menu

​
В ⚙️настройках 🗄формы, в разделе 📊Результаты появилась возможность кастомизировать под себя отображение списка результатов формы и так же отображение непосредственно самого результата.

Результаты и список результатов открываются реакцией ⚡️openFormResult. В реакции openFormResult теперь также можно указать id результата, который необходимо открыть при выполнении этой реакции. Вы можете например сохранить в профиль юзера ${formData.id}, а потом указать этот профиль в реакции openFormResult чтобы открыть нужные результаты заполнения формы.


@QNextBot #form

​
У реакции ⚡️formStart появилась настройка mapSettings. Которая будет передана в результат заполнения. Во время и после заполнения формы, значение mapSettings можно получить в переменной ${formData.mapSettings}.

Где можно применить? Например если вы хотите одну и ту же форму применить в разных местах и в тригере финишь выполнить разные действия, вы можете использовать для этого mapSettings.

@QNextBot #form

​
Реакция ⚡️timeout позволяет вставить в триггер задержку. Время задержки указывается в миллисекундах в диапазоне от 100 мс. до 3000 мс. (3 секунды).

⚠️Важно: на выполнение всего тригера отводится не более 10 секунд, если ваши реакции будут выполняться в сумме больше указанного времени - выполнение тригера будет остановлено.

@QNextBot #reaction

⚠️Внимание! Изменился механизм работы take-реакций.
Написал подробную статью о том, что и как изменилось:
https://telegra.ph/Novyj-mehanizm-take-reakcij-12-13
Обязательно к прочтению.

#take

​
Новая реакция ⚡️localVarDel позволит удалить локальную переменную.

@QNextBot #reaction

Видео о том, как пользоваться логами в конструкторе @qnextbot
https://youtu.be/7aWbBXHSsj8

#logs

Новая реакция ⚡️keyboardRefresh - обновит текущую клавиатуру пользователя. Пример использования: У пользователя открыта клавиатура, при нажатии на кнопку клавиатуры необходимо поменять текст или скрыть какую либо кнопку клавиатуры. Реакция ⚡️keyboardRefresh обновит текущую клавиатуру пользователя с учетом новых условий/ограничений.

@QNextBot #reaction

Обновление в 🗄форме.

1) У полей select, branch и list появилась возможность Импорта и Экспорта списка кнопок. В это же разделе есть кнопка ❌удаления всех имеющихся кнопок. Пример использования: необходимо создать поле для выбора страны, список стран большой(>200). Можно скриптом на стороне создать json файл и загрузить его в бота, чтобы из этого файла создать набор кнопок. Чтобы получить формат json файла - создайте кнопку и сделайте экспорта кнопок.

2) Когда кнопок много, искать нужную становится сложно, к тому же у telegram есть ограничение - не болльше 100 кнопок на 1 пост. Поэтому при большом количестве кнопок бот не показывает все кнопки в этом разделе, вместо этого отображается inline-кнопка для поиска в inline режиме. Почитать про inline режим можно в <a href="https://t.me/QNextSupportBot?start=faq">FAQ</a>, в разделе Начало.

В поле select и branch можно создать максимум 50 кнопок. В поле list - 300.

@QNextbot #form

В реакции ⚡️sendLocation добавлена опция hideButton, для быстрого закрытия поста. Также в опции latitude и longitude теперь можно указать выражения, которые возвращают соответствующие значения.

@QNextBot #reaction

Новые реакции ⚡️globalVarSet и ⚡️globalVarDel для записи и удаления значения глобальной переменной.

@QNextBot #reaction

В настройках кнопок 🕹меню появились две опции: Значение 1 и Значение 2. Сюда можно записать любые значения или выражения, которые будут доступны в тригере в переменной ${buttonsVar.v1} и ${buttonsVar.v2}. Передавать можно только числовые параметры.

@QNextBot #menu

Реакция ⚡️loadFormResult загрузит всю информацию о заполненной ранее 🗄форме. По умолчанию загружается последняя заполненная форма. Можно указать какие именно результаты необходимо загрузить.

Например если в 🔗тригере финиш записать в 🆎профиль id результатов ${formData.id}. Затем в любой момент вы сможете получить эти результаты, указав в реакции ⚡️loadFormResult ссылку на значение в профиле.

После выполнения реакции будут доступны следующие переменные:

 - ${form}
 - ${formData}
 - ${formResult}
 - ${authorUser}

@QNextBot #form #reaction

Если при создании реакции ⚡️profileDel не выбрать конкретный параметр профиля, а нажать кнопку ✔️Все напротив типа профиля, тогда при выполнении реакции, будут удалены все имеющиеся значения указанного типа.

Пример:
Указали тип:
👤Пользователи -> ✔️Все
Создали реакции:
⚡️takeUser
- ⚡️profileDel
В этом случае у выбранного пользователя будут удалены ВСЕ параметры профиля.

@QNextBot #reaction

Реакция ⚡️takeFormResults итерируется по всем результатам формы. На каждой итерации будет доступна переменная ${formData}. Чтобы загрузить полную информацию по результатам, внутри ⚡️takeFormResults используйте реакцию ⚡️loadFormResult используя переменную ${formData.id}.

В настройках реакции можно выбрать пользователя, чьи результаты необходимо загрузить. На скриншоте показан пример: будут загружены результаты пользователя, на которого сделали reply(ответ). Если не указать - будут получены последние результаты от всех пользователей.

Можно также указать количество - сколько последних результатов загрузить. Загрузить можно максимум 10 последних результатов.

@QNextBot #form #reaction

⚠️Внимание! Конструкции вида
${user.data.Параметр.value} и ${user.link}
устарели. Вместо них необходимо использовать макросы
!{profile} и !{user}
Подробнее о формате этих макросов читайте в документации https://telegra.ph/QNext-Legacy-load-profile-01-09.

Старые конструкции будут работать еще какое то время, но в будущем они будут отключены. Сейчас при обнаружении такой конструкции, бот уведомит вас о том что это надо изменить. Уведомления будут приходить в технический чат, если тех чата не задан, тогда владельцу бота в личку. Установить технический чат можно в разделе
⚙️Настройки бота - ⚙️Общий настройки - 👤Технический чат.

🔻Для удобного переноса реакций под новый механизм ⚡️take-реакций, добавлена возможность ✂️Вырезать реакцию.
⚠️Вырезанная реакция будет удалена после успешной вставки, будьте осторожны.

#take

⚠️Небольшое изменение поведения поля ℹ️info в 🗄форме. Раньше если это поле было последним, заполнение формы завершалось автоматически. Сейчас заполнение не завершается, вместо этого поле ℹ️info показывает свой текст и кнопку Далее. Т.е. ведет себя так же, как если бы поле ℹ️info было по середине формы.

Если у вас есть форма, у которой последнее поле ℹ️info - вам необходимо убрать это поле, и в триггере финишь сделать реакцию ⚡️message с таким же текстом.

#form

Новые 🔗триггеры для более тонкой настройки ваших 🗄форм.

В базовом разделе формы, в разделе 🔗Триггеры рядом с 🔗Триггером Поля После появился новый 🔗Триггер Поля До. Триггер До выполнится перед визуализацией поля формы, а триггер После - соответственно после заполнения поля формы. Эти триггеры применяются для всех полей формы.

В настройках каждого поля появился свой персональный 🔗Триггер Подготовки Поля, который выполняется перед визуализацией поля.

Если указать Триггер До и Триггер Подготовки, сперва выполнится Триггер До, а затем Триггер Подготовки.


@QNextBot #form

Новое поле 🗄формы - 👁‍🗨hidden. Это поле не показывается пользователю в процессе заполнения формы. Используя это поле вы можете скрытно записать в результаты какие либо значения. При создании поля необходимо с помощью ${выражения} указать путь до значения, которое необходимо записать в этом поле.

Например если вы хотите записать в поле случайное число, вам необходимо в 🔗Триггере Подготовки Поля создать реакцию:

⚡️localVarSet randomValue = !{random| type: number: min: 1; max: 100}

А затем в поле 👁‍🗨hidden указать путь
${localVar.randomValue}
и указать тип данных 🔢number.

@QNextBot #form #reaction