Як надсилати картки повідомлень у чат-ботах
Ви можете використовувати отриманий масив даних у блоці «Запит API» для створення карток повідомлення. Наприклад, ви можете представити галерею популярних товарів або послуг вашого магазину, список доступних категорій або останніх записів в блозі.
Функція підтримується в Telegram, Instagram і Facebook месенджерах. А для чат-ботів у WhatsApp ви можете використовувати вбудовану функцію «Картка товару».
У статті розглянемо, які параметри можна передавати у відповідь на запит і як налаштувати блок у ланцюжку чат-бота.
Введіть URL-адресу для надсилання запиту
Знайдіть ланцюжок, до якого ви хочете додати надсилання карток, або створіть новий. У конструкторі ланцюжків додайте блок «Запит API» (API request), виберіть GET-метод запиту і вставте в поле «Отримати дані по URL» (Retrieve data from an external URL) посилання на ваш API.
Обов'язково виконайте тестовий запит, натиснувши кнопку «Перевірити запит» (Test request), щоб отримати структуру масиву.
Перейдіть на вкладку «Відправляти повідомлення» (Send messages). У полі «Відправити список повідомлень на основі вказаного масиву» (Send a list of messages based on the specified array) задайте шлях до масиву: його адреса буде виведена у форматі JSON Path ({{$['somekey']['nestedkey']}}). Якщо масив знаходиться у корені JSON, то шлях буде вказано лише символом $.
Налаштуйте відображення отриманих даних
В одному повідомленні ви можете показати до десяти карток, які користувач може передивитись та порівняти, а потім, наприклад, перейти за посиланням до купівлі обраного товару. Таким чином, з масиву будуть виведені лише перші десять елементів із даними.
Виберіть потрібні значення з масиву. У кожному полі картки можна використовувати:
- Відносні адреси відповідних елементів масиву. При цьому порядкові номери елементів на адресі будуть замінені символом
[*], наприклад,{{$['data'][*]['title']}}. - Статичне текстове значення (рядок). Наприклад, посилання
https://shop-example.comабо назва кнопки. - Комбінація адреси в JSON Path і статичного тексту. Наприклад,
Назва: {{$[*]['title']}}. - Відносні адреси відповідних елементів поза масивом.
- Змінні, збережені в аудиторії чат-бота.
Доступні такі параметри:
| URL зображення (Image URL) необов'язковий |
Посилання на зображення для картки. |
| Текст заголовка (Header text) обов'язковий |
Заголовок картки може складатися з декількох елементів масиву, що додаються один за одним. Максимальна довжина заголовка — 80 символів, далі текст буде обрізано. |
| Опис (Description) обов'язковий для Facebook-месенджера |
Опис може складатися з кількох елементів масиву, що додаються один за одним. Максимальна довжина повідомлення — 80 символів, далі текст буде обрізано. |
| Кнопка (Button) необов'язковий |
Кожна кнопка складається з назви та зовнішнього посилання. Можна додати не більше двох кнопок. |
Заповніть поля обраними значеннями.
Щоб зберегти, натисніть «Застосувати» (Apply).
Перевірте результат
Збережіть ланцюжок, запустіть тригер та протестуйте відображення карток у чат-боті.
У Instagram і Facebook-месенджері картки можна перегортати, переміщаючи курсором вліво і вправо.
Оскільки в Telegram-Месенджер немає готової структури «Карусель», то в чат-боті картки відправляються по одній, з можливістю перемкнути слайди за допомогою кнопок вправо і вліво.
У картці ви можете додати тільки посилання з переходом на зовнішній ресурс. Щоб продовжити ланцюжок, вам потрібно з'єднати наступне повідомлення через конектори (у разі помилки — червоний, у разі успішного запиту — зелений).
Вам не вдасться зробити гілку залежно від натиснутої кнопки в картці, тому для вибору потрібного товару ви можете додати на кнопки порядкові номери від 1 до 10 або попросити покупця вказати цифри або назву вподобаного товару.
Оновлено: 22.03.2024
або