Блок - действие
С помощью данного типа блоков можно выполнять различные действия с подписчиком, например: добавить в другого бота, добавить в группу, добавить метку и т.д.
Далее представлен полный список возможных действий.
Действия с переменными
Это действия, которые выполняются с пользовательскими/глобальными переменными бота.
Установить переменную
Формула
Прибавить
Вычесть
Разделить
Умножить
Добавить в конец
Добавить в начало
Случайное число
Порядковый номер участника шага
Удалить переменную
Действия с ответом на сообщение
Внимание! Данные действия выполняются только после пункта Ответ на сообщение.
Ответ пользователя будет сохранен в указанную переменную.
Сохранить ответ с вложениями
Ответ пользователя с вложениями будет сохранен в указанную переменную. Вложения при этом сохраняются в виде ссылки.
Если переменная является числовым значением, ответ пользователя будет к ней прибавлен.
То же самое, только ответ будет вычтен из значения переменной.
Добавить в конец переменной
Ответ пользователя будет добавлен к имеющемуся значению в переменной, в его конец, как продолжение строки.
Добавить в начало переменной
То же самое, только ответ будет добавлен в начало.
Добавить в конец переменной с вложениями
Работает также, как и добавление к обычной переменной.
Добавить в начало переменной с вложениями
Работает также, как и добавление к обычной переменной.
Внимание! Бот не получает измененную версию ответа, если пользователь отредактировал ответ.
Действия со статусами набора сообщения
Установить статус набора текста
Установить статус записи голосового сообщения
Действия с вебхуком
На выбранный адрес будет отправлен вебхук с данными участника бота. В ответ сервер должен вернуть 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 наиболее популярных варианта применения данного действия. Рассмотрим каждый из них:
Простое отключение анимации
Настройки:
Нет текста, галочка Предупреждение выключена, нет URL
Результат:
Анимация кнопки завершается и выполняется переход на следующий шаг в чат-боте.
Когда применять?
Если нужно убрать индикатор загрузки, чтобы пользователь не думал, что бот завис.
Примечание: В веб-версии Telegram анимация кнопок не поддерживается.
Уведомление пользователя (pop-up)
Настройки:
Есть текст, отметка Предупреждение включена, нет URL
Результат:
Появляется всплывающее окно с сообщением. Бот продолжает работу независимо от действий пользователя.
Когда применять?
Для подтверждения действия или информирования (например, «Запрос принят!»).
Передача параметров TG-боту
Настройки:
Есть текст, включено «Предупреждение», указан URL (например, https://t.me/bot?start=param).
Результат:
Параметры передаются боту через deeplink-ссылку в бота по внутренней ссылке Телеграм.
Внешние ссылки за пределы Телеграма не поддерживаются.
Когда применять?
Для выполнения действий с параметрами (например, подписка на группу подписчиков).
Last updated