Ни мессенджер, ни движок телеграм-бота Корбот не предъявляют жёстких требований к текстам кнопок и содержимому сообщений (разве что, за исключением длины текста). Тем не менее, с какими-то ботами работать удобно, а с какими-то — нет. Мы проанализировали телеграм-ботов, которых считаем удобными сами, и по результатам создали этот гайдлайн по оформлению страниц. Мы придерживаемся этих рекомендаций в наших разработках, и практика показала, что многие пользователи высоко оценивают удобство работы с нашими ботами. Нам и самим нравится.
- Эмодзи в кнопках
- Выбор идентификаторов страниц
- Позиция кнопки в строке
- «Продолжить чтение»
- Форматирование текста
- Прочие элементы
Эмодзи в кнопках
В тексты кнопок телеграм-бота имеет смысл включать эмодзи. Взять их можно из меню эмодзи в строке ввода в Telegram или в каталогах, например, здесь.
Рекомендуем отделять эмодзи от текста кнопки пробелом.
Мы рекомендуем подбирать эмодзи так, чтобы на одном уровне меню не было одинаковых иконок.
Выбор идентификаторов страниц
Идентификаторы («ID страницы») страниц лучше выбирать с учётом того, что в дальнейшем вам может потребоваться вставлять новые страницы между теми, которые уже создавались ранее. С простой сквозной нумерацией это может быть не очень удобно. Мы используем сами и рекомендуем вам попробовать схему нумерации идентификаторов, которая учитывает вложенность инфостраниц.
Например, вы хотите создать следующую иерархию страниц:
- Ствол 1
- Ветка
- Лист 1
- Ветка Б
- Лист 2
- Лист 3
- Ветка
- Ствол 2
- Лист 4
- Ветка В
- Лист 5
Идентификаторы страниц можно сделать такими:
Мы не рекомендуем размещать на одном уровне меню больше 10 страниц (кнопок).
Позиция кнопки в строке
Кнопки в меню телеграм-бота можно отображать как по одной на строку, так и по две или три, если это позволяет длина текста кнопки. Отображение кнопок регулируется значением 1, 2, 3 в колонке Позиция в соответствующей строке.
Для расположения всех кнопок по одной на строку:
Кнопки 1 и 2 на одной строке, остальные — по одной на строку:
Рекомендуем давать кнопкам короткие названия и размещать по 2-3 кнопки на строку.
Обратите внимание: Telegram может обрезать слишком длинный текст кнопок. Рекомендуем проверять внешний вид кнопок бота отдельно на десктопной и мобильной версиях мессенджера.
Кнопку с длинным текстом лучше размещать одну на строке.
«Продолжить чтение»
Длинные тексты можно разбить на последовательность сообщений. Можно сделать так, чтобы все сообщения последовательности отправились сразу друг за другом (заполнением столбца «ID предыдущей страницы»), а можно так, чтобы пользователь получил следующее сообщение, когда дочитает предыдущее и кликнет кнопку «Продолжить чтение». Вот как это организовать:
— Разбить текст на части, для каждой части создать отдельную инфостраницу (каждую часть текста прописать отдельной строкой).
— Установить ID родительской страницы по принципу: ID текущей страницы является ID родительской страницы для следующей страницы.
— Последней строкой создаем инфостраницу (кнопку) “Вернуться в раздел”. Для неё в столбце “Команда” прописать команду перехода на страницу, на которую нужно будет вернуться при клике, например /page 1 — переход на инфостраницу с ID 1.
— Если нужно вернуться в главное меню, установить текст пункта в меню “В меню” и команду /menu.
В столбце “Не показывать в меню” установить значение Y.
Форматирование текста
Telegram поддерживает разметку текста html-тегами <b>, <i>, <u>, <s>, <code> и <a>
Ссылки
Ссылка в тексте добавляется следующим образом:
<a href="https://corebot.ru">Корбот</a>Прочие элементы
Здесь Корбот — это слово, при клике на которое пользователь будет переходит на https://corebot.ru. Фрагмент можно написать:
— Жирным, используя тег <b>Текст</b>,
— Курсивом: <i>Текст</i>,
— Подчеркнутым: <u>Текст</u>
— Перечёркнутым: <s>Текст</s>
— Моноширинным: <code>Текст</code>
Если в тексте инфостраницы бота есть список, то для обозначения элементов списка можно использовать эмодзи или спецсимволы в табличном редакторе.
Если текст страницы представляет собой текст с заголовком, заголовок можно выделить жирным.
Полотна текста, может, и легко писать, но читать их в телеграм-боте тяжело. Если возможно, не пишите длинные тексты инфостраниц совсем. Если текст обязательно нужен длинный — разбивайте его на абзацы по 1-3 предложения, добавляйте заголовки и эмодзи.
