Перейти на сайт

Триггер «Событие из API»

Триггер запускает сценарий, когда ваш сайт, CRM или сервис оплаты присылает событие в API Botman.

Триггер запускает сценарий, когда ваш сайт, CRM или сервис оплаты присылает событие в API Botman: «оплатил заказ», «добавил товар в корзину», «открыл урок». Как отправлять события — в статье «События из вашей системы: сообщения по оплате, корзине, уроку».

Когда срабатывает

Сценарий запускается, если:

  • пришло событие с именем, выбранным в триггере;
  • Botman нашёл подписчика, указанного в событии;
  • данные события подходят под все условия триггера, если вы их задали.

Если у подписчика сейчас идёт диалог с оператором, сценарий запустится, когда диалог закончится.

Создание триггера

Откройте начальный шаг бота → нажмите «Добавить триггер» → «Системные» → «Событие из API».

Настройки

Событие

  • Выберите событие из списка — там события, которые уже приходили, и сколько раз каждое пришло. Под выбранным событием видно, когда оно пришло последний раз.
  • Событие ещё не приходило — введите имя и нажмите Enter. Имя: латиница в нижнем регистре, цифры, «_» и «.», до 64 символов, например order_paid.

Условия по данным события

Необязательно. Нажмите «Добавить условие» и укажите «Ключ», «Сравнение» и «Значение». Сценарий запустится, только если выполнены все условия. Условий — до 10.

  • для текста: «равно», «не равно», «содержит»;
  • для чисел: «равно», «не равно», «больше», «меньше»;
  • для true/false: «равно», «не равно».

Если нашлось несколько подписчиков

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

  • «Запустить для всех найденных» — сценарий придёт каждому найденному подписчику в его канал.
  • «Только в одном канале» — выберите канал, остальным найденным сценарий не придёт.

Переход к шагу

Выберите шаг, с которого начнётся сценарий.

Данные события в тексте

В блоке «Данные события в тексте» нажмите на нужную переменную, чтобы скопировать её, и вставьте в сообщение. Переменные есть и в выборе переменных, в группе «Данные события».

  • {{event.name}} — название события;
  • {{event.occurred_at}} — когда произошло, в виде дд.мм.гггг чч:мм по часовому поясу аккаунта;
  • {{event.amount}}, {{event.order_id}} и другие — значения из данных события. Ключи появятся в списке после первого события.

Запасное значение пишется через запятую: {{event.amount, 0}}. Если в событии такого ключа нет, подставится 0; без запасного значения — пусто.

Как прислать событие

В блоке «Как прислать событие» есть готовый пример с выбранным событием:

  • вкладка «Запрос к API» — команда curl, которую можно передать разработчику;
  • вкладка «Albato» — те же метод, адрес, заголовки и тело запроса, разложенные по полям, для HTTP-запроса из Albato.

Вместо YOUR_API_KEY подставьте свой ключ. Ссылка «Ключ API и журнал запросов» откроет вкладку «API» в разделе «Интеграции».

Проверка

Нажмите «Проверить с тестовым событием» — сценарий запустится на вас в тестовом чате с данными из примера.

Пример

📌 Спасибо за оплату крупного заказа: событие order_paid, условие amount «больше» 3000, сообщение:

Спасибо за оплату! Заказ {{event.order_id}} на {{event.amount}} ₽ уже собираем.

☝ Важно

  • Триггер не требует тарифа PRO.
  • В каналах TikTok триггер недоступен.
  • Если сценарий не запустился, откройте «Интеграции» → «API» → «Журнал запросов» и нажмите на строку события: в блоке «Что произошло» видна причина.


👆 На этом пока всё