Как сделать в телеграм боте калькулятор

Обновлено: 19.09.2024

Чат-боты помогают повысить потребительскую ценность бизнеса при сравнительно небольших затратах на создание таких инструментов.

51 % клиентов, по данным чат-бота Ubisend, ожидает, что бизнес будет доступен в режиме 24/7.

Еще немного статистики:

подавляющее большинство пользователей (87,2 %) имеет нейтральный или положительный опыт общения с чат-ботами; , в 2021 году количество уникальных чат-ботов приблизилось к 1,8 миллиардам единиц. Глобальный рынок чат-ботов оценен более чем в 600 миллиардов долларов;
в то же время 60 % пользователей предпочли бы дождаться, пока им ответит живой сотрудник. Чат-боты кажутся этим людям примитивными и неспособными решать проблемы клиентов.

Топ-8 сценариев для чат-бота

Использовать чат-бот в Telegram можно по-разному:

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

Это самые очевидные сценарии использования чат-бота в Telegram. Однако разработчик может настроить бот для решения практически любой задачи.

6 особенностей чат-ботов в Telegram

Как сделать чат-бота в Telegram: пошаговая инструкция

Создаются и управляются боты с помощью другого бота BotFather.

Чтобы создать чат-бота, выполните следующие действия:

установите десктоп-версию Telegram и запустите ее;
откройте Controller Bot;
нажмите START внизу экрана:

Используйте команду добавления нового канала:

Получите подробную инструкцию, как подключить нового бота:

Следуя инструкции, отправьтесь в BotFather и нажмите START внизу экрана:

Теперь дайте боту ник. Ник должен оканчиваться на слово bot:

Получите уникальный токен и скопируйте его. В случае потери или удаления диалога не нужно паниковать. Снова отправьте /token в диалог, и новый вариант кода будет сразу же создан.
Вернитесь в ControllerBot и отправьте токен в диалог:

Для этого создайте новый публичный канал через левое меню, нажав кнопку New Chanel:

Чтобы добавить созданного бота в администраторы канала, нужно выбрать его в чатах и нажать кнопку Manage Channel:

. и назначить администратора:

После выполнения двух требований ControllerBot мы успешно подключили канал. Осталось указать город для уточнения часового пояса:

Подтверждаем, нажав «Верно»:

В самом низу нажимаем кнопку «Создать новый пост»:

Бот предложит настроить форматирование. В 95 % случаев подойдет Markdown (прим. ред. – облегченный язык разметки):

Теперь создаем первый пост. Можно написать в нем любой текст, чтобы проверить, как это работает:

ControllerBot возвратит отправленную запись и предложит задействовать дополнительные инструменты:

Чтобы добавить в пост картинку, воспользуйтесь кнопкой «Прикрепить медиафайл».
Можно добавить в пост до шести смайлов, которые пользователи будут использовать в качестве реакций:

Если нужно привязать к кнопке ссылку, воспользуйтесь этой функцией:

. и выберите предпочтительный сценарий публикации:

Синтаксис. Команды. Настройки

Главные команды запомнить несложно:

Если при создании бота вам не хватает стандартных функций, вы можете задействовать дополнительные команды длиной до 32 символов.

Соблюдайте синтаксис: /команда [необязательный] [аргумент]. Например, так мы получаем статистику по боту: /get_messages_stats

Обратите внимание: список команд будет появляться сразу после ввода символа «/». Не забудьте активировать описание команд в «отце ботов».

О некоторых параметрах BotFather мы уже говорили. Это:

Токен – уникальный ключ, который используется для доступа к Bot API. Токен имеет следующий вид: 110201543:ААHdqTcvCН1vGWJxfSеоfSAs0K5PALDsaw.
Name – значение выводится только в чатах и контактах пользователя.
Username – не длиннее 32 символов. Может включать латиницу, цифры и символ «_».

Важные команды для чат-ботов

Дополнительных возможностей у бота в Telegram достаточно. Разбирать их все не имеет смысла, так как активно используется лишь небольшая часть.

Теперь посмотрим основные команды BotFather.

В Google и «Яндексе», соцсетях, рассылках, на видеоплатформах, у блогеров

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

3. Создаем нового бота в телеграм

Начинаем чат с BotFather командой " /start " и далее следуем подсказкам бота:

Отправляем команду " /newbot " и отвечаем, как мы хотим назвать наш бот и какой у него будет юзернейм. В ответ Телеграм пришлет ссылку на бота и токен для работы с ботом из других приложений. Этот токен фактически дает полные права на управление ботом, так что держите его в тайне.

Бот создан. С помощью Крестного Бота можно отредактировать его, добавив информацию, юзерпик и др. - оставлю это на ваше усмотрение :-)

Бот не может инициировать диалог, пользователь должен начать диалог сам и послать команду " /start ", а бот, получив эту команду, должен сохранить параметр chat_id , чтобы потом писать этому пользователю. Делать все это мы будем с помощью того же языка скриптов в гугл таблице. Возращаемся в нашу таблицу и запускаем редактор скриптов.

Для начала, сохраним значение токена, чтобы потом его можно было использовать. В редакторе скриптов идем в меню " Файл -> Свойства проекта "

И в закладке "Свойства скрипта" добавляем строку " OPENAPI_TOKEN " со значением токена, которое прислал Крестный Бот. Сохраняем.

В начале скрипта добавляем строки:

Создадим также новую функцию FetchMessages - она будет:

Подключаться к серверу Телеграм по API
Запрашивать список обновлений у бота
Сохранять chat_id для новых пользователей
Очищать список обновлений на сервере

Если бы мы писали этого бота, как полноценный продукт, нужно было бы проверить список chat_id на дубликаты, а также запрашивать от каждого пользователя свои ссылку (или ссылки), по которым он хочет получать оповещения. Но у нас больше образовательно-демонстрационный проект, поэтому эти моменты я пропущу.

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

Напишем еще несколько функций:

Функция MakeChart - делает график из данных по ценам в виде картинки
Функция SendPhoto - отправляет картинку с комментарием на указанный chat_id
Функция SendMessage - с помощью функции MakeChart готовит картинку и для каждого chat_id с помощюу функции sendPhoto отправляет картинку в телеграм.

Добавляем вызов функции SendMessage в функцию GetPrice, чтобы она выполнялась после получения цен.

6. Тестируем

Вручную запустим функцию SendMessage - выберем ее на панели инструментов и нажмем запуск:

Это пошаговое руководство по созданию бота для Telegram. Бот будет показывать курсы валют, разницу между курсом раньше и сейчас, а также использовать современные встроенные клавиатуры.

Время переходить к делу и узнать наконец, как создавать ботов в Telegram.

Шаг №0: немного теории об API Telegram-ботов

Начать руководство стоит с простого вопроса: как создавать чат-ботов в Telegram?

Токен — уникальная строка из символов, которая нужна для того, чтобы установить подлинность бота в системе. Токен генерируется при создании бота. METHOD_NAME — это метод, например, getUpdates , sendMessage , getChat и так далее.

Токен выглядит приблизительно так:

Для выполнения запросов используются как GET, так и POST запросы. Многие методы требуют дополнительных параметров (методу sendMessage , например, нужно передать chat_id и текст). Эти параметры могут быть переданы как строка запроса URL, application/x-www-form-urlencoded и application-json (кроме загрузки файлов). Еще одно требование — кодировка UTF-8.

После отправки запроса к API, вы получаете ответ в формате JSON. Например, если извлечь данные с помощью метода getME , ответ будет такой:

Список всех типов данных и методов API Telegram-бота можно найти здесь (ENG) или с переводом здесь (ру) .

Есть два варианта.

Первый — вручную создавать запросы с помощью метода getUpdates . В качестве объекта вы получите массив объектов Update . Этот метод работает как технология длинных опросов (long polling), когда вы отправляете запрос, обрабатываете данные и начинаете повторяете процесс. Чтобы избежать повторной обработки одних и тех же данных рекомендуется использовать параметр offset .

Как выбрать оптимальный метод? Метод getUpdates лучше всего подходит, если:

Метод с Webhook лучше подойдет в таких случаях:

Вы используете веб-языки (например, PHP).
У бота низкая нагрузка, и нет смысла делать запросы вручную.
Бот на постоянной основе интегрирован в веб-сервер.

В этом руководстве будет использоваться метод getUpdates .

Еще один вопрос: как создать зарегистрировать бота?

@BotFather используется для создания ботов в Telegram. Он также отвечает за базовую настройку (описание, фото профиля, встроенная поддержка и так далее).

Существует масса библиотек, которые облегчают процесс работы с API Telegram-бота. Вот некоторые из них:

По своей сути, все эти библиотеки — оболочки HTML-запросов. Большая часть из них написана с помощью принципов ООП. Типы данных Telegram Bot API представлены в виде классов.

В этом руководстве будет использоваться библиотека pyTelegramBotApi.

Шаг №1: реализовать запросы курсов валют

Весь код был проверен на версии Python==3.7 c использование библиотек:
pyTelegramBotAPI==3.6.6
pytz==2019.1
requests==2.7.0

Создадим файл pb.py со следующим кодом:

Были реализованы три метода:

load_exchange : загружает курсы валют по указанному URL-адресу и возвращает их в формате словаря(dict).
get_exchange : возвращает курсы валют по запрошенной валюте.
get_exchanges : возвращает список валют в соответствии с шаблоном (требуется для поиска валют во встроенных запросах).

Шаг №2: создать Telegram-бота с помощью @BotFather

Его нужно сразу настроить. Необходимо добавить описание и текст о боте (команды /setdescription и /setabouttext ), фото профиля ( /setuserpic ), включить встроенный режим ( /setinline ), добавить описания команд ( /setcommands ). Потребуется использовать две команды: /help и /exchange . Стоит описать их в /setcommands .

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

Шаг №3: настроить и запустить бота

Начнем с создания файла config.py для настройки:

Создадим файл bot.py . Нужно импортировать все необходимые библиотеки, файлы с настройками и предварительно созданный pb.py . Если каких-то библиотек не хватает, их можно установить с помощью pip .

Создадим бота с помощью библиотеки pyTelegramBotAPI. Для этого конструктору нужно передать токен:

Шаг №4: написать обработчик команды /start

Теперь чат-бот на Python работает и постоянно посылает запросы с помощью метода getUpdates . Параметр none_stop отвечает за то, чтобы запросы отправлялись, даже если API возвращает ошибку при выполнении метода.

Из переменной бота возможно вызывать любые методы API Telegram-бота.

Начнем с написания обработчика команды /start и добавим его перед строкой bot.polling(none_stop=True) :

Это было просто, не так ли?

Шаг №5: создать обработчик команды /help

Давайте оживим обработчик команды /help с помощью встроенной кнопки со ссылкой на ваш аккаунт в Telegram. Кнопку можно озаглавить “Message the developer”.

Как видно в примере выше, был использован дополнительный параметр ( reply_markup ) для метода send_message . Метод получил встроенную клавиатуру ( InlineKeyboardMarkup ) с одной кнопкой ( InlineKeyboardButton ) и следующим текстом: “Message the developer” и url='telegram.me/artiomtb' .

Код выше выглядит вот так:

Шаг №6: добавить обработчик команды /exchange

Обработчик команды /exchange отображает меню выбора валюты и встроенную клавиатуру с 3 кнопками: USD, EUR и RUR (это валюты, поддерживаемые API банка).

Вот как работает InlineKeyboardButton . Когда пользователь нажимает на кнопку, вы получаете CallbackQuery (в параметре data содержится callback-data ) в getUpdates . Таким образом вы знаете, какую именно кнопку нажал пользователь, и как ее правильно обработать.

Вот как работает ответ /exchange:

Шаг №7: написать обработчик для кнопок встроенной клавиатуры

В библиотеке pyTelegramBot Api есть декоратор @bot.callback_query_handler , который передает объект CallbackQuery во вложенную функцию.

Давайте реализуем метод get_ex_callback :

Все довольно просто.

Сперва отправим состояние ввода в чат, так чтобы бот показывал индикатор «набора текста», пока API банка получает запрос. Теперь вызовем метод get_exchange из файла pb.py , который получит код валюты (например, USD). Также нужно вызвать два новых метода в send_message: serialize_ex , сериализатор валюты и get_update_keyboard (который возвращает клавиатуре кнопки “Update” и “Share”).

Запишем в get_update_keyboard текущий курс валют в callback_data в форме JSON. JSON сжимается, потому что максимальный разрешенный размер файла равен 64 байтам.

Кнопка t значит тип, а e — обмен. Остальное выполнено по тому же принципу.

У кнопки Share есть параметр switch_inline_query . После нажатия кнопки пользователю будет предложено выбрать один из чатов, открыть этот чат и ввести имя бота и определенный запрос в поле ввода.

Методы serialize_ex и дополнительный serialize_exchange_diff нужны, чтобы показывать разницу между текущим и старыми курсами валют после нажатия кнопки Update .

Как видно, метод serialize_ex получает необязательный параметр diff . Ему будет передаваться разница между курсами обмена в формате . Это будет происходить во время сериализации после нажатия кнопки Update . Когда курсы валют отображаются первый раз, он нам не нужен.

Вот как будет выглядеть бот после нажатия кнопки USD:

Шаг №8: реализовать обработчик кнопки обновления

Теперь можно создать обработчик кнопки Update . После дополнения метода iq_callback_method он будет выглядеть следующим образом:

Если данные обратного вызова начинаются с get- ( get-USD , get-EUR и так далее), тогда нужно вызывать get_ex_callback , как раньше. В противном случае стоит попробовать разобрать строку JSON и получить ее ключ t . Если его значение равно u , тогда нужно вызвать метод edit_message_callback . Реализуем это:

Как это работает? Очень просто:

Метод get_ex_from_iq_data разбирает JSON из callback_data :

Метод get_exchange_diff получает старое и текущее значение курсов валют и возвращает разницу в формате :

get_edited_signature генерирует текст “Updated…”:

И вот так — если изменились:

Шаг №9: реализовать встроенный режим

Реализация встроенного режима значит, что если пользователь введет @ + имя бота в любом чате, это активирует поиск введенного текста и выведет результаты. После нажатия на один из них бот отправит результат от вашего имени (с пометкой “via bot”).

Обработчик встроенных запросов реализован.

Библиотека передаст объект InlineQuery в функцию query_text . Внутри используется функция answer_line , которая должна получить inline_query_id и массив объектов (результаты поиска).

Используем get_exchanges для поиска нескольких валют, подходящих под запрос. Нужно передать этот массив методу get_iq_articles , который вернет массив из InlineQueryResultArticle :

Теперь при вводе “@exchangetestbost + пробел” вы увидите следующее:

Попробуем набрать usd, и результат мгновенно отфильтруется:

Проверим предложенный результат:

Кнопка “Update” тоже работает:

Отличная работа! Вы реализовали встроенный режим!

Выводы