Блок - действие

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

Все действия внутри блока "Действие" выполняются асинхронно, а не последовательно.

Далее представлен полный список возможных действий.

Действия с переменными

Это действия, которые выполняются с пользовательскими/глобальными переменными бота.

Установить переменную
Формула
Прибавить
Вычесть
Разделить
Умножить
Добавить в конец
Добавить в начало
Случайное число
Порядковый номер участника шага
Удалить переменную

peremennye-v-botakh.md

Действия с ответом на сообщение

Внимание! Данные действия выполняются только после пункта Ответ на сообщение.

Сохранить ответ в переменную

Ответ пользователя будет сохранен в указанную переменную.

Сохранить ответ с вложениями

Ответ пользователя с вложениями будет сохранен в указанную переменную. Вложения при этом сохраняются в виде ссылки.

Прибавить ответ к переменной

Если переменная является числовым значением, ответ пользователя будет к ней прибавлен.

Вычесть ответ из переменной

То же самое, только ответ будет вычтен из значения переменной.

Добавить в конец переменной

Ответ пользователя будет добавлен к имеющемуся значению в переменной, в его конец, как продолжение строки.

Добавить в начало переменной

То же самое, только ответ будет добавлен в начало.

Добавить в конец переменной с вложениями

Работает также, как и добавление к обычной переменной.

Добавить в начало переменной с вложениями

Работает также, как и добавление к обычной переменной.

Внимание! Бот не получает измененную версию ответа, если пользователь отредактировал ответ.

Действия со статусами набора сообщения

Установить статус набора текста
Установить статус записи голосового сообщения
Установить статус отправки фото
Установить статус отправки видео
Установить статус отправки файла

После установки статуса он отображается в течение 5 секунд.
После этого происходит ожидание ещё 5 секунд, по завершении которого сценарий переходит к следующему шагу.

Действия с вебхуком

На выбранный адрес будет отправлен вебхук с данными участника бота. В ответ сервер должен вернуть Status 200, иначе сервис попытается еще раз отправить запрос.

При отправке вебхука можно использовать шаблоны. В шаблонах с помощью конструктора можно собрать свой набор данных, передаваемых вебхуком. Пример:

Также доступны 2 шаблона по умолчанию. Их изменять нельзя, но можно скопировать и доработать под себя.

Отправить вебхук можно двумя типами HTTP-запросов:

GET
POST

Для POST-запроса доступны 2 формата:

POST_JSON
POST_FORM_DATA

Помимо настройки вебхука, его можно протестировать. Для этого отправляется тестовый запрос по нажатию соответствующей кнопки с целью проверить доступность сервера:

Далее можно обработать ответ сервера и сохранить его в переменные.

Если ниже не нажимать на кнопку Добавить ответ, то ответ сервера будет распарсен по правилу, описанному в подсказке на скриншоте.

В ином случае, каждый добавленный ответ можно сохранить в отдельные пользовательские/глобальные переменные. Пример:

Если на сервере подготовить структуру данных для ответа, то в этом окне можно отмечать чекбоксами, что конкретно сохранить в переменные.

После выбора определенных данных в настройках вебхука будет виден соответствующий результат:

Это говорит о том, что выбранные данные из ответа сервера будут сохранены в пользовательскую переменную example, а сама переменная появится в карточке вашего подписчика.

Еще можно включить опцию ожидать ответ.

Она говорит о том, что бот продолжит идти по цепочке только в случае успешного выполнения, но если данную опцию не включать, то цепочка будет идти дальше, даже в случае ошибок во время выполнения вебхука.

И последнее, что есть еще в настройках вебхука - это возможность добавления HTTP-заголовков, которые полезны для эффективного и безопасного обмена данными.

Действия с ботами

Добавить в бота

Пользователь будет добавлен на выбранный шаг бота, даже в том случае, если уже был в этом боте. При этом из других шагов в данном боте он будет исключен, чтобы сообщения не дублировались.

Удалить из бота

Внимание! После удаления пользователя из бота дальнейшие шаги в этом боте выполняться не будут, поэтому такое действие нужно ставить в конце схемы бота.

Действия с сообщениями из бота

Удалить сообщение

Для удаления сообщения необходимо выбрать бота и шаг. У пользователя будет удалено данное сообщение, если прошло не больше 48 часов.

Данная функция не удаляет пересланные сообщения, только оригинал.

Если с сообщением были отправлены обычные кнопки или inline, то у пользователей они также удалятся.

Действия с метками

Это действия, которые выполняются с персональными метками участника бота.

Добавить метку
Удалить метку

Действия с группами подписчиков

Это действия, которые выполняются с группами подписчика.

Добавить в группу
Удалить из группы

Внимание! Чтобы не допустить зацикливания, при добавлении в группу подписчиков не запускаются связанные боты. Для добавления пользователя в бота необходимо создать дополнительное действие.

Очистить данные

Это действия, которые удаляют из карточки подписчика все связанные с ним сущности.

Удалить из всех групп
Удалить все метки
Удалить из всех чат-ботов
Удалить все пользовательские переменные
Удалить из базы

Внимание! Действие Удалить из базы не удаляет ваших подписчиков из базы, но меняет у них статус с активного на неактивный.