> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/instructions/old/vizualnyi-konstruktor-chat-botov/konstruktor/dizain-i-kontent-dlya-scenariya-v-kanalakh.md).

# Дизайн и контент для сценария в каналах

В этом разделе мы поговорим про самую главную составляющую чат-бота в мессенджерах — дизайн сценариев (узлов). Будет рассмотрено, так же, рекомендуемое составление и размещение контента для поддерживаемых каналов (мессенджеров) на платформе 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](https://ru.wikipedia.org/wiki/UTF-8).

Поддержка оформления для текста:

| Ссылка(Link)         | Текст, в формате[название](https://www...)   | -           |
| -------------------- | -------------------------------------------- | ----------- |
| Жирный(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](https://ru.wikipedia.org/wiki/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 символов                      |
| Изображение | Прямая ссылка на файл во внешнем хранилище |
| Документ    | Прямая ссылка на файл во внешнем хранилище |

Поддерживаемые элементы:

1. Сообщение;
2. Сообщение с кнопкой;
3. Медиафайл;
4. Витрина из карточек с кнопками;

#### Канал через API Fasttrack

Официальная страница документации: [https://dashboard.fstrk.io/api/partners/docs/#/1. Методы для интеграции/connector\_create](https://dashboard.fstrk.io/api/partners/docs/#/1.%20%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B%20%D0%B4%D0%BB%D1%8F%20%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8/connector_create)

| Объект      | Допустимое значение (на одно сообщение)    |
| ----------- | ------------------------------------------ |
| Текст       | От 1 до 7000 символов                      |
| Изображение | Прямая ссылка на файл во внешнем хранилище |
| Документ    | Прямая ссылка на файл во внешнем хранилище |

### Советы и рекомендации по созданию контента

А теперь, давайте рассмотрим типовые советы и полезные рекомендации по созданию качественных сценариев в чат-боте для каждого из каналов.

> **Примечание:** Кстати! Данный раздел был составлен, на основании реального опыта команды Fasttrack, за более чем 4-х летний период разработки чат-ботов различной степени сложности и применения.

#### Общие рекомендации (подойдут для всех каналов)

При создании контента для отдельно взятого сценария (экрана), всегда помните:

1. Текст должен быть читаем;
2. Если текста много, то разделите его на смысловые абзацы;
3. Не бойтесь сделать дополнительный перенос текста, если это заголовок к абзацу;
4. Текст должен помещаться в 1 (максимум 1.5) экрана среднего смартфона, чтобы не заставлять пользователя прокручивать сообщение («скроллить»);
5. Медиафайлы (изображения, видео, аудио) и документы (PDF, Excel, Word, …) должны быть хорошего качества и не слишком большими по весу;
6. Ваш пользователь не всегда находится в Wi-Fi сети с быстрым интернетом, поэтому старайтесь держать вес ваших медиафайлов до 250 Кб, а документов — до 1 Мб;
7. При этом, не допускайте откровенно «пиксельных» (сильно сжатых) изображений (видео или аудио), максимальный процент сжатия не должен быть ниже 60%;
8. Выбирайте для отправки только поддерживаемые каналом (мессенджером) форматы медиафайлов и документов, указанные в таблицах выше;

#### Telegram

\[тут описание]

#### Вконтакте (VK)

\[тут описание]

#### Viber

\[тут описание]

#### WhatsApp (регулярные узлы)

> **Примечание:** Важно! Регулярные узлы для канала (мессенджера) WhatsApp могут быть получены пользователем, только если он находится внутри 24-х часового окна с этим чат-ботом. В противном случае — отправка такого сценария (узла) будет вызывать ошибку.

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

* Картинка;
* Текст;
* Блок «Текст с кнопкой»;
* Картинка;
* И так далее…

Тут вы ограничены только своей фантазией и здравым смыслом. Следуйте общим рекомендациям для построения контента, которые были описаны выше.

#### WhatsApp Business API (WABA-шаблоны)

В зависимости от WABA-провайдера (EDNA или SMS Traffic), есть ограничения по контенту, с которым будет зарегистрирован шаблон без ошибок. Самые часто встречающиеся:

* В описании кнопок не должны присутствовать emoji (или спец. символы), только текст;
* В контенте шаблона избегать прямых призывов отправить свои персональные (контактные) данные чат-боту (WABA очень сильно следит за этим);

Отдельно хочу выделить, что необходимо тщательно выбирать контент и аудиторию для рассылки WABA-шаблона, чтобы не допустить жалоб на push-уведомление от чат-бота.

> **Примечание:** В противном случае WABA-провайдеру придется сделать блокировку отправки шаблонов с этого номера телефона (чат-бота) на неопределенное время.

Главные критерии удачной рассылки шаблона:

1. Аудитория, которая получит данный шаблон, его ожидает и/или потенциально заинтересована в его контенте/дальнейшем сценарии/прикрепленных материалах (то есть, это не СПАМ-рассылка «на холодную»);
2. Шаблон решает конкретную задачу аудитории (информирование о заказе, новости сервиса, начисление бонусов, «брошенная корзина», приглашение на вебинар, промокод после покупки акционного товара в вашем интернет-магазине, и так далее и тому подобное);

#### Веб-чат на сайте

В рамках данного канала можно реализовать, практически, такой же внешний вид и функционал, как в мессенджере Вконтакте (VK) или Viber. По этой причине, вы можете следовать рекомендациям, описанным для этих мессенджеров.