Как отправлять карточки сообщений в чат-ботах

Доступно на платном тарифе, а также на время бесплатного семидневного пробного периода

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

Функция поддерживается в Telegram, Instagram и Facebook мессенджерах. А для чат-ботов в WhatsApp вы можете использовать встроенную функцию «Карточка товара».

В статье рассмотрим, какие параметры можно передавать в ответ на запрос и как настроить блок в цепочке чат-бота.

Задайте URL-адрес для отправки запроса

Найдите цепочку, в которую вы хотите добавить вывод карточек, или создайте новую. В конструкторе цепочек добавьте блок «Запрос API», выберите GET-метод запроса и вставьте в поле «Получить данные по URL» ссылку на ваш API.

Обязательно выполните тестовый запрос, нажав на кнопку «Проверить запрос», чтобы получить структуру массива.

Перейдите на вкладку «Отправлять сообщения». В поле «Отправить список сообщений на основе указанного массива» задайте путь к массиву: его адрес будет выведен в формате JSON Path ({{$['somekey']['nestedkey']}}). Если массив находится в корне JSON, то путь будет указан только символом $.

Настройте отображение полученных данных

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

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

  • Относительные адреса подходящих элементов массива. При этом порядковые номера элементов в адресе будут заменены символом [*], например, {{$['data'][*]['title']}}.
  • Статичное текстовое значение — строка. Например, ссылка https://shop-example.com или название кнопки.
  • Комбинация адреса в JSON Path и статичного текста. Например, Название: {{$[*]['title']}}.
  • Относительные адреса подходящих элементов вне массива.
  • Переменные, сохраненные в аудитории бота.

Доступны следующие параметры:

URL изображения
необязательный
Ссылка на изображение для карточки.
Текст заголовка
обязательный
Заголовок карточки, может складываться из нескольких элементов массива, добавляемых друг за другом. Максимальная длина заголовка — 80 символов, дальше текст будет обрезан.
Описание
обязательный для Facebook-мессенджера
Описание, может складываться из нескольких элементов массива, добавляемых друг за другом.
Максимальная длина сообщения — 80 символов, дальше текст будет обрезан.
Кнопка
необязательный
Каждая кнопка состоит из названия и внешней ссылки.
Можно добавить максимум две кнопки.

Заполните поля выбранными значениями.

Чтобы сохранить, нажмите «Применить».

Проверьте результат

Сохраните цепочку, запустите триггер и протестируйте отображение карточек в чат-боте.

В Instagram и Facebook-мессенджере карточки можно пролистывать, перемещая курсором влево и вправо.

Поскольку в Telegram-мессенджере нет готовой структуры «Карусель», то в чат-боте карточки отправляются по одной, с возможностью переключиться между слайдами с помощью кнопок вправо и влево.

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

Вы не можете разветвить цепочку в зависимости от нажатой кнопки в карточке, поэтому для выбора нужного товара вы можете дописать в кнопки порядковые номера от 1 до 10 или попросить покупателя указать цифры или название понравившегося товара.

    Оцените, насколько полезна статья "Как отправлять карточки сообщений в чат-ботах "

    Оценка: 4 / 5

    Назад

    Как копировать цепочку в новый чат-бот

    Далее

    Как запустить бота по событию А360

    Популярное в нашем блоге

    Попробуйте бесплатный бот для рассылок в Facebook Messenger