Inline режим Telegram что это

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

Благодаря встроенному режиму, боты стали вездесущими: вы можете обращаться к роботам в любом чате, группе или канале — совершенно не важно, является ли бот участником группы или канала, или нет. Встроенные боты могут выполнять практически любые задачи — например, быстро отправить GIF, картинку, видео с YouTube, статьи с Wikipedia, и т. д.

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

Инлайн режим Telegram inline бот на python aiogram

Встроенные боты, как, впрочем, и всё остальное в Telegram, являются частью открытой платформы, доступной для любого разработчика в любой стране. Совсем скоро появятся сотни встроенных ботов — сразу, как только разработчики начнут разбираться с новым режимом.

Добрый день. Есть код телеграм бота, который выводит 4 кнопки и при нажатии на каждую из них выводится сообщение.

Как сделать, что бы при нажатии на кнопку — открывалось новое меню из нескольких кнопок, с возможностью вернутся к главному меню?

Т.е. нужно при вводе пользователем части команды сразу выводить ему возможные варианты. Использую python и модули telebot с pyTelegramBotAPI.

2 ответа 2

Столкнулся с тем же вопросом и вижу что уже неактуальный топик. Но просто оставлю это здесь:

• включить через ОтецБот’а BotSettins -> Inline Mode -> «Turn on»
• о реализация в боте, не плохой лессон: https://groosha.gitbook.io/telegram-bot-lessons/chapter7

Всё ещё ищете ответ? Посмотрите другие вопросы с метками telegram-bot или задайте свой вопрос.

Связанные

Похожие

Для подписки на ленту скопируйте и вставьте эту ссылку в вашу программу для чтения RSS.

Источник: teh-fed.ru

Инструкция по созданию Telegram ботов. Часть 6. Делаем пользовательскую клавиатуру для бота

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

Пользовательские клавиатуры в Telegram бывают двух видов: Inline и Reply.

Inline (встроенные)-клавиатуры просто добавляют кнопки внизу сообщения, вот так:

Эти клавиатуры привязаны к конкретному сообщению (как бы встроены в чат) и не подменяют собой традиционную клавиатуру, которая всё так же всплывает при нажатии на поле ввода текста. Главная особенность inline-клавиатур заключается в том, что нажатие на их кнопки не вызывает отправку в чат каких-либо сообщений, вместо этого генерируется некоторое «закулисное» событие: обратный вызов (callback), открытие URL или другого чата во встроенном режиме.

Интересной фишкой подобных клавиатур является возможность правки «на лету» сообщений, к которым они привязаны.

Reply-клавиатуры (клавиатуры для ответа) напротив, не привязаны к конкретному сообщению и подменяют (или дополняют) в чате с ботом традиционную клавиатуру. Эти клавиатуры вызывают отправку сообщений в чат и выглядят вот так:

Для того, чтобы сгенерировать какую-либо пользовательскую клавиатуру — нужно при обращении к одному из предназначенных для отправки данных API-методов (например, при к SendMessage) задать параметр reply_markup, описывающий объект типа InlineKeyboardMarkup — для создания inline-клавиатуры, или объект типа ReplyKeyboardMarkup — для создания reply-клавиатуры. Подробнее о том, к каким методам можно прицепить reply_markup, а к каким — нет, можно прочитать в документации.

Описывающие клавиатуры объекты представляют собой многомерные массивы, содержащие наборы записей о каждой из кнопок (подпись, данные колбэка, открываемый при нажатии url и так далее).

Таким образом, для генерирования клавиатуры нам нужно сформировать в коде соответствующего типа объект, описывающий создаваемую клавиатуру (назовём этот объект, например, $keyboard), закодировать этот объект в виде json-строки и добавить эту json-строку в качестве параметра reply_markup при отправке запроса (GET или POST) telegram-боту.

Пример создания inline-клавиатуры (php)

// создаём $keyboard — объект, описывающий клавиатуру
$keyboard = [
«inline_keyboard» =>
[ /* первый ряд кнопок — массив из наборов */
[ /* первые две кнопки вызывают колбэк, а третья — открытие url-а */
[ «text» => «button 1»,
«callback_data» => «data 1»
],
[ «text» => «button 2»,
«callback_data» => «data 2»
],
[ «text» => «button 3»,
«url» => $any_url
]
]
/* здесь мог бы быть второй массив для второго ряда кнопок и так далее */
]
];
.
.
// далее нужно просто добавить этот параметр в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$keyboard_json = json_encode($keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описанием нашей клавиатуры
$url=$telegram_api_url.$bot_token.’/sendMessage?chat_id=’.$chat_id.’parse_mode=HTML’.’
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url

Пример создания reply-клавиатуры (php)

// создаём $keyboard — объект, описывающий клавиатуру
$keyboard = [
«keyboard» =>
[ /* первый ряд кнопок — массив из наборов */
[ /* перва кнопка отправляет команду /any_command в виде текстового сообщения, вторая — данные геолокации */
[ «text» => «/any_command»
],
[ «text» => «my location»,
«request_location» => true
]
]
/* здесь мог бы быть второй массив для второго ряда кнопок и так далее */
]
];
.
.
// далее нужно просто добавить этот параметр в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$keyboard_json = json_encode($keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описанием нашей клавиатуры
$url=$telegram_api_url.$bot_token.’/sendMessage?chat_id=’.$chat_id.’parse_mode=HTML’.’
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url

Поскольку inline-клавиатуры привязаны к конкретным сообщениям, то с каждым новым сообщением нужно генерировать новую inline-клавиатуру. С reply-клавиатурами ничего подобного делать не нужно. Будучи однажды сгенерированной, такая клавиатура будет заменять дефолтную до тех пор, пока её не удалят или не заменят другой reply-клавиатурой.

Для удаления reply-клавиатуры нужно в параметре reply_markup послать объект, типа ReplyKeyboardRemove.

Пример удаления reply-клавиатуры (php)

// создаём $remove_keyboard — объект, описывающий удаление reply-клавиатуры
$remove_keyboard = [
«remove_keyboard» => true
];
.
.
// далее нужно просто добавить этот объект в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$remove_keyboard_json = json_encode($remove_keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описывающим удаление клавиатуры объектом
$url=$telegram_api_url.$bot_token.’/sendMessage?chat_id=’.$chat_id.’parse_mode=HTML’.’
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url

Одна из прикольных фишек inline-клавиатур — возможность «на лету» править сообщения, к которым эти клавиатуры привязаны. Как я уже писал выше, нажатие на кнопки inline-клавиатур не вызывает отправку сообщений в чат, но то же время, получив callback мы всегда можем понять, к какому сообщению была привязана нажатая кнопка. Остаётся только исправить это сообщение при помощи одного из методов Updating messages.

Как получить callback? Для этого просто нужно запросить, получить и обработать очередной update, если бот работает через longpolling, или выполнить только два последних пункта, если бот работает через webhook (в этом случае, как вы помните, ничего запрашивать не нужно, так как телега сама знает по какому адресу отправлять апдейты). Данные колбэка будут содержаться в поле «callback_query» полученного апдейта.

Пример апдейта, полученного после нажатия на одну из кнопок inline-клавиатуры

» [
«update_id»:xxxxxxxxxx,
«callback_query»:
«id»:»xxxxxxxxxxx»,
«from»:
«id»:xxxxxxxxx,
«first_name»:»xxxxxxx»,
«last_name»:»xxxxxxx»,
«username»:»xxxxxxxxx»,
«language_code»:»ru»
>,
«message»:
«message_id»:xxxx,
«from»:
«id»:xxxxxxxxx,
«first_name»:»xxxxxxxx»,
«username»:»xxxxxxx»
>,
«chat»:
«id»:xxxxxxxx,
«first_name»:»xxxxxxx»,
«last_name»:»xxxxxxxx»,
«username»:»xxxxxxx»,
«type»:»private»
>,
«date»:1499854111,
«text»:»test»
>,
«chat_instance»:»xxxxxxxxxxxx»,
«data»:»1″
>
>
]
>»

Остаётся только выделить из апдейта данные, однозначно указывающие на само это сообщение (идентификатор чата и идентификатор сообщения), а также на нажатую кнопку и, собственно, отредактировать исходное сообщение. Понять какую именно кнопку нажали можно по содержимому поля «data» в полученном «callback_query». В этом поле будет содержаться информация, которую мы вписали
в поле «callback_data» для соответствующей кнопки при создании inline-клавиатуры.

Пример редактирования сообщения налету

// если мы определили, что нам прилетел именно колбэк (по наличию поля «callback_query»), то:
// выделяем из этого колбэка необходимые для редактирования сообщения данные
$chat_id = $input_array[‘callback_query’][‘message’][‘chat’][‘id’]; // идентификатор чата
$message_id = $input_array[‘callback_query’][‘message’][‘message_id’]; //идентификатор сообщения
$data = $input_array[‘callback_query’][‘data’]; // данные, которые были отправлены при нажатии на кнопку
.
.
// далее нужно просто выполнить запрос (GET или POST), обратившись, например, к методу editMessageText
$url=$telegram_api_url.$bot_token.’/editMessageText?chat_id=’.$chat_id.’text=’.urlencode($edited_message).’
// $edited_message — отредактированный текст сообщения
// $keyboard_json — клавиатура, которая будет содержаться в отредактированном сообщении
file_get_contents($url); // отправляем get-запрос на сформированный url

Вот и всё. Как видите, всё достаточно просто и понятно. В telegram вообще всегда всё просто, понятно и подробно описано. Вообще не понимаю, зачем нужны всякие библиотеки и фреймворки. Все они выглядят гораздо страшнее и монструознее, чем исходные описания из API. Это при том, что все эти фреймворки добавляют коду веса, ошибок и нестабильности. Уф, надо вступить в какое-нибудь движение за чистоту кода. Ну ладно, это я уже отвлёкся. Пока!

1. Часть 1. Что такое Telegram боты и как они работают
2. Часть 2. Регистрация аккаунтов Telegram ботов в картинках
3. Часть 3. Пишем простого чат-бота для Telegram на чистом php (webhook)
4. Часть 4. Прикручиваем MySQL к чат-боту для Telegram на php (webhook)
5. Часть 5. Пишем Telegram бота на php для работы через longpolling
6. Часть 6. Делаем пользовательскую клавиатуру для бота
7. Дополнение. Как отправлять правильные https-запросы через curl и при чём здесь SSL-cертификаты

Понравилась статья? Поделись с друзьями!

Источник: radiohlam.ru

Telegram Bot на Python 3

В данной статье мы напишем telegram bot на python, который сможет отвечать на наши сообщения, взаимодействовать с нами, предлагая варианты ответов в виде кнопок и обрабатывать выбранный нами результат, выполняя команды на сервере. Взаимодействовать с Telegram Bot Api мы будем с помощью библиотеки pyTelegramBotAPI (telebot) написанной на Python.

1. Создание бота
2. Установка Python и библиотеки pyTelegramBotAPI
3. Пишем Telegram Bot на Python
4. Использование прокси в telebot
5. Ответы бота на сообщения пользователя
6. Клавиатура в Telegram Bot API
7. InLine клавиатура
8. Конечный листинг

Создание бота

Для регистрации нового бота необходимо обратиться к боту BotFather. Для этого в строке поиска наберите BotFather и в показанных результатах найдите интересующего нас бота:

Обратите внимание на его имя, изображение и знак в виде галочки, говорящий о том, что это действительно отец всех ботов.

Выберите его и в диалоговом окне напишите команду /start и бот в ответном сообщение пришлет список всех доступных команд:

Нас интересует создание нового бота, поэтому выбираем команду /newbot. Команду можно как напечатать самостоятельно, так и выбрать мышью в сообщении и она автоматически отправится:

Первым шагом нам предлагают дать имя новому боту, оно может быть произвольным. Мы назовем его PocketAdmin:

Теперь требуется указать идентификатор бота (username), он должен заканчиваться на _bot и быть уникальным в системе. Мы укажем PocketAdminTech_bot:

На этом создание бота завершено. В последнем сообщении нам пришла ссылка на нашего нового бота t.me/PocketAdminTech_bot и токен (закрашен), необходимый для взаимодействия с API.

Обязательно сохраните токен и храните его в тайне!

Установка Python и библиотеки pyTelegramBotAPI

Скачать Python можно с официального сайта (как установить пакет на Centos 8 можно ознакомиться в данной заметке) и мы не будем заострять внимание на данном вопросе.

Чтобы установить пакет pyTelegramBotAPI воспользуемся pip:

pip install pytelegrambotapi

На этом подготовительная работа завершена, приступаем непосредственно к написанию нашего бота.

Пишем Telegram Bot на Python

Так как наш бот создается в ознакомительных целях и не будет содержать много кода, то писать я его буду сразу на сервере с установленной Centos 8 используя обычный редактор nano. Создадим файл bot.py, открыв его nano:

nano bot.py

Для начала импортируем библиотеку pyTelegramBotAPI:

import telebot

Затем зададим переменную token равную нашему токену, который мы получили от BotFather для взаимодействия с Telegram Bot Api:

token = ‘ваш token api’
bot = telebot.TeleBot(token)

Далее задается декоратор. Пока наш бот будет обрабатывать только команду start:

и в ответ писать нам “Привет!”:

def start_message(message): bot.send_message(message.chat.id, ‘Привет!’)

Чтобы бот постоянно ожидал запрос от пользователя в конце пропишем:

bot.polling()

В итоге мы получим код:

python bot.py

Затем откроем нашего бота (можно найти по имени) и напишем ему команду /start:

Поздравлю с первыми словами нашего бота PocketAdmin!

Использование прокси в telebot

При запуске скрипта может появиться ошибка следующего вида:

requests.exceptions.ConnectionError: (‘Connection aborted.’, ConnectionResetError(104, ‘Connection reset by peer’))

Чтобы исправить её, можно попробовать подключиться через прокси:

Если при использовании прокси возникают ошибки, подобные: Not supported proxy scheme socks5 или Missing dependencies for SOCKS support, то необходимо установить модули:

pip install requests[socks] PySocks

Ответы бота на сообщения пользователя

Аналогично хэндлерам для команд, в telegram bot api есть возможность обрабатывать сообщения от пользователя. Для этого используется тип text. Например, мы можем запрограммировать бота отвечать на определенные фразы или слова пользователя:

Думаю тут все понятно. На слово “Привет” бот будет отвечать “Ещё раз привет!”, а на “Пока” – “Пока!”. Весь код нашего telegram bot на python теперь будет выглядеть следующим образом:

Перезапустим скрипт и пообщаемся с ботом:

Таким образом мы можем описывать различные диалоги с ботом.

Клавиатура в Telegram Bot на Python

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

Добавим в обработчик команды /start клавиатуру с кнопками “Привет “и “Пока”:

И запустим измененный скрипт. Как только мы отправим боту команду /start у нас внизу появится наша клавиатура:

Теперь для отправки сообщений достаточно лишь нажать на соответствующую кнопку. Это очень удобно в мобильной версии телеграма.

InLine клавиатура

На мой взгляд, наиболее интересной является InLine клавиатура. Она позволяет вместе с сообщением отправлять пользователю интерактивные кнопки, например с вариантами ответов, а после их нажатия обрабатывать результат.

Давайте добавим простой вопрос от бота на команду /test:

Переменная markup объявляет новую переменную с inline keyboard, а markup.add – создает отдельную кнопку. Основные параметры при создании кнопки – text и callback_data: первый отвечает за текст на кнопке, второй – данные, которые будут переданы боту при выборе пользователем определенного варианта ответа.

Запустим скрипт и напишем /test:

Отлично, бот прислал нам варианты ответов. Но при нажатии на кнопку ничего не произойдет, т.к. мы не описали обработку результатов. Исправим это:

bot.answer_callback_quer – это всплывающее окно, которое будет показано пользователю после нажатия кнопки. А в call.data будет передано значение, которое мы указывали при создании клавиатуры в параметре callback_data. Ответим боту, выбрав один из ответов:

Отлично, все работает. Но будет лучше, если после ответа, клавиатура будет исчезать из чата. Это можно сделать добавив в конец функции query_handler следующую строку:

bot.edit_message_reply_markup(call.message.chat.id, call.message.message_id)

Это функция редактирования клавиатуры, вызванная без указания объекта клавиатуры. Теперь после ответа пользователя клавиатура будет убрана ботом:

Конечный листинг телеграм бот на питоне