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

PreviousБлок - таймер NextБлок - группа условий

Last updated 2 months ago

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Установить статус набора текста

Установить статус записи голосового сообщения

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

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

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

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

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

GET
POST

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

POST_JSON
POST_FORM_DATA

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ответить на callback запрос

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

Пример использования в чат-боте:

Вы можете его использовать, если вам нужно:

Отключить анимацию загрузки кнопки после нажатия
Отправить пользователю всплывающее уведомление (pop-up)
Передать параметры по указанной ссылке (только внутри Telegram)

Настройки действия:

При создании шага настройки по умолчанию не заданы — это просто отключит анимацию кнопки.

Ввод сообщения, которое будет отображаться во всплывающем уведомлении или в pop-up'е
Включение возможности отправки всплывающего сообщения (или pop-up'а опцией Предупреждение)