как сделать меню в телеграмм канале
Telegram — бот | Полноценное меню
Рано или поздно, в жизни разработчика телеграмм-ботов приходит чёткое осознание, того что всё бренно нужно создавать более-менее полноценные меню для ботов.
А) Это удобно
Б) Удобно для кастомизации*
Никто, конечно же, не отменял «/команды», но всё же
Суть задачи
Немного подробнее: Используя метод getUpdate — вы получаете объект Update, логично же! Так вот, этот объект содержит много чего полезного, включая информацию о сообщении, но только о последнем. В этом и загвоздка
Исходя из выше описанного следует не самый приятный вывод — обработка запросов по вебхуку, без хранения дополнительных данных, нам не светит…
Ну что же, умываемся и приступаем к работе.
Написание Изучение кода
В своей практике, специально под эту задачу, был разработан небольшой класс.
Если не терпится, то можете сразу переходить на репозиторий, там есть экскурс.
Продолжим
Согласен, концепция, после этого, понятной не стала… Попытаюсь разъяснить. Для понимания нужно перейти на некий уровень абстракции, то есть представьте что вся структура бота состоит из разных меню, между которыми переключается юзер(можно провести аналогию с активити андроида). При активации бота пользователь оказывается в «начальном меню», из которого он может перейти, допустим, в меню «Настройка», «Информация», и тд.
И так, структура бота немного меняется, если вкратце:
В начале проверяем, существует ли запрос:
ДА ) Запускаем «обработчик» запросов
НЕТ) Остаёмся в «начальном меню», сверяем ответ юзера с доступными командами.
*это сильно упрощённый вариант, из-за этого сбивает столку. С примерами станет проще.
Продолжим.
Начнём с установки. Для установки воспользуемся compser-ом(создаём «composer.json», после копируем в него строки ниже, подробнее читайте в офф. доках)
ИЛИ подключаем вручную(скачиваем в папку с проектом)
СОЗДАЁМ ЗАПРОС, ПРОВЕРЯЕМ ЕГО НАЛИЧИЕ И ЗАПУСКАЕМ ОБРАБОТКУ
ПРЯЧЕМ И ДОСТАЁМ ВРЕМЕННЫЕ ДАННЫЕ
Следует заметить, что каждая[за исключением GetFromTemp(),GetError(),ReqCheck() и конструктора] функция, возвращает массив:
Каждая функция [за исключением GetFromTemp(),GetError(),ReqCheck() и конструктора], устанавливают ошибку, в случае неудачи, которую можно проверить с помощью:
Всё собрали, в путь!
NEW! решение обхода «проблемы» с https).
Воплотим в жизнь, данный пример. Разделим пространство на два файла «botmain.php»(основное меню и обработка) и «varfunc.php»(функции обработки запросов). Для лёгкости примера будем использовать telegram-bot-sdk(хорошо сделанный и оформленный проект, удобно для небольших проектов, спасибо создателю;).
Далее в папке проекта открываем консоль и…
UPD: В рамках Хабра исходный код становится нечитабельным, без глобальной правки. Из-за этого, если вас интересуют примеры, предлагаю вам перейти на гитхаб.
Навигация в каналах и группах
Навигация будет полезна в каналах с большим количеством постов для создания подборок тематических или для выделения из общей массы особо важных записей. Например, делаете рекламу канала, а чтобы показать ценность содержимого канала, создаете пост со списком особо интересных записей в канале и ссылками на каждую из записей в этом списке.
Канал-книга должен обязательно включать в себе пост с содержанием. Например, содержание в книге «100 советов админу в Telegram» всегда доступно по ссылке — это содержание периодически меняется и обновляется. Всегда показывается в закрепе канала для удобного доступа к нему.
Как создать навигацию по каналу или группе?
Добавляете записи
У Вас должны быть добавлены записи которые будут участвовать в навигации. Начинайте с наполнения канала интересными постами.
Копируем ссылки на записи
Для навигации вам потребуются ссылки на записи, которые получаем через дополнительное меню.
В Telegram Desktop надо кликнуть по посту правой кнопкой мыши для вызова дополнительного меню и в появившемся меню нажать «Копировать ссылку». В телефоне просто кликнуть по записи и в появившемся меню кликнуть «Копировать ссылку». Ссылка будет скопирована в буфер обмена Вашего устройства — вам остается добавить ее в нужный текст.
Есть нюансы
Если в приватном Telegram-канале создать меню, то оно будет работать только для подписчиков. Если такое меню репостнуть в другое место — не подписчики не смогут перейти по ссылкам в меню.
Если создать меню для публичного канал и закрыть канал — меню перестанет работать. Изменятся постоянные ссылки на записи канала.
Обязательно! Создавайте и публикуйте меню в канале только через бота — например, использую для публикации постов в канале, бота @ControllerBot. Записи добавленные без бота вы не сможете изменить через 40 часов, а добавленные через бота можно и через год редактировать.
Примеры навигации по записям и каналам
Список с ссылками на примеры также можно назвать меню навигации по записям в каналах.
Как создать меню для Telegram бота
Чтобы создать меню бота, на странице чат-бота откройте вкладку «Меню» и нажмите «Добавить элемент».
Введите название команды. Можно использовать до 30 символов в поле: латинские буквы, цифры и знак «_».
Введите описание — то, для чего можно использовать данную команду. В этом поле можно ввести до 200 различных символов, а также добавить эмодзи.
Выберите цепочку, которая запустится после выбора команды из списка.
Нажмите “Добавить”, чтобы добавить команду в меню.
Расширяйте меню дополнительными командами с помощью кнопки «Добавить элемент». После создания команд нажмите «Сохранить», чтобы сохранить созданные элементы.
Меню с командами готово к работе.
Вы также можете создать клавиатурное меню для пользователя из кнопок «Быстрые ответы». Вы можете добавить до 10 таких кнопок и добавить в них эмодзи.
Они отображаются у пользователя под полем ввода текста, скрываются при нажатии на соответствующий значок и пропадают после отправки следующего сообщения.
Оценка: 4 / 5 (22)
Навигация в каналах и группах
Совет для админа Telegram №72 (Навигация в каналах и группах).
Навигация будет полезна в каналах с большим количеством постов для создания подборок тематических или для выделения из общей массы особо важных записей. Например, делаете рекламу канала, а чтобы показать ценность содержимого канала, создаете пост со списком особо интересных записей в канале и ссылками на каждую из записей в этом списке.
Канал-книга должен обязательно включать в себе пост с содержанием. Например, содержание в книге «100 советов админу в Telegram» всегда доступно по ссылке — это содержание периодически меняется и обновляется. Всегда показывается в закрепе канала для удобного доступа к нему.
Как создать навигацию по каналу или группе?
Добавляете записи
У Вас должны быть добавлены записи которые будут участвовать в навигации. Начинайте с наполнения канала интересными постами 🙂
Копируем ссылки на записи
Для навигации вам потребуются ссылки на записи, которые получаем через дополнительное меню.
В Telegram Desktop надо кликнуть по посту правой кнопкой мыши для вызова дополнительного меню и в появившемся меню нажать «Копировать ссылку». В телефоне просто кликнуть по записи и в появившемся меню кликнуть «Копировать ссылку». Ссылка будет скопирована в буфер обмена Вашего устройства — вам остается добавить ее в нужный текст.
Есть нюансы
Если в приватном Telegram-канале создать меню, то оно будет работать только для подписчиков. Если такое меню репостнуть в другое место — не подписчики не смогут перейти по ссылкам в меню.
Если создать меню для публичного канал и закрыть канал — меню перестанет работать. Изменятся постоянные ссылки на записи канала.
Примеры навигации по записям и каналам
Список с ссылками на примеры также можно назвать меню навигации по записям в каналах 🙂
IoBroker. Inline меню для Telegram бота
В этой статье мы с вами по шагам будем создавать меню для telegram бота Умного Дома. Рекомендую изучить минимальные азы по языку программирования JavaSсript, это облегчит понимание того, что тут вообще происходит.
Приготовления
При увеличении количества написанных скриптов, будет нарастать бардак в дереве, поэтому рекомендую сразу приучать себя разбивать скрипты по группам.
Добавим новую группу в папку common
И назовем ее например Telegram. В этой группе в дальнейшем можно будет создавать все скрипты, которые будут относиться к работе с драйвером Telegram.
Вот теперь можно добавить наш будущий скрипт для меню. Для этого надо выделить созданную группу Telegram и нажать кнопку Новый скрипт
Поменяем имя на Телеграм бот, и сохраним изменения.
Все готово к созданию меню для Умного дома.
Создаем Меню
Предварительно необходимо на листике или в уме подготовить набросок древовидной структуры будущего меню
В этой статье попробуем реализовать подобную структуру меню.
Не обязательно придерживаться разбиения по комнатам, рекомендую в основные ветки выносить управление тем, что чаще всего используется, т.к. допустим для запуска Сцены 3 в зале надо сделать целых 4 нажатия!
Ежедневно запускать сценарий по такому длинному пути быстро надоест 🙂
Набросаем наше дерево в скрипте
В первой строке в квадратных скобках перечисляются основные кнопки (ветки) меню, плюс дополнительно добавляется кнопка Закрыть. Она позволит закрывать меню в чате бота, чтобы у нас не получилось куча сообщений от бота с открытыми менюшками. Ну и в конце текст в кавычках ‘Меню’ тоже обязателен. В этом месте будет указываться название вышестоящей ветки меню, т.к. первая строка уже является верхушкой дерева, то текст в этом месте дублирует начало.
Отступы для каждой строки сделаны лишь для удобства восприятия структуры меню и никакой функциональности не несут.
Внимательный читатель, надеюсь, обратил внимание что названия веток меню в наброске и в коде отличаются 🙂 Почему так сделано, будет описано дальше.
Дальнейший код будет описан только в объеме, необходимом для оформления своего меню, плюс краткое пояснение функций.
Добавляем в скрипт весь остальной код.
Уже на этом этапе можно проверить работу меню. Для этого сохраняем скрипт, запускаем и в Telegram отправляем боту слово Меню (внимание, слово должно быть с большой буквы) или Кнопки.