Дизайн и контент для сценария в каналах
В этом разделе мы поговорим про самую главную составляющую чат-бота в мессенджерах — дизайн сценариев (узлов). Будет рассмотрено, так же, рекомендуемое составление и размещение контента для поддерживаемых каналов (мессенджеров) на платформе Fasttrack.
Быстрая навигация:
Официальные требования к контенту
Telegram
Вконтакте (VK)
Viber
WhatsApp Business API (WABA-шаблоны)
Одноклассники (ОК)
Веб-чат на сайте
Канал через API Fasttrack
Советы и рекомендации по созданию контента
Общие рекомендации (подойдут для всех каналов)
Telegram
Вконтакте (VK)
Viber
WhatsApp (регулярные узлы)
WhatsApp Business API (WABA-шаблоны)
Веб-чат на сайте
Официальные требования к контенту
У каждого канала (мессенджера) есть перечень требований к отправляемому пользователю контенту. Это может касаться: формата фотографий, количества символов в одном сообщении, размера отправляемого PDF файла, соотношению сторон видео и так далее и тому подобное.
Примечание: Обратите внимание! Требования, которые будут описаны ниже, необходимо строго соблюдать, иначе ваш контент будет или выглядеть плохо, или быть заблокированным самим мессенджером при отправке.
Telegram
Официальная страница документации: https://core.telegram.org/bots/api
Текст
от 1 до 4096 символов
Изображение
Размер: до 10 000 пикселей в сумме (ширина + высота)Расширение файла: любоеВес файла: до 10 Мб (для iOS и Android)
Видео
Продолжительность: любаяРасширение файла: любоеФормат видео: любойВес файла: до 50 Мб (для iOS и Android)
Документ
Имя файла: любой длинныРасширение файла:.gif,.pdf,.zipВес файла: до 20 Мб (для iOS и Android)
Аудио
Расширение файла: -Формат аудио: -Вес файла: до - Мб (для iOS и Android)
Примечание: Обратите внимание! Кодировка вашего текста должна быть в UTF-8.
Поддержка оформления для текста:
Жирный(Bold)
Текст, обрамлённый звездочками*
жирный
Курсив(Italics)
Текст, обрамлённый нижними подчеркиваниями_
курсив
Для кода(Mono)
Текст, обрамлённый апострофами`
код
Для блока кода(Mono)
Текст, обрамлённый тремя апострофами```
блок кода
Вконтакте (VK)
Официальная страница документации: https://vk.com/dev/manuals
Текст
От 1 до 9000 символов
Изображение
Размер: до - пикселейРасширение файла: -Вес файла: до - Мб (для iOS и Android)
Видео
Продолжительность: -Расширение файла: -Формат видео: -Вес файла: до - Мб (для iOS и Android)
Документ
Имя файла: -Расширение файла: -Вес файла: до - Мб (для iOS и Android)
Аудио
Расширение файла: -Формат аудио: -Вес файла: до - Мб (для iOS и Android)
Viber
Официальная страница документации: https://developers.viber.com/docs/api/rest-bot-api/
Текст
От 1 до 7000 символов
Изображение
Размер: от 400x400 пикселейРасширение файла:.jpeg,.pngили.gifВес файла: до 1 Мб (для iOS); до 3 Мб (для Android)
Видео
Продолжительность: не более 180 секундРасширение файла:.mp4Формат видео:MP4,H.264Вес файла: до 26 Мб (для iOS и Android)
Документ
Имя файла (включая расширение): до 256 символовРасширение файла: любое, кромезапрещенныхканаломВес файла: до 50 Мб (для iOS и Android)
Примечание: Обратите внимание! Кодировка вашего текста должна быть в UTF-8.
Поддержка оформления для текста:
Жирный(Bold)
Текст, обрамлённый звездочками*
жирный
Курсив(Italics)
Текст, обрамлённый нижними подчеркиваниями_
курсив
Для кода(Mono)
Текст, обрамлённый тремя апострофами```
код
Зачеркнутый(Strike)
Текст, обрамлённый тильдами~
зачёркнуто
WhatsApp Business API (WABA-шаблоны)
Требования к элементам шаблона:
Не более 3-х кнопок в одном шаблоне;
Нельзя комбинировать кнопки-ссылки на внешние веб-страницы и обычные кнопки, ведущие в другие сценарии (узлы) чат-бота;
Следить за тем, чтобы тема шаблона (тот сценарий, который этим шаблоном должен будет решаться) была выбрана, в соответствии с контентом и действиями кнопок (если они есть);
Одноклассники (ОК)
Официальная страница документации: https://apiok.ru/dev/graph_api/bot_api
Текст
от 1 до - символов
Изображение
Размер: до - пикселейРасширение файла: -Вес файла: до - Мб (для iOS и Android)
Видео
Продолжительность: -Расширение файла: -Формат видео: -Вес файла: до - Мб (для iOS и Android)
Документ
Имя файла: -Расширение файла: -Вес файла: до - Мб (для iOS и Android)
Аудио
Расширение файла: -Формат аудио: -Вес файла: до - Мб (для iOS и Android)
Веб-чат на сайте
Текст
От 1 до 5000 символов
Изображение
Прямая ссылка на файл во внешнем хранилище
Документ
Прямая ссылка на файл во внешнем хранилище
Поддерживаемые элементы:
Сообщение;
Сообщение с кнопкой;
Медиафайл;
Витрина из карточек с кнопками;
Канал через API Fasttrack
Официальная страница документации: https://dashboard.fstrk.io/api/partners/docs/#/1. Методы для интеграции/connector_create
Текст
От 1 до 7000 символов
Изображение
Прямая ссылка на файл во внешнем хранилище
Документ
Прямая ссылка на файл во внешнем хранилище
Советы и рекомендации по созданию контента
А теперь, давайте рассмотрим типовые советы и полезные рекомендации по созданию качественных сценариев в чат-боте для каждого из каналов.
Примечание: Кстати! Данный раздел был составлен, на основании реального опыта команды Fasttrack, за более чем 4-х летний период разработки чат-ботов различной степени сложности и применения.
Общие рекомендации (подойдут для всех каналов)
При создании контента для отдельно взятого сценария (экрана), всегда помните:
Текст должен быть читаем;
Если текста много, то разделите его на смысловые абзацы;
Не бойтесь сделать дополнительный перенос текста, если это заголовок к абзацу;
Текст должен помещаться в 1 (максимум 1.5) экрана среднего смартфона, чтобы не заставлять пользователя прокручивать сообщение («скроллить»);
Медиафайлы (изображения, видео, аудио) и документы (PDF, Excel, Word, …) должны быть хорошего качества и не слишком большими по весу;
Ваш пользователь не всегда находится в Wi-Fi сети с быстрым интернетом, поэтому старайтесь держать вес ваших медиафайлов до 250 Кб, а документов — до 1 Мб;
При этом, не допускайте откровенно «пиксельных» (сильно сжатых) изображений (видео или аудио), максимальный процент сжатия не должен быть ниже 60%;
Выбирайте для отправки только поддерживаемые каналом (мессенджером) форматы медиафайлов и документов, указанные в таблицах выше;
Telegram
[тут описание]
Вконтакте (VK)
[тут описание]
Viber
[тут описание]
WhatsApp (регулярные узлы)
Примечание: Важно! Регулярные узлы для канала (мессенджера) WhatsApp могут быть получены пользователем, только если он находится внутри 24-х часового окна с этим чат-ботом. В противном случае — отправка такого сценария (узла) будет вызывать ошибку.
Внутри регулярных узлов допускается создавать (практически) любые последовательности объектов WhatsApp. Вы легко можете создать, например, вот такой сценарий в одном узле:
Картинка;
Текст;
Блок «Текст с кнопкой»;
Картинка;
И так далее…
Тут вы ограничены только своей фантазией и здравым смыслом. Следуйте общим рекомендациям для построения контента, которые были описаны выше.
WhatsApp Business API (WABA-шаблоны)
В зависимости от WABA-провайдера (EDNA или SMS Traffic), есть ограничения по контенту, с которым будет зарегистрирован шаблон без ошибок. Самые часто встречающиеся:
В описании кнопок не должны присутствовать emoji (или спец. символы), только текст;
В контенте шаблона избегать прямых призывов отправить свои персональные (контактные) данные чат-боту (WABA очень сильно следит за этим);
Отдельно хочу выделить, что необходимо тщательно выбирать контент и аудиторию для рассылки WABA-шаблона, чтобы не допустить жалоб на push-уведомление от чат-бота.
Примечание: В противном случае WABA-провайдеру придется сделать блокировку отправки шаблонов с этого номера телефона (чат-бота) на неопределенное время.
Главные критерии удачной рассылки шаблона:
Аудитория, которая получит данный шаблон, его ожидает и/или потенциально заинтересована в его контенте/дальнейшем сценарии/прикрепленных материалах (то есть, это не СПАМ-рассылка «на холодную»);
Шаблон решает конкретную задачу аудитории (информирование о заказе, новости сервиса, начисление бонусов, «брошенная корзина», приглашение на вебинар, промокод после покупки акционного товара в вашем интернет-магазине, и так далее и тому подобное);
Веб-чат на сайте
В рамках данного канала можно реализовать, практически, такой же внешний вид и функционал, как в мессенджере Вконтакте (VK) или Viber. По этой причине, вы можете следовать рекомендациям, описанным для этих мессенджеров.
Last updated