Python тіліндегі Telegram боты. Нөлден бастап валюта бағамы бар бот жазуға арналған толық нұсқаулық

Telegram-дағы боттар - бұл аудиториямен байланыс орнатуға немесе бұрын қолмен орындалуы керек әрекеттерді жеңілдетуге көмектесетін бағдарламалар. Бұл бағдарламалар мессенджерлік платформа үшін арнайы жазылған. Боттар осылай жұмыс істейді: пайдаланушы енгізу жолы арқылы пәрмен жібереді, ал жүйе мәтіндік немесе интерактивті хабарламамен жауап береді. Кейде бағдарлама тіпті нақты адамның әрекеттеріне еліктейді - мұндай бот тұтынушылар арасында көбірек сенім тудырады.

Пайдаланушыларға автоматты түрде көмектесетін жүйелердің бірнеше түрі бар. Кейбір боттар тек тұтынушылармен байланысады, басқалары үнемі ақпарат береді. Бағдарламаларды түрлерге нақты бөлу мүмкін емес – әзірлеушілер көбінесе бірнеше функцияларды бір ботта біріктіреді.

9 қадамда экрандағы түймелер түріндегі интерактивті элементтері бар Telegram үшін қарапайым бот жазуға болады. Олардың әрқайсысын егжей-тегжейлі қарастырып, бірнеше сұрақтарға жауап берейік:

• ботты қалай бастау керек;
• кірістірілген пернетақтаны бір немесе бірнеше түймелерден қалай тіркеуге болады;
• қажетті функциялар үшін түймелерді қалай бағдарламалау керек;
• кірістірілген режим дегеніміз не және оны бар бот үшін қалай орнату керек.

0-қадам: Telegram боттары API туралы теориялық мәлімет

Telegram боттарын жасау үшін пайдаланылатын негізгі құрал HTML қолданбалы бағдарламалау интерфейсі немесе HTML API болып табылады. Бұл элемент келушілердің сұрауларын қабылдайды және жауаптарды ақпарат түрінде жібереді. Дайын конструкциялар бағдарлама бойынша жұмысты жеңілдетеді. Telegram үшін бот жазу үшін мына электрондық пошта мекенжайын пайдалану керек: https://api.telegram.org/bot/METHOD_NAME

Боттың дұрыс жұмыс істеуі үшін таңбалауыш қажет - бағдарламаны қорғайтын және оған сенімді әзірлеушілерге қол жеткізуді ашатын таңбалар комбинациясы. Әрбір белгі бірегей. Құрылған кезде жол ботқа тағайындалады. Әдістер әртүрлі болуы мүмкін: getUpdates, getChat және т.б. Әдісті таңдау әзірлеушілер боттан қандай алгоритм күтетініне байланысты. Токен мысалы:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Боттар GET және POST сұрауларын пайдаланады. Әдіс параметрлерін жиі толықтыру қажет – мысалы, sendMessage әдісі чат идентификаторын және кейбір мәтінді жіберуі керек болғанда. Әдісті нақтылауға арналған параметрлерді URL сұрау жолы ретінде application/x-www-form-urlencoded немесе application-json арқылы жіберуге болады. Бұл әдістер файлдарды жүктеуге жарамайды. UTF-8 кодтауы да қажет. API-ге сұрау жіберу арқылы нәтижені JSON пішімінде алуға болады. GetME әдісі арқылы ақпаратты алуға бағдарламаның жауабын қараңыз:

https://api.telegram.org/bot/getMe{ жарайды: шын, нәтиже: { идентификатор: 231757398, аты_жөні: "Валюта бағамы боты", пайдаланушы аты: "exchangetestbot" } }

Нәтиже, егер болады ok тең шынайы. Әйтпесе, жүйе қатені көрсетеді.

Боттарда реттелетін хабарларды алудың екі жолы бар. Екі әдіс де тиімді, бірақ әртүрлі жағдайларда қолайлы. Хабарламаларды алу үшін getUpdates әдісімен сұрауды қолмен жазуға болады – бағдарлама экранда Жаңарту деректер массивін көрсетеді. Сұраныстарды жүйелі түрде жіберу керек, әрбір массивті талдағаннан кейін жіберу қайталанады. Офсет – тексерілген нысандардың қайта пайда болуын болдырмау үшін жаңа нәтижені жүктеу алдында өткізіп алынған жазбалардың санын анықтайтын параметр. GetUpdates әдісінің артықшылықтары келесі жағдайларда іске қосылады:

• HTTPS конфигурациялау мүмкіндігі жоқ;
• күрделі сценарий тілдері қолданылады;
• бот сервері мезгіл-мезгіл өзгереді;
• бот пайдаланушылармен жүктеледі.

Пайдаланушы хабарламаларын алу үшін жазуға болатын екінші әдіс - setWebhook. Ол бір рет пайдаланылады, үнемі жаңа сұраныстарды жіберудің қажеті жоқ. Вебхук деректер жаңартуларын көрсетілген URL мекенжайына жібереді. Бұл әдіс SSL сертификатын қажет етеді. Вебхук мына жағдайларда пайдалы болады:

• веб-бағдарламалау тілдері қолданылады;
• бот шамадан тыс жүктелмеген, пайдаланушылар тым көп емес;
• сервер өзгермейді, бағдарлама ұзақ уақыт бір серверде қалады.

Қосымша нұсқауларда біз getUpdates қолданбасын қолданамыз.

@BotFather Telegram қызметі чат боттарын жасауға арналған. Негізгі параметрлер де осы жүйе арқылы орнатылады – BotFather сипаттама жасауға, профильдік фотосуретті қоюға, қолдау құралдарын қосуға көмектеседі. Кітапханалар – Telegram боттарына арналған HTML сұрауларының жиынтығы – Интернетте қол жетімді, олардың саны өте көп. Мысал бағдарламасын жасау кезінде pyTelegramBotApi пайдаланылды.

1-қадам: Валюта бағамы бойынша сұраныстарды орындау

Алдымен сұрауларды орындайтын кодты жазу керек. Біз PrivatBank API жазған кезде қолданамыз, төменде оған сілтеме берілген: https://api.privatbank.ua/p24api/pubinfo?json&exchange&coursid=5. Кодыңызда осы әдістерді пайдалану керек:

• load_exchange – валюта бағамдарын табады және кодталған ақпаратты көрсетеді;
• get_exchange – белгілі бір валюта туралы деректерді көрсетеді;
• get_exchanges – үлгіге сәйкес валюталар тізімін көрсетеді.

Нәтижесінде pb.py файлындағы код келесідей болады:

импорттау қайта импорттау сұраулары импорттау json URL = 'https://api.privatbank.ua/p24api/pubinfo?json&exchange&coursid=5' def load_exchange(): return json.loads(requests.get(URL).text) def get_exchange(ccy_key) ): exc үшін load_exchange(): if ccy_key == exc['ccy']: қайтару exc қайтару False def get_exchanges(ccy_pattern): нәтиже = [] ccy_pattern = re.escape(ccy_pattern) + '.*' exc үшін load_exchange(): егер re.match(ccy_pattern, exc['ccy'], re.IGNORECASE) ешбірі болмаса: result.append(exc) нәтижені қайтарады

Бағдарлама көрсетілген сұрауларға келесі жауапты бере алады:

[ { ccy:"USD", base_ccy:"UAH", сатып алу:"25.90000", сату:"26.25000" }, { ccy:"EUR", base_ccy:"грн", сатып алу:"29.10000", сату:"29.85000 " }, { ccy:"RUR", base_ccy:"UAH", сатып алу:"0.37800", сату:"0.41800" }, { ccy:"BTC", base_ccy:"USD", сатып алу:"11220.0384", сату: "12401.0950" } ]

2-қадам: @BotFather көмегімен Telegram ботын жасаңыз

@BotFather қызметі арқылы хабарламаларды қабылдау және оларға жауап беру бағдарламасын жасауға болады. Оның Telegram бетіне өтіп, /newbot пәрменін енгізіңіз. Нұсқаулар чатта пайда болады, оған сәйкес алдымен боттың атын, содан кейін оның мекенжайын жазу керек. Бот тіркелгісі жасалғанда, экранда таңбалауышы бар сәлемдесу хабары пайда болады. Қосымша конфигурациялау үшін мына пәрмендерді пайдаланыңыз:

• /setdescription – сипаттама;
• /setabouttext – жаңа бот туралы ақпарат;
• /setuserpic – профильдік фото;
• /setinline – кірістірілген режим;
• /setcommands – командалардың сипаттамасы.

Соңғы конфигурация қадамында біз /help және /exchange сипаттаймыз. Барлық қадамдар аяқталғаннан кейін кодтауға көшудің уақыты келді.

3-қадам: Ботты орнату және іске қосу

config.py файлын жасайық. Онда сіз бірегей бот кодын және бағдарлама ақпаратты табатын уақыт белдеуін көрсетуіңіз керек.

TOKEN = '' # бот белгісімен ауыстырыңызTIMEZONE = 'Еуропа/Киев' TIMEZONE_COMMON_NAME = 'Киев'

Әрі қарай, біз бұрын жазылған pb.py, кітапханалар және басқа қажетті компоненттерді импорттау арқылы басқа файлды жасаймыз. Жетіспейтін кітапханалар пакеттерді басқару жүйесінен (pip) орнатылады.

импорт telebotimport конфигурациялау pbimport datetimeimport pytzimport jsonimport бақылау кері P_TIMEZONE = pytz.timezone(config.TIMEZONE) TIMEZONE_COMMON_NAME = конфигурация.TIMEZONE_COMMON_NAME

Бот жасау үшін pyTelegramBotApi мазмұнын қолданайық. Алынған таңбалауышты келесі код арқылы жібереміз:

bot = telebot.TeleBot(config.TOKEN) bot.polling(none_stop=True)

none_stop параметрі сұраулардың үнемі жіберілуін қамтамасыз етеді. Параметрдің жұмысына әдіс қателері әсер етпейді.

4-қадам: /start пәрмен өңдеушісін жазыңыз

Барлық алдыңғы қадамдар дұрыс орындалса, бот жұмыс істей бастады. Бағдарлама сұрауларды үнемі жасайды, себебі ол getUpdates әдісін пайдаланады. none_stop элементі бар жолдың алдында бізге /start пәрменін өңдейтін код бөлігі қажет:

@bot.message_handler(commands=['start']) def start_command(message): bot.send_message( message.chat.id, 'Сәлеметсіз бе! Мен сізге валюта бағамдарын көрсете аламын.n' + 'Валюта бағамын білу үшін / түймесін басыңыз. exchange.n' + 'Анықтама алу үшін /help түймесін басыңыз.' )

RџSЂRё пәрмендер=['бастау'] True тең бастау_пәрмені шақырылады. Хабарламаның мазмұны сонда барады. Әрі қарай, жіберу функциясын орындау керек_хабар белгілі бір хабарға қатысты.

5-қадам: /help пәрмен өңдеушісін жасаңыз

/help пәрменін түйме ретінде іске асыруға болады. Оны басу арқылы пайдаланушы әзірлеушінің Telegram аккаунтына өтеді. Түймеге «Әзірлеушіден сұрау» сияқты атау беріңіз. send_message әдісі үшін пайдаланушыны сілтемеге қайта бағыттайтын reply_markup параметрін орнатыңыз. Кодқа пернетақтаны жасайтын параметрді жазайық (InlineKeyboardMarkup). Сізге тек бір түйме (InlineKeyboardButton) қажет.

Соңғы пәрмен өңдегішінің коды келесідей көрінеді:

@bot.message_handler(commands=['help']) def help_command(message): пернетақта = telebot.types.InlineKeyboardMarkup() keyboard.add( telebot.types.InlineKeyboardButton( 'Әзірлеушіден сұраңыз', url='ваша ссылка на профиль' ) ) bot.send_message( message.chat.id, '1) Қол жетімді валюталар тізімін алу үшін /exchange.n' + '2) Сізді қызықтыратын валютаны басыңыз.n' + '3) Сіз бастапқы және мақсатты валюталарға қатысты ақпаратты қамтитын хабарлама алады, ' + 'сатып алу және сату бағамдары.n' + '4) Сұранысқа қатысты ағымдағы ақпаратты алу үшін «Жаңарту» түймесін басыңыз. ' + 'Бот сонымен қатар алдыңғы және ағымдағы валюта бағамдары арасындағы айырмашылықты көрсетеді.n' + '5) Бот кірістірілген режимді қолдайды. @ теріңіз кез келген чатта және валютаның бірінші әріптері.', reply_markup=пернетақта )

Telegram чатындағы код әрекеті:

6-қадам: /exchange пәрмен өңдеушісін қосу

Бұл қадам чатта қол жетімді валюталардың таңбалары бар түймелерді көрсету үшін қажет. Опциялары бар экрандық пернетақта қателерді болдырмауға көмектеседі. PrivatBank рубль, доллар және еуро туралы ақпаратты ұсынады. InlineKeyboardButton опциясы келесідей жұмыс істейді:

1. Пайдаланушы қажетті белгісі бар түймені басады.
2. getUpdates кері қоңырауды алады (CallbackQuery).
3. Пернетақтаны басқанда қалай жұмыс істеу керектігі белгілі болды - басылған түйме туралы ақпарат беріледі.

/exchange өңдеуші коды:

@bot.message_handler(commands=['exchange']) def exchange_command(хабарлама): пернетақта = telebot.types.InlineKeyboardMarkup() keyboard.row( telebot.types.InlineKeyboardButton('USD', callback_data='get-USD') ) keyboard.row( telebot.types.InlineKeyboardButton('EUR', callback_data='get-EUR'), telebot.types.InlineKeyboardButton('RUR', callback_data='get-RUR') ) bot.send_message( message.chat .id, 'Таңдалған валютаны басыңыз:', reply_markup=keyboard )

Telegram-дағы кодтың нәтижесі:

7-қадам: Кірістірілген пернетақта түймелері үшін өңдеуші жазу

pyTelegramBot Api бумасында @bot.callback_query_handler декоратор функциясы бар. Бұл құрамдас кері шақыруды функцияға аударуға арналған – API қоңырауды ашады және қайта жасайды. Ол былай жазылған:

@bot.callback_query_handler(func=lambda қоңырауы: True) def iq_callback(сұрау): деректер = query.data, егер data.startswith('get-'): get_ex_callback(сұрау)

Сондай-ақ get_ex_callback әдісін жазайық:

def get_ex_callback(сұрау): bot.answer_callback_query(query.id) send_exchange_result(query.message, query.data[4:])

Тағы бір пайдалы әдіс бар – answer_callback_query. Бұл түймені басу мен нәтижені экранда көрсету арасындағы жүктемені жоюға көмектеседі. Кейбір валюта кодын және Хабарды жіберу арқылы send_exchange_query мекенжайына хабарлама жіберуге болады. send_exchange_result деп жазайық:

def send_exchange_result(хабарлама, ex_code): bot.send_chat_action(message.chat.id, "теру") бұрынғы = pb.get_exchange(ex_code) bot.send_message(message.chat.id, serialize_ex(ex), reply_markup=get_update_keyboard ), parse_mode='HTML')

Чатбот банктен сұрау нәтижесін алады API, келуші «хабарлама теру» деген жазуды көреді. Нағыз адам жауап беріп жатқан сияқты. Мұндай индикаторды экранда көрсету үшін енгізу күйінің жолдарын қосу керек. Әрі қарай, біз get_exchange қолданамыз – оның көмегімен бағдарлама валюта белгісін алады (рубль, еуро немесе доллар). send_message қосымша әдістерді пайдаланады: serialize_ex валютаны басқа пішімге түрлендіреді және get_update_keyboard ақпаратты жаңартатын және валюта нарығының деректерін басқа чаттарға жіберетін бағдарламалық пернелерді орнатады.

get_update_keyboard кодын жазайық. Екі түймені атап өту керек – t және e түр мен алмасуды білдіреді. «Бөлісу» түймесі үшін switch_inline_query элементі пайдаланушы бірнеше чаттардан таңдай алуы үшін қажет. Келуші доллардың, рубльдің немесе еуроның ағымдағы бағамын кімге жіберу керектігін таңдай алады.

def get_update_keyboard(ex): пернетақта = telebot.types.InlineKeyboardMarkup() keyboard.row( telebot.types.InlineKeyboardButton( 'Жаңарту', callback_data=json.dumps({ 't': 'u', 'e': { ' b': ex['buy'], 's': ex['sale'], 'c': ex['ccy'] } }).replace(' ', '') ), telebot.types.InlineKeyboardButton ('Share', switch_inline_query=ex['ccy']) ) қайтару пернетақтасы

Кейде қысқа уақыт ішінде валюта бағамының қаншалықты өзгергенін көру керек. Пайдаланушылар курстарды салыстыру арқылы көре алатындай етіп Жаңарту түймесі үшін екі әдісті жазайық.

Айырбастау бағамдары арасындағы айырмашылық diff параметрі арқылы сериализаторға беріледі.

Белгіленген әдістер деректер жаңартылғаннан кейін ғана жұмыс істейді, олар курстың бірінші дисплейіне әсер етпейді.

def serialize_ex(ex_json, айырмашылық=Жоқ): нәтиже = '' + ex_json['base_ccy'] + ' -> ' + ex_json['ccy'] + ':nn' + 'Сатып алу: ' + ex_json['сатып алу'] егер айырмашылық болса: нәтиже += ' ' + serialize_exchange_diff(айырма['сатып алу_айырмасы']) + 'n' + 'Сату: ' + ex_json['sale'] + ' ' + serialize_exchange_diff(diff['sale_diff']) + 'n' else: result += 'nSell: ' + ex_json['sale'] + 'n' нәтижені қайтарады def serialize_exchange_diff(diff): нәтиже = '' егер айырмашылық > 0: нәтиже = '(' + str(diff) + ' " src="https://sworg/images/core/emoji/2.3/svg/2197.svg">" src="https://sworg/images /core/emoji/72x72/2197.png">" src="https://sworg/images/core/emoji/72x72/2197.png">)' elif diff < 0: нәтиже = '(' + str( diff)[1:] + ' " src="https://sworg/images/core/emoji/2.3/svg/2198.svg">" src="https://sworg/images/core/emoji/72x72 /2198.png">" src="https://sworg/images/core/emoji/72x72/2198.png">)' қайтару нәтижесі

Келуші доллар бағамын білгісі келді делік. Хабарламада АҚШ долларын таңдасаңыз, келесідей болады:

8-қадам: Жаңарту түймешігі өңдеушісін енгізу

Жаңарту түймешігі арқылы әрекеттерді өңдеу кодын жазайық және оған iq_callback_method бөлігін қосамыз. Бағдарлама элементтері get параметрімен басталған кезде, get_ex_callback деп жазу керек. Басқа жағдайларда біз JSON талдап, t кілтін алуға тырысамыз.

@bot.callback_query_handler(func=lambda қоңырауы: True) def iq_callback(сұрау): data = query.data if data.startswith('get-'): get_ex_callback(query) басқа: көріңіз: if json.loads(data)[ 't'] == 'u': edit_message_callback(сұрау) ValueError: өтуден басқа

Егер t тең u болса, edit_message_callback әдісі үшін бағдарлама жазу керек. Бұл процесті кезең-кезеңімен бөлейік:

1. Валюта нарығының жағдайы туралы соңғы ақпаратты жүктеп алу (exchange_now = pb.get_exchange(data['c']).

2. Дифф арқылы сериализатор арқылы жаңа хабарлама жазу.
3. Қолтаңбаны қосу (get_edited_signature).

Бастапқы хабар өзгермесе, edit_message_text әдісіне қоңырау шалыңыз.

def edit_message_callback(сұрау): data = json.loads(query.data)['e'] exchange_now = pb.get_exchange(data['c']) мәтін = serialize_ex(exchange_now, get_exchange_diff(get_ex_from_iq_data(деректер)), exchange_now + 'n' + get_edited_signature() егер query.message: bot.edit_message_text( мәтін, query.message.chat.id, query.message.message_id, reply_markup=get_update_keyboard(exchange_now), parse_mode='HTML') e-mail. : bot.edit_message_text( text, inline_message_id=query.inline_message_id, reply_markup=get_update_keyboard(exchange_now), parse_mode='HTML' )

JSON талдауы үшін get_ex_from_iq_data әдісін жазайық:

def get_ex_from_iq_data(exc_json): қайтару {'сатып алу': exc_json['b'], 'сату': exc_json['s'] }

Сізге тағы бірнеше әдіс қажет болады: мысалы, валюталардың құны туралы ескі және жаңа ақпаратты оқитын және айырмашылықты көрсететін get_exchange_diff.

def get_exchange_diff(соңғы, қазір): return { 'sale_diff': float("%.6f" % (float(қазір['сату'])) - қалқымалы (соңғы['сату']))), 'сатып алу_айырмасы': қалқымалы («%.6f» % (жүзу(қазір['сатып алу'])) - қалқымалы(соңғы['сатып алу']))) }

Соңғысы, get_edited_signature курстың соңғы жаңартылған уақытын көрсетеді.

def get_edited_signature(): қайтару 'Жаңартылған ' + str(datetime.datetime.now(P_TIMEZONE).strftime('%H:%M:%S')) + ' (' + TIMEZONE_COMMON_NAME + ')'

Нәтижесінде тұрақты валюта бағамы бар боттан жаңартылған хабарлама келесідей болады:

Курс өзгерген кезде мәндер арасындағы айырмашылықтар белгіленген параметрлерге байланысты хабарламада көрсетіледі.

9-қадам: Енгізілген режимді енгізу

Кірістірілген режим бағдарламадан ақпаратты кез келген чатқа жылдам жіберу үшін қажет – енді сөйлесуге қатысушы ретінде бот қосудың қажеті жоқ. Telegram пайдаланушысы алдында @ белгісі бар бот атауын енгізгенде, түрлендіру опциялары енгізу жолының үстінде пайда болуы керек. Элементтердің біреуін бассаңыз, бот сұхбатқа нәтижелер мен деректерді жаңарту және жіберу түймелері бар хабарлама жібереді. Жіберушінің атында «арқылы «.

InlineQuery кітапхана арқылы query_text файлына жіберіледі. Код деректер массиві және inline_query_id элементі ретінде іздеу нәтижелерін шығарып алу үшін answer_line функциясын пайдаланады. Бот сұрау бойынша бірнеше валютаны табуы үшін get_exchanges пайдаланамыз.

@bot.inline_handler(func=lambda сұрауы: True) анықтамасы_мәтін(inline_query): bot.answer_inline_query(inline_query.id, get_iq_articles(pb.get_exchanges(inline_query.query)) )

Осы әдіс арқылы InlineQueryResultArticle ішінен нысандарды қайтару үшін деректер жиымын get_iq_articles ішіне жібереміз.

def get_iq_articles(exchanges): нәтиже = [] алмасулардағы exc үшін: result.append( telebot.types.InlineQueryResultArticle( id=exc['ccy'], title=exc['ccy'], input_message_content=telebot.types.InputTextMessaget ( serialize_ex(exc), parse_mode='HTML' ), reply_markup=get_update_keyboard(exc), description='Convert ' + exc['base_ccy'] + ' -> ' + exc['ccy'], thumb_height=1 ) ) нәтижені қайтару

Енді @ деп жазсаңыз және жолда бос орын болса, іздеу нәтижелері экранда пайда болады – үш қолжетімді валютаға айырбастау опциялары.

Пайдаланушылар қажетті валютаны енгізу арқылы нәтижелерді сүзе алады.

Тізімнен қажетті валютаны басқаннан кейін чат бот пайдаланушылары алатын бірдей хабарламаны алады. Жаңарту түймесін де пайдалануға болады. Төмендегі суретте бот арқылы жіберілген жаңартылған хабарлама көрсетілген:

қорытынды

Енді сіз Telegram үшін бот жасауды білесіз. Сіз өзіңіздің бағдарламаңызға пайдалы құралдарды қоса аласыз: нәтижені мессенджердің басқа пайдаланушыларына жаңарту және жіберу түймелері және онымен сөйлесуден тыс бот функцияларын пайдалануға мүмкіндік беретін кірістірілген режим. Осы нұсқаулыққа сүйене отырып, сіз айырбас бағамын көрсететін ғана емес, басқа функциялары бар кез келген қарапайым бот жасай аласыз. Telegram-да тұтынушылармен сөйлесетін және қызығушылық танытқан адамдардың компаниямен байланысын нығайтатын автоматтандырылған көмекшіні жасау үшін кітапханалармен, API интерфейстерімен және кодпен тәжірибе жасаудан қорықпаңыз.