Bot Telegram bằng Python. Hướng dẫn đầy đủ để viết một bot với tỷ giá hối đoái từ đầu

Bots trong Telegram là các chương trình giúp thiết lập liên hệ với khán giả hoặc đơn giản hóa các hành động mà trước đây phải thực hiện thủ công. Các chương trình này được viết riêng cho nền tảng nhắn tin. Bots hoạt động theo cách này: người dùng gửi lệnh thông qua dòng nhập và hệ thống phản hồi bằng tin nhắn văn bản hoặc tin nhắn tương tác. Đôi khi chương trình thậm chí còn bắt chước hành động của một người thật - một bot như vậy truyền cảm hứng cho khách hàng tin tưởng hơn.

Có một số loại hệ thống để hỗ trợ tự động cho người dùng. Một số bot chỉ giao tiếp với khách hàng, những bot khác thường xuyên cung cấp thông tin. Không thể phân chia rõ ràng các chương trình thành các loại - các nhà phát triển thường kết hợp nhiều chức năng trong một bot.

Bạn có thể viết một bot đơn giản cho Telegram với các yếu tố tương tác dưới dạng các nút trên màn hình trong 9 bước. Hãy xem xét từng chi tiết và trả lời một số câu hỏi:

• làm thế nào để bắt đầu một bot;
• cách đăng ký bàn phím tích hợp từ một hoặc nhiều nút;
• cách lập trình các nút cho các chức năng mong muốn;
• Chế độ nội tuyến là gì và cách thiết lập nó cho một bot hiện có.

Bước 0: Cơ sở lý thuyết về API chương trình Telegram

Công cụ chính được sử dụng để tạo bot Telegram là Giao diện lập trình ứng dụng HTML, hoặc HTML API. Phần tử này chấp nhận yêu cầu của khách và gửi phản hồi dưới dạng thông tin. Các thiết kế tạo sẵn đơn giản hóa công việc trên chương trình. Để viết bot cho Telegram, bạn cần sử dụng địa chỉ email này: https://api.telegram.org/bot/ METHOD_NAME

Để bot hoạt động chính xác, cũng cần có mã thông báo - sự kết hợp của các ký tự bảo vệ chương trình và mở quyền truy cập vào nó cho các nhà phát triển đáng tin cậy. Mỗi mã thông báo là duy nhất. Chuỗi được gán cho bot khi tạo. Các phương thức có thể khác nhau: getUpdates, getChat và các phương thức khác. Việc lựa chọn phương pháp phụ thuộc vào thuật toán mà các nhà phát triển mong đợi từ bot. Ví dụ về mã thông báo:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Bots sử dụng các yêu cầu GET và POST. Các tham số phương thức thường phải được bổ sung - ví dụ: khi phương thức sendMessage được cho là gửi id trò chuyện và một số văn bản. Các tham số để tinh chỉnh phương pháp có thể được chuyển dưới dạng chuỗi truy vấn URL bằng application / x-www-form-urlencoded hoặc thông qua application-json. Các phương pháp này không phù hợp để tải xuống tệp. Mã hóa UTF-8 cũng được yêu cầu. Bằng cách gửi yêu cầu tới API, bạn có thể nhận được kết quả ở định dạng JSON. Hãy xem phản ứng của chương trình để truy xuất thông tin qua phương thức getME:

TẢI https://api.telegram.org/bot/ getMe {ok: true, result: {id: 231757398, first_name: "Exchange Rate Bot", tên người dùng: "exchangengetestbot"}}

Kết quả sẽ nhận được nếu ok bằng đúng. Nếu không, hệ thống sẽ báo lỗi.

Có hai cách để nhận thông báo tùy chỉnh trong bot. Cả hai phương pháp đều hiệu quả, nhưng phù hợp trong những trường hợp khác nhau. Để nhận tin nhắn, bạn có thể viết yêu cầu theo cách thủ công bằng phương thức getUpdates - chương trình sẽ hiển thị mảng Cập nhật dữ liệu trên màn hình. Yêu cầu phải được gửi thường xuyên, sau khi phân tích từng mảng, việc gửi được lặp lại. Offset là một tham số xác định số lượng bản ghi bị bỏ qua trước khi tải một kết quả mới để tránh sự xuất hiện lại của các đối tượng đã kiểm tra. Các lợi ích của phương thức getUpdates sẽ phát huy tác dụng nếu:

• không có cách nào để định cấu hình HTTPS;
• các ngôn ngữ kịch bản phức tạp được sử dụng;
• máy chủ bot thay đổi theo thời gian;
• bot được tải với người dùng.

Phương thức thứ hai có thể được viết để nhận tin nhắn của người dùng là setWebhook. Nó được sử dụng một lần, không cần phải liên tục gửi yêu cầu mới. Webhook gửi cập nhật dữ liệu đến URL được chỉ định. Phương pháp này yêu cầu chứng chỉ SSL. Webhook sẽ hữu ích trong những trường hợp sau:

• ngôn ngữ lập trình web được sử dụng;
• bot không bị quá tải, không có quá nhiều người dùng;
• máy chủ không thay đổi, chương trình vẫn trên cùng một máy chủ trong một thời gian dài.

Trong hướng dẫn thêm, chúng tôi sẽ sử dụng getUpdates.

Dịch vụ @BotFather Telegram được thiết kế để tạo các bot trò chuyện. Các cài đặt cơ bản cũng được thiết lập thông qua hệ thống này - BotFather sẽ giúp bạn tạo mô tả, đặt ảnh hồ sơ, thêm các công cụ hỗ trợ. Các thư viện - tập hợp các yêu cầu HTML cho bot Telegram - có sẵn trên Internet, có khá nhiều trong số đó. Khi tạo chương trình ví dụ, pyTelegramBotApi đã được sử dụng.

Bước 1: Thực hiện yêu cầu tỷ giá hối đoái

Đầu tiên bạn cần viết mã thực hiện các truy vấn. Chúng tôi sẽ sử dụng khi viết API PrivatBank, dưới đây là liên kết đến nó: https://api.privatbank.ua/p24api/pubinfo?json&exchange&coursid=5. Bạn cần sử dụng các phương pháp này trong mã của mình:

• load_exchange - tìm tỷ giá hối đoái và hiển thị thông tin được mã hóa;
• get_exchange - hiển thị dữ liệu về một loại tiền cụ thể;
• get_exchanges - hiển thị danh sách tiền tệ theo mẫu.

Do đó, mã trong tệp pb.py trông giống như sau:

nhập lại yêu cầu nhập import json URL = 'https://api.privatbank.ua/p24api/pubinfo?json&exchange&coursid=5' def load_exchange (): return json.loads (request.get (URL) .text) def get_exchange (ccy_key ): for exc in load_exchange (): if ccy_key == exc ['ccy']: return exc return False def get_exchanges (ccy_pattern): result = [] ccy_pattern = re.escape (ccy_pattern) + '. *' for exc in load_exchange (): nếu re.match (ccy_pattern, exc ['ccy'], re.IGNORECASE) không phải là Không có: result.append (exc) trả về kết quả

Chương trình có thể đưa ra phản hồi sau cho các yêu cầu được chỉ định:

[{ccy: "USD", base_ccy: "UAH", buy: "25.90000", sale: "26.25000"}, {ccy: "EUR", base_ccy: "UAH", buy: "29.10000", sale: "29.85000 "}, {ccy:" RUR ", base_ccy:" UAH ", buy:" 0.37800 ", sale:" 0.41800 "}, {ccy:" BTC ", base_ccy:" USD ", buy:" 11220.0384 ", sale: "12401.0950"}]

Bước 2: Tạo một Bot Telegram với @BotFather

Bạn có thể tạo một chương trình để nhận tin nhắn và trả lời chúng bằng cách sử dụng dịch vụ @BotFather. Truy cập trang Telegram của anh ấy và nhập lệnh / newbot. Hướng dẫn sẽ xuất hiện trong cuộc trò chuyện, theo đó bạn cần viết ra tên của bot trước, sau đó là địa chỉ của nó. Khi tài khoản bot được tạo, một thông báo chào mừng có chứa mã thông báo sẽ xuất hiện trên màn hình. Để cấu hình thêm, hãy sử dụng các lệnh sau:

• / setdescription - mô tả;
• / setabouttext - thông tin về bot mới;
• / setuserpic - ảnh hồ sơ;
• / setinline - chế độ nội tuyến;
• / setcommands - mô tả các lệnh.

Ở bước cấu hình cuối cùng, chúng tôi mô tả / trợ giúp và / trao đổi. Khi tất cả các bước đã được hoàn thành, đã đến lúc chuyển sang viết mã.

Bước 3: Thiết lập và khởi chạy Bot

Hãy tạo một tệp config.py. Trong đó, bạn cần chỉ định mã bot duy nhất và múi giờ mà chương trình sẽ tìm thông tin.

TOKEN = ''# thay thế bằng mã thông báo bot của bạnTIMEZONE =' Châu Âu / Kiev 'TIMEZONE_COMMON_NAME =' Kiev '

Tiếp theo, chúng tôi tạo một tệp khác với việc nhập pb.py, thư viện và các thành phần cần thiết khác đã được viết trước đó. Các thư viện bị thiếu được cài đặt từ hệ thống quản lý gói (pip).

import telebotimport configimport pbimport datetimeimport pytzimport jsonimport traceback P_TIMEZONE = pytz.timezone (config.TIMEZONE) TIMEZONE_COMMON_NAME = config.TIMEZONE_COMMON_NAME

Hãy sử dụng nội dung của pyTelegramBotApi để tạo bot. Chúng tôi gửi mã thông báo đã nhận bằng mã sau:

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

Tham số none_stop đảm bảo rằng các yêu cầu được gửi liên tục. Hoạt động của tham số sẽ không bị ảnh hưởng bởi các lỗi phương thức.

Bước 4: Viết / start Command Handler

Nếu tất cả các bước trước đó được thực hiện chính xác, bot đã bắt đầu hoạt động. Chương trình tạo ra các yêu cầu thường xuyên vì nó sử dụng phương thức getUpdates. Trước dòng có phần tử none_stop, chúng ta cần một đoạn mã xử lý lệnh / start:

@ bot.message_handler (command = ['start']) def start_command (message): bot.send_message (message.chat.id, 'Xin chào! Tôi có thể hiển thị cho bạn tỷ giá hối đoái.n' + 'Để nhận tỷ giá hối đoái, hãy nhấn / exchange.n '+' Để nhận trợ giúp, hãy nhấn / help. ')

RSЂRё lệnh = ['start'] bằng True start_command được gọi. Nội dung của tin nhắn đến đó. Tiếp theo, bạn cần triển khai chức năng gửi_thông điệp liên quan đến một thông điệp cụ thể.

Bước 5: Tạo một / help Command Handler

Lệnh / help có thể được thực hiện dưới dạng một nút. Bằng cách nhấp vào nó, người dùng sẽ được đưa đến tài khoản Telegram của nhà phát triển. Đặt tên cho nút, chẳng hạn như “Hỏi nhà phát triển”. Đặt tham số reply_markup, chuyển hướng người dùng đến một liên kết, cho phương thức send_message. Hãy viết mã tham số tạo bàn phím (InlineKeyboardMarkup). Bạn chỉ cần một nút (InlineKeyboardButton).

Mã trình xử lý lệnh cuối cùng trông giống như sau:

@ bot.message_handler (command = ['help']) def help_command (message): keyboard = telebot.types.InlineKeyboardMarkup () keyboard.add (telebot.types.InlineKeyboardButton ('Hỏi nhà phát triển', url = 'ваша ссылка на профиль ')) bot.send_message (message.chat.id,' 1) Để nhận danh sách các đơn vị tiền tệ có sẵn, hãy nhấn /exchange.n '+' 2) Nhấp vào đơn vị tiền tệ bạn quan tâm .n '+' 3) Bạn sẽ nhận được một thông báo có chứa thông tin về nguồn và đơn vị tiền tệ mục tiêu, '+' tỷ giá mua và tỷ giá bán. n '+' 4) Nhấp vào "Cập nhật" để nhận thông tin hiện tại về yêu cầu. '+' Bot cũng sẽ hiển thị sự khác biệt giữa tỷ giá hối đoái trước đây và hiện tại. N '+' 5) Bot hỗ trợ nội tuyến. Loại hình @ trong bất kỳ cuộc trò chuyện nào và các chữ cái đầu tiên của đơn vị tiền tệ. ', reply_markup = keyboard)

Hành động mã trong trò chuyện Telegram:

Bước 6: Thêm / Exchange Command Handler

Bước này là cần thiết để hiển thị các nút có biểu tượng của các loại tiền hiện có trong cuộc trò chuyện. Bàn phím ảo với các tùy chọn sẽ giúp bạn tránh những sai lầm. PrivatBank cung cấp thông tin về đồng rúp, đô la và đồng euro. Tùy chọn InlineKeyboardButton hoạt động như sau:

1. Người dùng nhấp vào nút có chỉ định mong muốn.
2. getUpdates nhận được một cuộc gọi lại (CallbackQuery).
3. Nó được biết đến như thế nào để xử lý việc nhấn bàn phím - thông tin về nút đã nhấn được truyền đi.

/ mã trình xử lý trao đổi:

@ bot.message_handler (command = ['exchange']) def exchange_command (message): keyboard = 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, 'Nhấp vào đơn vị tiền tệ bạn chọn:', reply_markup = keyboard)

Kết quả của mã trong Telegram:

Bước 7: Viết trình xử lý cho các nút bàn phím tích hợp

Gói pyTelegramBot Api chứa hàm trang trí @ bot.callback_query_handler. Thành phần này được thiết kế để dịch lệnh gọi lại thành một hàm - API mở và tạo lại lệnh gọi. Nó được đánh vần như thế này:

@ bot.callback_query_handler (func = lambda call: True) def iq_callback (query): data = query.data if data.startswith ('get-'): get_ex_callback (query)

Cũng hãy viết phương thức get_ex_callback:

def get_ex_callback (truy vấn): bot.answer_callback_query (query.id) send_exchange_result (query.message, query.data [4:])

Có một phương pháp hữu ích khác - answer_callback_query. Nó giúp loại bỏ tải trọng giữa việc nhấn nút và hiển thị kết quả trên màn hình. Bạn có thể gửi tin nhắn tới send_exchange_query bằng cách chuyển một số mã tiền tệ và Tin nhắn. Hãy viết send_exchange_result:

def send_exchange_result (message, ex_code): bot.send_chat_action (message.chat.id, 'enter') ex = pb.get_exchange (ex_code) bot.send_message (message.chat.id, serialize_ex (ex), reply_markup = get_update_keyboard (ex ), parse_mode = 'HTML')

Trong khi chatbot nhận được kết quả của yêu cầu từ ngân hàng API, khách truy cập nhìn thấy dòng chữ "đang nhập tin nhắn". Có vẻ như một người thật đang trả lời. Để hiển thị một chỉ báo như vậy trên màn hình, bạn sẽ cần thêm các dòng trạng thái đầu vào. Tiếp theo, chúng tôi sẽ sử dụng get_exchange - với sự trợ giúp của nó, chương trình sẽ nhận được chỉ định tiền tệ (rúp, euro hoặc đô la). send_message sử dụng các phương thức bổ sung: serialize_ex chuyển đổi đơn vị tiền tệ sang định dạng khác và get_update_keyboard thiết lập phím chức năng cập nhật thông tin và gửi dữ liệu thị trường tiền tệ tới các cuộc trò chuyện khác.

Hãy viết mã cho get_update_keyboard. Hai nút cần được đề cập - t và e là viết tắt của loại và trao đổi. Mục switch_inline_query cho nút Chia sẻ là cần thiết để người dùng có thể chọn từ một số cuộc trò chuyện. Khách truy cập sẽ có thể chọn người để gửi tỷ giá hối đoái hiện tại của đồng đô la, đồng rúp hoặc đồng euro.

def get_update_keyboard (ex): keyboard = telebot.types.InlineKeyboardMarkup () keyboard.row (telebot.types.InlineKeyboardButton ('Update', callback_data = json.dumps ({'t': 'u', 'e': {') b ': ex [' buy '],' s ': ex [' sale '],' c ': ex [' ccy ']}}). Replace (' ',' ')), telebot.types.InlineKeyboardButton ('Chia sẻ', switch_inline_query = ex ['ccy'])) trả về bàn phím

Đôi khi bạn cần xem tỷ giá hối đoái đã thay đổi bao nhiêu trong một thời gian ngắn. Hãy viết hai phương pháp cho nút Cập nhật để người dùng có thể xem các khóa học so sánh.

Chênh lệch giữa tỷ giá hối đoái được chuyển đến bộ tuần tự thông qua tham số diff.

Các phương pháp được chỉ định chỉ hoạt động sau khi dữ liệu được cập nhật, chúng sẽ không ảnh hưởng đến hiển thị đầu tiên của khóa học.

def serialize_ex (ex_json, diff = None): result = ''+ ex_json [' base_ccy '] +' -> '+ ex_json [' ccy '] +':nn' + 'Mua: ' + ex_json['buy'] if diff: result += ' ' + serialize_exchange_diff(diff['buy_diff']) + 'n' + 'Sell: ' + ex_json['sale'] + ' ' + serialize_exchange_diff(diff['sale_diff']) + 'n' other: result += 'nSell: ' + ex_json['sale'] + 'n' trả về kết quả def serialize_exchange_diff(diff): result = '' if diff > 0: kết quả = '(' + 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: result = '(' + 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">)' trả về kết quả

Hãy tưởng tượng rằng khách truy cập muốn biết tỷ giá hối đoái đô la. Đây là những gì sẽ xảy ra nếu bạn chọn USD trong thông báo:

Bước 8: Triển khai trình xử lý nút cập nhật

Hãy viết mã để xử lý các hành động bằng nút Cập nhật và thêm phần iq_callback_method vào đó. Khi các mục chương trình bắt đầu bằng tham số get, bạn phải viết get_ex_callback. Trong các tình huống khác, chúng tôi phân tích cú pháp JSON và cố gắng lấy khóa t.

@ bot.callback_query_handler (func = lambda call: True) def iq_callback (query): data = query.data if data.startswith ('get-'): get_ex_callback (query) else: try: if json.loads (data) [ 't'] == 'u': edit_message_callback (truy vấn) ngoại trừ ValueError: pass

Nếu t bằng u, bạn sẽ cần viết một chương trình cho phương thức edit_message_callback. Hãy chia nhỏ quá trình này từng bước:

1. Tải xuống thông tin cập nhật về trạng thái của thị trường tiền tệ (exchange_now = pb.get_exchange (data ['c']).

2. Viết một tin nhắn mới thông qua một bộ tuần tự có khác biệt.
3. Thêm chữ ký (get_edited_signature).

Nếu thông báo ban đầu không thay đổi, hãy gọi phương thức edit_message_text.

def edit_message_callback (query): data = json.loads (query.data) ['e'] exchange_now = pb.get_exchange (data ['c']) text = serialize_ex (exchange_now, get_exchange_diff (get_ex_from_iq_data (data), exchange_now)) + 'n' + get_edited_signature () if query.message: bot.edit_message_text (text, query.message.chat.id, query.message.message_id, reply_markup = get_update_keyboard (exchange_now), parse_mode = 'HTML') elif query.inline : bot.edit_message_text (text, inline_message_id = query.inline_message_id, reply_markup = get_update_keyboard (exchange_now), parse_mode = 'HTML')

Hãy viết phương thức get_ex_from_iq_data để phân tích cú pháp JSON:

def get_ex_from_iq_data (exc_json): return {'buy': exc_json ['b'], 'sale': exc_json ['s']}

Bạn sẽ cần thêm một số phương pháp: ví dụ: get_exchange_diff, phương thức này đọc thông tin cũ và mới về chi phí tiền tệ và hiển thị sự khác biệt.

def get_exchange_diff (last, now): return {'sale_diff': float ("%. 6f"% (float (now ['sale']) - float (last ['sale']))), 'buy_diff': float ("% .6f"% (float (now ['buy']) - float (last ['buy'])))}

Phần cuối cùng, get_edited_signature, hiển thị thời gian khóa học được cập nhật lần cuối.

def get_edited_signature (): return 'Đã cập nhật '+ str (datetime.datetime.now (P_TIMEZONE) .strftime ('% H:% M:% S ')) +' ('+ TIMEZONE_COMMON_NAME +')'

Do đó, thông báo cập nhật từ bot với tỷ giá hối đoái ổn định sẽ như sau:

Khi khóa học thay đổi, sự khác biệt giữa các giá trị được hiển thị trong thông báo do các tham số quy định.

Bước 9: Triển khai chế độ nhúng

Chế độ tích hợp là cần thiết để nhanh chóng gửi thông tin từ chương trình đến bất kỳ cuộc trò chuyện nào - giờ đây bạn không cần thêm bot vào cuộc trò chuyện với tư cách là người tham gia. Khi người dùng Telegram nhập tên bot có ký hiệu @ phía trước, các tùy chọn chuyển đổi sẽ xuất hiện phía trên dòng nhập. Nếu bạn nhấp vào một trong các mục, bot sẽ gửi thông báo đến cuộc trò chuyện với kết quả và các nút cập nhật và gửi dữ liệu. Tên người gửi sẽ có chú thích “qua ".

InlineQuery được chuyển tới query_text thông qua thư viện. Đoạn mã sử dụng hàm answer_line để truy xuất kết quả tìm kiếm dưới dạng một mảng dữ liệu và phần tử inline_query_id. Chúng tôi sử dụng get_exchanges để bot tìm một số đơn vị tiền tệ theo yêu cầu.

@ bot.inline_handler (func = lambda query: True) def query_text (inline_query): bot.answer_inline_query (inline_query.id, get_iq_articles (pb.get_exchanges (inline_query.query)))

Chúng tôi truyền một mảng dữ liệu đến get_iq_articles để trả về các đối tượng từ InlineQueryResultArticle thông qua phương thức này.

def get_iq_articles (Exchange): result = [] for exc in Exchange: result.append (telebot.types.InlineQueryResultArticle (id = exc ['ccy'], title = exc ['ccy'], input_message_content = telebot.types.InputTextMessageContent (serialize_ex (exc), parse_mode = 'HTML'), reply_markup = get_update_keyboard (exc), description = 'Convert' + exc ['base_ccy'] + '->' + exc ['ccy'], thumb_height = 1)) trả về kết quả

Bây giờ, nếu bạn viết @ và một khoảng trắng trong dòng, kết quả tìm kiếm sẽ xuất hiện trên màn hình - các tùy chọn để chuyển đổi thành ba loại tiền tệ có sẵn.

Người dùng có thể lọc kết quả bằng cách nhập đơn vị tiền tệ mong muốn.

Sau khi nhấp vào đơn vị tiền tệ mong muốn từ danh sách, cuộc trò chuyện sẽ nhận được cùng một thông báo mà người dùng bot nhận được. Bạn cũng có thể sử dụng nút Cập nhật. Hình ảnh dưới đây cho thấy thông báo cập nhật được gửi qua bot:

Kết luận

Bây giờ bạn đã biết cách tạo bot cho Telegram. Bạn có thể thêm các công cụ hữu ích vào chương trình của mình: các nút để cập nhật và gửi kết quả cho những người dùng khác của messenger và một chế độ tích hợp cho phép bạn sử dụng các chức năng của bot bên ngoài cuộc trò chuyện với nó. Dựa trên hướng dẫn này, bạn có thể tạo bất kỳ bot đơn giản nào với các chức năng khác - không chỉ bot hiển thị tỷ giá hối đoái. Đừng ngại thử nghiệm với các thư viện, API và mã để tạo một trợ lý tự động có thể trò chuyện với khách hàng trên Telegram và tăng cường kết nối của những người quan tâm với công ty.