Доброго времени дня и ночи, мой дорогой читатель. Пожалуй, мне бы стоило поздравить тебя с наступившим новым годом, но нет, прости, я не особо склонен ко всякого рода поздравлением. Не будем отходить от темы — полгода назад я написал статью о том, как создать своего самого первого робота в Telegram на Python3 и запустить его.
С тех пор прошло довольно много времени, несколько раз обновлялся Telegram Bot API, и сегодня я решил продолжить свой рассказ о создании своего робота.
Вступление
Для начала немного информации для общего развития — о том, что такое клавиатура в боте и для чего она нужна.
Когда мы впервые запускаем любого бота, мы используем кнопку Start (Запуск), затем можем продолжить общение с ботом посредством команд или любых других текстовых сообщений.
По правде гениальные разработчики Telegram решили пойти дальше и предложили создателям ботов использовать так называемые клавиатуры для роботов — эти клавиатуры заменяют обычные текстовые устройства ввода на телефонах и отображаются под полем для ввода сообщения.
CallbackQuery КОЛБЭКИ TELEGRAM БОТ -AIOGRAM (для чайников) — ПРОГРАММИРОВАНИЕ ПО ПЛЕЙЛИСТАМ УРОК 12
Что происходит, когда мы нажимаем кнопки под полем для ввода сообщения? Ничего сложного — лишь отправляется тот текст, который мы видим на кнопке. То есть нажатие на Настройки приведёт к отправке сообщения с текстом Настройки от твоего имени к боту и только.
Далее робот просто обрабатывает полученный им текст. Никакой магии. Знаю по своему опыту, что очень любят код (вру, не все) — поэтому сейчас мы приступим к его написанию.
Полагаю, прочитав мою предыдущую запись, ты сможешь установить и настроить Python3, а также создать самого простого бота, отвечающего на команду /start .
Пишем код
Создадим простого бота, который при запуске будет здороваться с пользователем. Кода, как на картинке ниже, будет вполне достаточно:
Теперь определимся с тем, что будет делать наш робот.
Сделаем так: сразу после запуска бот должен отобразить пользователю клавиатуру с двумя кнопками — Шерлок Холмс и Доктор Ватсон .
Отправимся в функцию start нашего простого бота и изменим её следующим образом:
Помимо всего прочего нужно добавить from telebot import types в начало нашего файла с роботом.
Теперь объясню, что вообще здесь происходит ?
- С помощью types.ReplyKeyboardMarkup() мы создаём объект нашей будущей клавиатуры, в скобках прописываются нужные параметры. resize_keyboard=True позволяет клавиатуре растягиваться на необходимую высоту вместо того, чтобы занимать всё пространство.
- С помощью .add() мы добавляем кнопки в нашу клавиатуру. types.KeyboardButton() представляет собой объект самой кнопки, а в скобках указывается текст на ней. В коде выше я наполняю объект нашей клавиатуры объектами кнопок, заполняя их из списка [‘Шерлок Холмс’, ‘Доктор Ватсон’] (полагаю, меня крайне сложно понять сейчас, это нормально, советую прочитать статью про списки и for ).
- Последнее, что нужно сделать — привязать нашу клавиатуру к нужному сообщению, делается это при помощи параметра reply_markup в любом методе send_. .
Можно сохранить код и запустить робота.
Как видно, под полем для текста появились две заветные кнопки. Что дальше? Теперь нужно научить нашего робота обрабатывать сообщения, отправляемые ему после нажатия на кнопки.
Рассмотрим мой код выше. В функции start мы используем метод register_next_step_handler для того, чтобы следующее сообщение от нашего пользователя сразу попало бы в обработчик name (который указан вторым параметром; первый — объект отправленного нами сообщения).
В функции name мы обработаем ответ пользователя — отправим сообщения о Шерлоке Холмсе и Докторе Ватсоне.
На картинке выше я добавил сообщения, которые будут отправляться пользователю после нажатия на любую из кнопок.
Сохраним файл с нашим роботом и запустим его, не забыв заново отправить команду /start (старые кнопки уже не сработают).
Вот так бот ответит нам на нажатие на кнопку. Но замечу, что повторное нажатие ни к чему не приведет, поскольку только после команды /start бот будет проверять текст сообщения на наличие Шерлока Холмса и Доктора Ватсона.
Подведём итог: клавиатуры позволяют отправлять целые сообщения по одному лишь нажатию пользователя. В кнопки можно записывать любые текстовые фразы, даже содержащие в себе Emoji. ?
После отправки бот должен обработать полученную фразу, причем неважно, как именно.
Отмечу, что у пользователя всегда есть остаётся возможность отправить сообщение при помощи обычной клавиатуры.
Ещё хочу добавить, что для объекта кнопки есть два интересных параметра, принимающих логические значения — request_contact и request_location . Первый запрашивает телефонный номер пользователя, а второй его местоположение. Узнать больше о параметрах и возможностях клавиатуры можно в официальной документации Telegram Bot API. Думаю, на этом часть с клавиатурами можно закончить.
Inline-режим
Так называемый Inline-режим появился у роботов в апреле прошлого года. Предлагаю для начала рассмотреть суть его работы. ?
Есть два варианта использования Inline: первый — в самом боте , в сообщениях, отправляемых ботом; второй — вне бота , где-нибудь в произвольном чате, начав набирать логин бота в поле для текстового сообщения.
Сегодня я хочу рассказать про первый вариант Inline-режима. С помощью него можно прикреплять Inline-кнопки к сообщениям, которые отправляются ботом.
То есть под каждым сообщением могут быть различные кнопки, выполняющие самую разнообразную работу. Например, в популярных каналах нередко используют лайки, реализованные как раз при помощи Inline-кнопок.
Inline-кнопки прикрепляются к сообщениям точно так же, как это делают клавиатуры. Отличаются лишь названия и параметры методов.
Внесем некоторые изменения в наш код. Теперь нашей целью будет отредактировать сообщение после нажатия на кнопку.
Да-да, Inline-кнопки способны редактировать уже отправленные нашим роботом сообщения. ?
По порядку рассказываю, что здесь творится. ?
Сохраним наш код и запустим робота. Отправим команду /start и попробуем нажать на любую из кнопок.
Как видно, текст сообщения от бота изменился после нажатия на кнопку.
Вместо callback_data можно также указать url — любой URL адрес; по нажатию на такую кнопку пользователь перейдёт в браузер.
На самом деле Inline-кнопки способны почти на всё — с помощью них можно даже отправлять обычные сообщения. Все функции и возможности описаны в Telegram Bot API. Пожалуй, это всё, что я хотел рассказать тебе о первых шагах в Inline.
А теперь небольшой подарок для всех читателей моего блога — ниже я оставлю код и описание простого бота, с помощью которого можно читать книгу в формате .txt в одном-единственном сообщении ?
Робот для чтения книги ?
По команде /start этот робот отправляет первую страницу — на каждой странице по 700 символов из книги.
С помощью стрелок ⬅️ и ➡️ можно листать страницы — текст сообщения будет изменяться вырезками по 700 символов.
Ниже я оставляю тебе код этого бота — чтобы запустить, достаточно положить рядом с ботом любую книгу в формате .txt
Источник: messagu.ru
Интеграция с Telegram
Интеграция позволит использовать мессенджер Telegram как канал коммуникации в различных сервисах Calltouch. Все сообщения из Telegram с сайта будут попадать в единый кабинет оператора. Все сообщения клиента с разных каналов Telegram оператор будет видеть в одном окне.
Для обмена сообщениями через Telegram, пользователь должен настроить интеграцию с Telegram, т.е. подключить API Token Telegram конкретного бота (в терминологии Telegram).
В Calltouch этот процесс называется подключением канала Telegram. Данным токеном будут подписываться обращения к API Telegram.
Подключение нового канала
Подключение канала Telegram производится в разделе «Интеграции» — «Мессенджеры и соцсети» — «Telegram».
.png)
Подключение и использование канала Telegram является бесплатным. Количество подключаемых каналов неограниченно.
Чтобы добавить новый канал, необходимо нажать на кнопку «Добавить интеграцию», и заполнить поле для подключения канала Telegram — API Token Telegram:
Получение API Token Telegram
Для того чтобы получить токен:
При нажатии на кнопку Сохранить, происходит подключение канала, если токен был введен корректно.
Настройки виджета
Чтобы в вашем виджете чата показывалась кнопка перехода в Telegram, вам необходимо добавить в виджет подключенную ранее интеграцию с мессенджером.
Делается это в настройках виджета на вкладке Интеграции.
При нажатии на «добавить канал» есть возможность выбрать любой из подключенных каналов в интеграциях.
Можно выбрать любой из подключенных Telegram каналов, но только один, поскольку несколько кнопок быть не может.
При сохранении канала в настройках виджета, происходит его подключение — появляется нотификация о добавлении канала.
Выбранный канал можно удалить. При применении изменений в Кабинете Оператора ничего не изменяется — все переписки и их статус сохраняются. Канал удаляется только из отображения в виджете.
При успешном подключении в вашем виджете появится кнопка:
.png)
При нажатии на кнопку Telegram в виджете, пользователь переходит в приложение Telegram (или веб-версию), где открывается подключенный канал.
Кабинет оператора
Пользователи Telegram отмечаются иконкой мессенджера. Внутри Calltouch пользователь Telegram идентифицируется по своему id, который показывается в карточке клиента.
Пользователь может заблокировать канал через который идет переписка. Если пользователь Telegram заблокировал канал Telegram в котором он вел переписку, то в окне оператора в одном треде отображена вся его предыдущая переписка, информация о пользователе, но новые сообщения отправить нельзя (с указанием того, что пользователь заблокировал канал).
В статистике чатов и в статистике основного Личного кабинета Calltouch пользователь из Telegram считается обычным пользователем чатов.
После завершения диалога, вы не сможете инициировать первым диалог, это касается, в том числе клиентов из Telegram. Чтобы связаться с клиентом, дождитесь сообщения от него или свяжитесь с ним напрямую по имеющимся у вас контактным данным.
Обмен файлами
В Кабинете оператора можно принимать большинство распространенных форматов файлов.
Список доступных форматов:
- Изображения: png, jpg, jpeg, gif.
- Текст: txt, doc.
- Прочие: xls, zip, rar, pdf.
Лимит на размер входящего файла — 50 МБ.
Лимит на размер исходящего файла — 20 МБ.
Источник: www.calltouch.ru
Обработчики взаимодействия с ботом в aiogram
Каждый раз, когда пользователь отправляет сообщение или выполняет какое-либо действие в чате, Telegram сервер генерирует обновление и отправляет его боту. AIOGram отвечает за асинхронную обработку этих обновлений.
Обновления в AIOGram представляются в виде объектов определенных классов, предоставляемых библиотекой aiogram. Каждый класс соответствует определенному типу обновления (например, сообщение, команда, запрос о подтверждении и т. д.). Объекты обновлений содержат информацию о событии, такую как идентификатор чата, идентификатор пользователя, текст сообщения, тип медиа и другие данные, необходимые для обработки события.
Примеры различных типов обновлений, которые могут быть обработаны AIOGram:
1. Обновление сообщения (MessageUpdate):
Включает информацию о текстовом сообщении, отправленном пользователем.
2. Обновление команды (CommandUpdate):
Содержит информацию о команде, которую пользователь отправил боту. Например, когда пользователь отправляет «/start» или «/help».
3. Обновление запроса о подтверждении (CallbackQueryUpdate):
Используется для обработки нажатий на кнопки с подтверждением (inline keyboards) в сообщениях бота.
4. Обновление редактирования сообщения (EditedMessageUpdate):
Происходит, когда пользователь редактирует уже отправленное ранее сообщение.
5. Обновление входа/выхода участников из группы (ChatMemberUpdate):
Содержит информацию о том, когда новый пользователь входит в чат или когда существующий пользователь покидает чат.
При разработке бота на AIOGram вы должны определить обработчики для различных типов обновлений, которые ваш бот будет обрабатывать. Когда новое обновление приходит, AIOGram определяет его тип и передает соответствующему обработчику для выполнения необходимых действий, таких как отправка ответа пользователю или выполнение определенной функциональности бота.
Обработка обновлений. message_handler и его параметры
Функция message_handler из библиотеки aiogram используется для создания обработчиков входящих сообщений. Она принимает несколько параметров, которые позволяют настроить условия, при которых обработчик будет вызываться. Вот список основных параметров, которые могут быть использованы с message_handler :
1. commands : Список команд, на которые обработчик будет реагировать. Команды должны начинаться с символа «/», например, commands=[‘start’, ‘help’] .
2. commands_prefix : Префикс, который будет использоваться для обработки команд. По умолчанию равен «/».
3. content_types : Список типов контента, которые обработчик будет обрабатывать. Например, content_types=[types.ContentType.TEXT, types.ContentType.PHOTO] . Если не указан, обработчик будет реагировать на все типы контента.
4. regexp : Паттерн регулярного выражения, с помощью которого можно обрабатывать сообщения, соответствующие заданному шаблону. Например, regexp=r»^hellosd+» будет обрабатывать сообщения, начинающиеся с «hello», за которыми идет одна или более цифр.
5. text : Точный текст, который должен содержаться в сообщении, чтобы обработчик был вызван. Например, text=»привет» будет обрабатывать сообщения, содержащие точный текст «привет».
6. text_contains : Подстрока, которую должно содержать сообщение, чтобы обработчик был вызван. Например, text_contains=»привет» будет обрабатывать сообщения, содержащие слово «привет».
7. state : Состояние, в котором должен находиться пользователь, чтобы обработчик был вызван. Может быть использован для реализации машины состояний.
8. is_reply : Флаг, указывающий, должно ли сообщение быть ответом на другое сообщение.
9. is_forwarded : Флаг, указывающий, является ли сообщение пересланным сообщением.
10. user_id : Идентификатор пользователя, от которого должно быть получено сообщение.
11. chat_id : Идентификатор чата, в котором должно быть получено сообщение.
12. chat_type : Тип чата, в котором должно быть получено сообщение (например, `types.ChatType.PRIVATE`, `types.ChatType.GROUP` и т. д.).
Вы можете комбинировать различные параметры, чтобы создать обработчики с определенными условиями, которые наилучшим образом соответствуют требованиям вашего телеграм бота.
Приоритет обработчиков
Приоритет обработчиков в AIOGram определяется порядком их определения в коде. Когда обновление (например, текстовое сообщение) попадает под условия нескольких обработчиков, будет вызван первый обработчик, который был определен и соответствует условиям данного обновления.
Пример. Даны три обработчика, которые готовы обработать введенную команду /help . Какой обработчик в итоге сработает?
Таким образом, порядок определения обработчиков в коде имеет большое значение, и первый подходящий обработчик будет использован для обработки данного обновления. Если сообщение удовлетворяет условиям сразу двух обработчиков, то будет вызван обработчик, который был определен первым в коде.
Поэтому, чтобы корректно обрабатывать различные типы сообщений и избежать конфликтов, рекомендуется организовывать обработчики таким образом, чтобы наиболее конкретные условия проверялись раньше, а более общие условия — в конце.
Обработка текстовых сообщений
В AIOGram обработчики входящих сообщений реализуются с помощью декораторов. Декораторы — это специальные функции, которые позволяют изменить поведение другой функции, добавляя к ней дополнительную логику или функциональность.
Для создания обработчика входящего сообщения вы должны использовать декоратор message_handler из библиотеки aiogram. Этот декоратор позволяет указать, какие типы сообщений обработчик будет обрабатывать (текстовые сообщения, аудио, фото и т. д.) и какие условия должны быть выполнены, чтобы вызвать этот обработчик.
Вот пример простого обработчика входящего текстового сообщения:
В приведенном выше примере мы определили обработчик on_text_message , который реагирует на текстовые сообщения. Когда пользователь отправляет текстовое сообщение, обработчик вызывается, и в ответ на сообщение отправляется ответ с тем же текстом, что был получен от пользователя.
Обработчики также могут быть настроены для реагирования на конкретные команды, изменения в чате, нажатия на кнопки с подтверждением и другие события. Вы можете использовать различные декораторы для определения обработчиков с различными условиями и функциональностью в вашем телеграм боте.
Обработка команд
Как отличить команду от текстового сообщения
Обработчик текстовых сообщений также будет реагировать на команды бота, так как команды бота являются частным случаем текстовых сообщений. Команды бота начинаются с символа «/», например, «/start», «/help» и т. д.
Когда пользователь отправляет команду боту, эта команда будет представлена как обычное текстовое сообщение с типом контента text . Поэтому обработчик, который определен для текстовых сообщений, будет вызываться для любых текстовых сообщений, включая команды бота.
Для того чтобы обработать команды бота отдельно от обычных текстовых сообщений, вы можете использовать декоратор message_handler из библиотеки aiogram с параметром commands . Этот декоратор позволяет определить обработчики именно для команд бота.
Вот пример кода с использованием message_handler+commands :
В приведенном выше примере мы определили два обработчика команд /start и /help , а также обработчик для текстовых сообщений. Теперь, когда пользователь отправляет команду /start или `/help`, соответствующий обработчик будет вызван и выполнит необходимые действия. Если пользователь отправляет другую команду или текстовое сообщение, будет вызван обработчик on_text_message .
Если пользователь введет не команду /start, а напишет просто start, что произойдет?
В приведенном мной примере, если пользователь введет не команду /start , а просто слово «start», то это сообщение будет обработано обработчиком on_text_message , так как обработчик команды `/start` определен только для полного текста «/start».
Вот как будет происходить обработка:
1. Если пользователь отправит команду /start :
Обработчик `on_start` будет вызван, и бот отправит ответ «Привет! Я ваш телеграм бот.»
2. Если пользователь отправит просто «start» или любой другой текст:
Обработчик on_text_message будет вызван, и бот отправит ответ «Вы написали: [текст сообщения]».
Таким образом, если пользователь введет текст, не являющийся точным соответствием одной из определенных команд (например, «/start» или «/help»), он будет рассматриваться как обычное текстовое сообщение и будет обработан обработчиком on_text_message .
Для того чтобы более точно обрабатывать входящие команды и исключать возможность путаницы с обычными текстовыми сообщениями, вы можете использовать декоратор commands_handler с параметром `commands_prefix=»/»`:
Теперь обработчик команды /start будет реагировать только на точное совпадение «/start», и просто «start» будет рассматриваться как обычное текстовое сообщение. Это поможет избежать путаницы и более точно обрабатывать входящие команды.
Обработка кнопки, привязанной к сообщению (Inline Keyboard Button)
Под кнопкой с подтверждением (Inline Keyboard Button) понимается интерактивный элемент в сообщениях Telegram, который позволяет пользователям нажимать на кнопку и отправлять обратную связь боту. Кнопка с подтверждением находится прямо внутри текста сообщения и может быть использована для различных целей, таких как отправка команд, выбор опций, ответ на вопросы и многое другое.
Основные характеристики кнопки с подтверждением:
- Текст кнопки: Это текст, который отображается на кнопке и виден пользователю.
- Callback Data: Каждая кнопка с подтверждением связана с определенной строкой данных (Callback Data). Когда пользователь нажимает на кнопку, эта строка данных отправляется обратно боту вместе с информацией о событии. Это позволяет боту определить, какую кнопку нажал пользователь.
- Уникальность: Каждая кнопка с подтверждением должна иметь уникальный Callback Data, чтобы бот мог правильно идентифицировать, какую кнопку нажал пользователь.
- Отображение: Кнопка с подтверждением может быть отображена как обычный текст, ссылка или кнопка с определенным действием.
Использование кнопок с подтверждением позволяет сделать интерфейс бота более интерактивным и удобным для пользователей. Боты могут отправлять сообщения с кнопками, и пользователи могут выбирать опции, отвечать на вопросы или выполнять другие действия, просто нажимая на кнопки в сообщениях.
Для создания и отправки кнопок с подтверждением вам потребуется использовать функции и классы из библиотеки aiogram (или аналогичной библиотеки для работы с Telegram API). Кнопки с подтверждением особенно полезны для создания многофункциональных и более удобных телеграм ботов.
Запрос о подтверждении
Запрос о подтверждении (Callback Query) — это тип обновления, который может быть отправлен Telegram боту, когда пользователь нажимает на кнопку с подтверждением (Inline Keyboard) в сообщении бота.
Когда пользователь нажимает на кнопку с подтверждением, Telegram отправляет обновление в бота с информацией о данном действии. Это обновление называется «Callback Query», и оно содержит следующую информацию:
— data : Строка данных, которая связана с нажатой кнопкой. Эта информация может быть определена вами при создании кнопки и использоваться для определения дальнейшего действия.
— from : Информация о пользователе, который нажал кнопку.
— message : Информация о сообщении, в котором была нажата кнопка.
— chat_instance : Уникальный идентификатор чата, в котором произошло действие.
При обработке запроса о подтверждении, ваш бот может выполнить определенные действия в зависимости от данных, переданных в параметре data . Например, вы можете обновить сообщение с новой информацией, отправить новое сообщение, записать информацию в базу данных или совершить другие действия, которые соответствуют функциональности вашего бота.
Для создания кнопок с подтверждением и обработки запросов о подтверждении вам потребуется использовать функции и классы из библиотеки aiogram. Это позволит вам легко добавлять интерактивность в вашего телеграм бота и предоставлять пользователям более удобный способ взаимодействия с ним.
Пример обработки
В данном примере, когда бот запускается, он отправляет сообщение с кнопкой «Нажми меня!» и привязывает к ней Callback Data «confirm». Когда пользователь нажимает на кнопку, срабатывает обработчик on_callback_query , который выводит информацию о запросе о подтверждении в консоль и отправляет ответное сообщение, содержащее текст «Вы нажали на кнопку с подтверждением!».
Источник: victor-komlev.ru