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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• GET
• POST

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

• POST_JSON
• POST_FORM_DATA

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Существует 3 наиболее популярных варианта применения данного действия. Рассмотрим каждый из них:

1. Простое отключение анимации

Настройки:

Нет текста, галочка Предупреждение выключена, нет URL

Результат:

Анимация кнопки завершается и выполняется переход на следующий шаг в чат-боте.

Когда применять?

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

Примечание: В веб-версии Telegram анимация кнопок не поддерживается.

2. Уведомление пользователя (pop-up)

Настройки:

Есть текст, отметка Предупреждение включена, нет URL

Результат:

Появляется всплывающее окно с сообщением. Бот продолжает работу независимо от действий пользователя.

Когда применять?

Для подтверждения действия или информирования (например, «Запрос принят!»).

3. Передача параметров TG-боту

Настройки:

Есть текст, включено «Предупреждение», указан URL (например, https://t.me/bot?start=param).

Результат:

Параметры передаются боту через deeplink-ссылку в бота по внутренней ссылке Телеграм.

Внешние ссылки за пределы Телеграма не поддерживаются.

Когда применять?

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