Елемент Умова в чат-ботах

За допомогою елементу Умова можна продовжити ланцюжок чат-бота залежно від дій користувача поза ботом. Такий підхід дозволяє будувати складні сценарії взаємодії, коли подальші повідомлення бота залежать від дій користувача на сайті, у вебдодатку або іншому сервісі.

У статті розглянемо, як налаштувати використовувати Умова в ланцюжку.

Додайте елемент

Елемент Умова відстежує подію, яку надсилає ваша система через API.

Коли підписник потрапляє до елементу, система очікує запит від зовнішнього сервісу. Після отримання події сценарій продовжиться.

Перетягніть елемент Умова у потрібне місце ланцюжка чат-бота.

Наразі доступна тільки одна умова — Подія А360, про яку піде мова і статті. Вона відрізняється від тригера запуску ланцюжка Подія A360 тим, що дозволяє продовжити поточний ланцюжок і реалізувати сценарій комунікації.

Налаштуйте передачу даних

Елемент Умова генерує унікальний URL — ендпоінт SendPulse. Умова спрацює, коли на цей URL надійде запит. Щоб подія була застосована до конкретного підписника, зовнішній сервіс має також передати ID підписника чат-бота.

Ідентифікувати користувача на вашому сайті можна через ID підписника.

Виконайте запит

У полі Продовжити ланцюжок після отримання даних на посилання скопіюйте URL-адресу та передайте у ваш зовнішній сервіс. Саме на цей URL сформуйте запит у форматі JSON із даними події.

У запиті можете використовувати користувацькі та глобальні змінні вашого чат-бота та модифікувати їх.

Також передайте отриманий ID підписника одним з двох способів:

Щоб переглянути, яку структуру даних варто використовувати, натисніть Приклад запиту для відправки.

Щоб перевірити запит та отримати дані у відповідь, натисніть Слухати запит зараз (Listen to request now). У разі успішного запиту ви отримаєте тіло відповіді.

Зберігайте дані у змінні

Налаштуйте збереження змінних підписника, отриманих через запит, у змінні підписника чат-бота.

У секції Зберігати значення: налаштування відповідностей (Save values: mapping settings) натисніть Додати (Add). В секції Поле відповіді (Response field) ліворуч виберіть значення змінної, яке будете використовувати, а праворуч — змінну чат-боту, до якої потрібно зберігати значення.

Щоб додати нову змінну, натисніть Створити змінну (Create variable) та введіть значення.

Вкажіть інтервал очікування на подію

Виберіть інтервал очікування події — період часу, протягом якого система очікуватиме виконання умови.

Відлік часу відбувається з моменту, коли підписник дійшов до елементу Умова.

Розгалужте ланцюжок

Після елементу Умова ви можете розгалужувати ланцюжок та додавати блоки по гілках, залежно від виконання умови:

Після отримання події ви можете додати наступні елементи ланцюжка.

Приклад використання

Розглянемо кейс Telegram-магазину з веб-додатком, де ланцюжок чат-бота продовжується після оформлення замовлення на сайті.

Підписник переходить у веб-додаток із ланцюжка бота. Посилання містить ID підписника, який передається як параметр:

https://your-store/store-tg-app.html?contact_id={{contact_id}}

Завдяки цьому веб-додаток отримує ідентифікатор підписника бота.

Ви можете переглянути приклад структури подібного додатку.

Коли користувач обирає товари та оформлює замовлення у веб-додатку, система відправляє POST-запит до SendPulse із даними події:

{
 "chatbots_subscriber_id": "XXXXXXXXXXXXXXXXXXXX",
 "order_items": [...],
 "total_amount": "650",
 "currency": "USD"
}

У запиті передається:

Коли SendPulse отримує подію, система знаходить контакт із відповідним chatbots_subscriber_id і продовжує ланцюжок.

Дані можна використати у наступних блоках сценарію або зберегти у змінні підписника.

Оновлено: 23.03.2026