Нода «Действия»

Нода «Действия» выполняет одно или несколько действий в фоне: меняет данные, ставит теги, создаёт сделки, обращается к внешним системам, начисляет баллы и многое другое. Это «рабочая лошадка» сценария — именно через неё бот делает что-то полезное, а не просто переписывается.

Как это работает

  • В одной ноде можно добавить несколько действий — они выполняются по порядку, сверху вниз.
  • Действия работают с текущим подписчиком/клиентом и его данными.
  • В параметрах действий можно использовать переменные в фигурных скобках, например {{name}} или {{phone}}, а секреты (токены, ключи) — через {{secret.имя}}, чтобы не хранить их в открытом виде.
  • Часть действий появляется только когда применима: нужная интеграция подключена (AmoCRM, Google Sheets, GetCourse…) или подходит тип канала (Telegram/VK/MAX). Действия лояльности видны всегда — при выключенной программе они возвращают статус disabled.
  • «Действия» доступны на всех тарифах подписки «Маркетинг», в том числе на Free. Для действий с таблицами нужны таблицы из раздела «Таблицы» — создавать их можно на платном тарифе.

Действия не пишут клиенту — кроме «Сгенерировать изображение», которое по умолчанию само отправляет картинку. Чтобы сообщить результат (например, «Заявка принята»), поставьте после ноды «Действия» ноду «Сообщение».

Что умеет нода «Действия»

Работа с диалогом

ДействиеЧто делает
Перевести на оператораПереводит диалог на живого сотрудника (бот останавливается).
Закрыть диалогЗавершает обращение.

У действия Перевести на оператора три способа передачи:

  • Оператор (по умолчанию) — одному из выбранных в действии сотрудников или любому доступному. Если выбран вариант «Из выбранных операторов», без выбранных сотрудников сценарий не опубликовать.
  • По правилам канала — так же, как новые обращения канала: по правилам распределения или в «Очередь».
  • Очередь — диалог ждёт во вкладке «Очередь», его видят сотрудники канала. Чтобы ответить клиенту, сотрудник нажимает «Взять в работу», и диалог переходит в его «Мои». Пока обращения обрабатываются во внешней CRM, сценарий с таким действием можно сохранить, но нельзя опубликовать или запустить.

Данные подписчика и теги

ДействиеЧто делает
Установить пользовательское полеСохраняет значение в переменную сценария, а с ключом global.имя — в глобальное поле. Можно дополнительно записать в поле CRM.
Присвоить тегСтавит теги общего пула на чат, клиента или сделку.
Снять тегУбирает ранее навешенные теги.

CRM

ДействиеЧто делает
Создать сделку (встроенная CRM)Заводит сделку в воронке APX Chat.
AmoCRM: создать / обновить сделкуСоздаёт лид или обновляет существующий в amoCRM.
Bitrix24: создать / обновить сделкуСоздаёт или обновляет сделку в Bitrix24.

Внешние запросы и интеграции

ДействиеЧто делает
HTTP-запрос к APIОтправляет запрос во внешнюю систему; ответ можно разобрать в переменные. Поддерживает переменные и секреты, защищён от SSRF.
Отправить вебхукШлёт POST с карточкой подписчика на ваш URL.
Отправить emailОтправляет письмо на заданный адрес.
Отправить данные подписчика на emailПрисылает на почту карточку полей подписчика.
Отправить сообщение в другой ботПересылает сообщение в другой бот (Telegram/MAX/VK) по токену. В MAX — в чат или пользователю.

Таблицы и Google Sheets

ДействиеЧто делает
Таблицы бота: добавить / найти / обновить / удалить строкуМини-база данных внутри бота (таблицы).
Google Таблицы: добавить / найти / обновить строкуЗапись и поиск строк в Google Sheets.

Обучение и доступы (GetCourse)

ДействиеЧто делает
GetCourse: добавить / обновить пользователяСоздаёт или обновляет пользователя в GetCourse.
GetCourse: выдать доступ к продуктуСоздаёт оплаченный заказ на предложение GetCourse: по ID предложения или по коду предложения с суммой заказа.

Аналитика и AI

ДействиеЧто делает
Событие в Яндекс.МетрикуОтправляет цель офлайн-конверсией через подключённую Метрику. Посетитель — по ClientID или yclid: на сайте их передаёт виджет, в мессенджерах их нужно передать в действие, иначе цель не отправится.
Сгенерировать изображениеСоздаёт картинку нейросетью и по умолчанию сразу отправляет её клиенту. Ссылка сохраняется в переменную — её можно прислать текстом или кнопкой.

Маркетинг, подписки и лояльность

ДействиеЧто делает
Подписать / отписать от авторассылкиВключает или выключает подписчика в drip-серию.
Отменить подписку (рекуррентный платёж)Прекращает регулярное списание.
Начислить / списать баллыУправляет баллами программы лояльности.
Прочитать баланс и уровеньКладёт баланс/уровень клиента в переменные (для показа или условий).
Применить промокодАктивирует промокод (скидка/баллы).

Реферальная программа

ДействиеЧто делает
Засчитать переход по реф-ссылкеРегистрирует реферера из стартового параметра.
Получить персональную реф-ссылкуВозвращает ссылку приглашения клиента.
Статистика реферераКладёт число приглашённых в переменную.

Администрирование группы (по каналу)

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

  • Telegram: исключить из группы, разблокировать, одобрить или отклонить заявку на вступление, закрепить сообщение. Заявки бот не видит: одобрить получится, только если человек уже подал заявку и сам написал боту в личку.
  • ВКонтакте: исключить из беседы, закрепить сообщение. Одобрять заявки в сообщество и вести его чёрный список VK сообществу не позволяет, поэтому таких действий нет.
  • MAX: добавить в чат, исключить из чата, закрепить сообщение.

В Telegram и ВКонтакте «Закрепить» без указанной группы закрепляет сообщение в личном диалоге с подписчиком. Чтобы закрепить сообщение в группе, укажите группу и ID сообщения в ней: последнее сообщение бота отправлено в личный диалог, в группе его нет.

В MAX закреп работает только в группах и каналах, где бот — администратор, и только с указанной группой. В личном диалоге MAX закреп не поддерживает: действие завершится ошибкой, и сценарий пойдёт дальше без закрепа. Проверка сценария заранее предупредит, что группа не указана.

Модерации внутри группы нет: бот не встречает новых участников, не проверяет их капчей, не удаляет сообщения и не следит за спамом.

Как добавить ноду

  1. Добавьте шаг «Действия»

    Нажмите «Добавить шаг» и выберите «Действия», либо перетащите ноду на канвас.

  2. Выберите действие

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

  3. Используйте переменные

    В полях подставляйте данные клиента через {{переменная}}, а ключи и токены — через {{secret.имя}}.

  4. Свяжите со следующим шагом

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

Примеры применения

  • Приём заявки: «Действия» создаёт сделку в CRM и навешивает тег «заявка с бота», затем «Сообщение» благодарит клиента.
  • Интеграция с вашей системой: «Действия» делает HTTP-запрос (проверить остаток/статус заказа), ответ кладёт в переменную, а «Условие» ветвит сценарий по результату.
  • Лояльность: при оплате «Действия» начисляет баллы, а позже другое действие читает баланс для показа клиенту.
  • Вебинар: «Действия» добавляет пользователя в GetCourse и выдаёт доступ к продукту после оплаты.

Действия с внешними системами (CRM, Google Sheets, GetCourse, оплата) работают только при подключённой соответствующей интеграции. Действия над группой выполняются из личного диалога с подписчиком: укажите группу в действии и назначьте бота её администратором.