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

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

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

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

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

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

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

Пример. Если выбрать действие «Добавить в бота» и указать бота Воронка продаж, подписчик будет добавлен в этого бота (при выборе шага — начнёт с указанного шага).

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

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

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

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

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

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

Важно:

функция не удаляет пересланные сообщения, только оригинал;
если с сообщением были отправлены обычные кнопки (не inline) — у пользователей они сохранятся. Чтобы убрать их, отправьте новое сообщение, либо временно выключите возможности ботов ВК (в этом случае старые кнопки будут удалены у всех).

Пример. Если в шаге было сообщение с кнопками и оно больше не актуально, можно удалить сообщение у пользователя (в пределах 24 часов), а затем отправить новое.

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

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

Добавить в группу

Пример. Добавить подписчика в группу Покупатели, чтобы дальше отправлять ему отдельные рассылки.

Удалить из группы

Пример. Удалить подписчика из группы после завершения сценария.

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

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

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

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

Пример. Добавить метку sale, чтобы дальше в условиях проверять участие пользователя в акции.

Удалить метку

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

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

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

Пользовательская переменная

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

Возможные варианты действий:

Установить переменную — записывает указанное значение.

Пример. Установить 1 → переменная станет 1.

Формула — вычисляет значение по формуле и записывает результат.

Пример. 10+5 → запишется 15.

Прибавить — прибавляет число к текущему значению.

Пример. было 3, прибавить 2 → станет 5.

Вычесть — вычитает число из текущего значения.

Пример. было 10, вычесть 4 → станет 6.

Разделить — делит текущее значение на число.

Пример. было 20, разделить на 4 → станет 5.

Умножить — умножает текущее значение на число.

Пример. было 5, умножить на 3 → станет 15.

Добавить в конец — добавляет значение в конец строки.

Пример. было заказ, добавить -1 → станет заказ-1.

Добавить в начало — добавляет значение в начало строки.

Пример. было 123, добавить ID- → станет ID-123.

Случайное число — записывает случайное число.

Пример. использовать для генерации случайного значения.

Порядковый номер участника шага — записывает порядковый номер дошедшего до шага пользователя.

Пример. первый получит 1, второй 2 и т.д.

Удалить переменную — очищает значение переменной.

Пример. переменная станет пустой.

Список базовых операций с переменными совпадает с описанием в документации.

Глобальная переменная

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

Сначала выберите переменную или нажмите "Создать новую переменную".

Возможные варианты действий (аналогично пользовательской):

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

Пример. Установить значение глобальной переменной status = paid, чтобы использовать его далее в логике.

peremennye.md

Ответ на сообщение

Внимание! Данные действия выполняются только после пункта Ответ на сообщение.То есть они применяются, когда в сообщении/шаге используется ожидание ответа.

Ожидание ответа в боте

Действия с ответом пользователя (в переменную)

Сначала выберите действие, затем укажите переменную (или нажмите «Создать новую переменную»).

Сохранить ответ — сохраняет текст ответа пользователя в выбранную переменную.

Пример. пользователь написал Иван → в переменной будет Иван.

Сохранить ответ с вложениями — сохраняет ответ пользователя вместе с вложениями (фото/файл/и т.д.) в переменную.

Пример. пользователь отправил текст и фото → сохранится ответ с вложением.

Прибавить ответ к переменной — прибавляет числовое значение ответа к текущему значению переменной.

Пример. было 10, пользователь отправил 5 → станет 15.

Вычесть ответ из переменной — вычитает числовое значение ответа из текущего значения переменной.

Пример. было 10, пользователь отправил 3 → станет 7.

Добавить в конец переменной — добавляет ответ в конец значения переменной.

Пример. было ID-, ответ 123 → станет ID-123.

Добавить в начало переменной — добавляет ответ в начало значения переменной.

Пример. было 123, добавить в начало ID- → станет ID-123.

Добавить в конец переменной с вложениями — добавляет ответ (вместе с вложениями) в конец значения переменной.

Пример. текст + файл будут добавлены в конец.

Добавить в начало переменной с вложениями — добавляет ответ (вместе с вложениями) в начало значения переменной.

Пример. текст + файл будут добавлены в начало.

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

Статус набора текста

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

Позволяет показывать пользователю статус активности сообщества в диалоге ВКонтакте.

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

Пример. включить “печатает…” перед отправкой сообщения, чтобы создать эффект живого общения.

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

Пример. включить статус “записывает голосовое…” перед отправкой аудиосообщения/важного текста.

Статус набора текста

Отправить данные подписчика администратору

Выбранному администратору будут отправлены данные участника бота со значением всех переменных.

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

Вебхук

Действие «Вебхук» позволяет отправить запрос на внешний адрес (URL). Используется для интеграций: CRM, таблицы, собственные сервисы и т.д.

Настройка вебхука

Укажите URL (начинается с https://).
При необходимости выберите шаблон (поле "Выберите шаблон").
Выберите тип запроса:

POST_JSON
POST_FORM_DATA
GET

Нажмите "Тестовый запрос" для проверки.
Для анализа выполнения используйте ссылку "Статистика".

Ожидать ответ

Опция "Ожидать ответ" задаёт поведение цепочки:

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

Пример. Если вебхук создаёт заказ во внешней системе — включите ожидание ответа, чтобы не продолжать сценарий при ошибке.

Обработать ответ

Опция "Обработать ответ" позволяет разобрать JSON-ответ и записать значения в переменные.

Результат:

Название	Описание
secret	Секретный ключ
type	Тип вебхука. При отправке post-запроса от бота всегда отправляется значение: action.
object	Объект с данными подписчика

Объект с данными подписчика содержит следующие поля:

Название	Описание
vk_user_id	идентификатор пользователя ВКонтакте
first_name	имя
last_name	фамилия
bdate	день рождения (год может быть не указан)
domain	короткий адрес страницы. Возвращается строка, содержащая короткий адрес страницы (например, andrew). Если он не назначен, возвращается "id"+user_id, например, id35828305.
country_id	идентификатор страны
city_id	идентификатор города
photo	фото
sex	пол. Возможные значения: 1 — женский; 2 — мужской; 0 — пол не указан.
relation	семейное положение. Возможные значения: 1 — не женат/не замужем; 2 — есть друг/есть подруга; 3 — помолвлен/помолвлена; 4 — женат/замужем; 5 — всё сложно; 6 — в активном поиске; 7 — влюблён/влюблена; 8 — в гражданском браке; 0 — не указано.
utms	массив меток
subscriptions	массив с группами, на которые пользователь подписан
vk_group_id	идентификатор сообщества ВКонтакте
group_id	идентификатор сообщества в Senler
unixtime	дата добавления пользователя в базу подписчиков в секундах (unixtime)
date	дата добавления пользователя в базу подписчиков

Пример. Вебхук вернул status=ok, и это значение сохраняется в переменную для дальнейших условий.

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

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

Заголовки

Через "Добавить заголовок" можно указать дополнительные HTTP-заголовки.

Пример. Добавить Authorization для доступа к API внешнего сервиса.

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

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

Удалить из всех групп — удаляет подписчика из всех групп подписчиков.

Пример. очистить сегменты в конце сценария.

Удалить все метки — удаляет у подписчика все метки.

Пример. сбросить временные метки после прохождения ветки.

Удалить из всех чат-ботов — удаляет подписчика из всех чат-ботов.

Пример. принудительно остановить участие пользователя во всех цепочках.

Удалить все пользовательские переменные — очищает все пользовательские переменные канала.

Пример. “сброс прогресса” для повторного прохождения сценария.

Удалить из базы — удаляет подписчика из базы Senler.

Пример. использовать при отказе пользователя от взаимодействия/по правилам обработки данных.