{"id":499415,"date":"2026-10-20T14:13:18","date_gmt":"2026-10-20T11:13:18","guid":{"rendered":"https:\/\/savepearlharbor.com\/?p=499415"},"modified":"2026-10-20T14:13:18","modified_gmt":"2026-10-20T11:13:18","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=499415","title":{"rendered":"\u041f\u0435\u0440\u0435\u043d\u043e\u0441\u0438\u043c \u0431\u043e\u0442\u0430 \u0438\u0437 Telegram \u0432 MAX: \u0447\u0442\u043e \u043e\u0442\u043b\u0438\u0447\u0430\u0435\u0442\u0441\u044f \u0432 API \u0438 \u043a\u0430\u043a \u043d\u0435 \u043f\u0435\u0440\u0435\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u043b\u043e\u0433\u0438\u043a\u0443"},"content":{"rendered":"
\n

\u0423 \u043c\u0435\u043d\u044f \u0435\u0441\u0442\u044c \u0431\u043e\u0442-\u043a\u043e\u043d\u0441\u0443\u043b\u044c\u0442\u0430\u043d\u0442: \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u043a\u043b\u0438\u0435\u043d\u0442\u0430\u043c, \u0443\u0442\u043e\u0447\u043d\u044f\u0435\u0442 \u0437\u0430\u0434\u0430\u0447\u0443 \u0438 \u043e\u0444\u043e\u0440\u043c\u043b\u044f\u0435\u0442 \u0437\u0430\u044f\u0432\u043a\u0443. \u041e\u043d \u043d\u0430\u043f\u0438\u0441\u0430\u043d \u043d\u0430 aiogram 3 \u0438 \u0436\u0438\u0432\u0451\u0442 \u0432\u043d\u0443\u0442\u0440\u0438 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u043d\u0430 FastAPI, \u0438\u0441\u0442\u043e\u0440\u0438\u044e \u0434\u0435\u0440\u0436\u0438\u0442 \u0432 PostgreSQL, \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u044f \u0438 \u0441\u0447\u0451\u0442\u0447\u0438\u043a\u0438 \u0432 Redis, \u0440\u0430\u0437\u0433\u043e\u0432\u0430\u0440\u0438\u0432\u0430\u0435\u0442 \u0447\u0435\u0440\u0435\u0437 Claude. \u0421 \u0444\u0435\u0432\u0440\u0430\u043b\u044f 2026 Telegram \u0432 \u0420\u043e\u0441\u0441\u0438\u0438 \u0437\u0430\u043c\u0435\u0434\u043b\u044f\u044e\u0442 \u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u043e, \u0438 \u0447\u0430\u0441\u0442\u044c \u043b\u044e\u0434\u0435\u0439 \u0434\u043e \u0431\u043e\u0442\u0430 \u043f\u0440\u043e\u0441\u0442\u043e \u043d\u0435 \u0434\u043e\u0445\u043e\u0434\u0438\u0442. \u0416\u0430\u043b\u043e\u0431 \u043e\u0442 \u043d\u0438\u0445 \u043d\u0435\u0442, \u043e\u043d\u0438 \u043c\u043e\u043b\u0447\u0430 \u043d\u0435 \u0434\u043e\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0442.<\/p>\n

\u041f\u0435\u0440\u0435\u043f\u0438\u0441\u044b\u0432\u0430\u0442\u044c \u0431\u043e\u0442\u0430 \u043f\u043e\u0434 MAX \u0441 \u043d\u0443\u043b\u044f \u043d\u0435 \u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c. \u042f \u0438\u0441\u0445\u043e\u0434\u0438\u043b \u0438\u0437 \u0442\u043e\u0433\u043e, \u0447\u0442\u043e \u043a\u0430\u043d\u0430\u043b \u2014 \u044d\u0442\u043e \u0442\u043e\u043b\u044c\u043a\u043e \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442. \u0415\u0441\u043b\u0438 \u043b\u043e\u0433\u0438\u043a\u0430, \u0431\u0430\u0437\u0430 \u0438 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 \u043e\u0442\u0434\u0435\u043b\u0435\u043d\u044b \u043e\u0442 \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0430, \u0432\u0442\u043e\u0440\u043e\u0439 \u043a\u0430\u043d\u0430\u043b \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0441\u044f \u0430\u0434\u0430\u043f\u0442\u0435\u0440\u043e\u043c \u043d\u0430 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0441\u043e\u0442\u0435\u043d \u0441\u0442\u0440\u043e\u043a. \u041d\u0438\u0436\u0435 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u044e, \u0447\u0442\u043e \u0432 MAX Bot API \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u043e \u0438\u043d\u0430\u0447\u0435, \u0447\u0435\u043c \u0432 Telegram, \u0433\u0434\u0435 \u044f \u043f\u043e\u0442\u0435\u0440\u044f\u043b \u0432\u0440\u0435\u043c\u044f \u0438 \u043a\u0430\u043a \u0432\u0441\u0451 \u044d\u0442\u043e \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u043b\u043e\u0441\u044c \u0431\u0435\u0437 \u0431\u043e\u0435\u0432\u043e\u0433\u043e \u0442\u043e\u043a\u0435\u043d\u0430.<\/p>\n

\u041a\u0430\u043a \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u043e \u044f\u0434\u0440\u043e, \u0447\u0442\u043e\u0431\u044b \u0442\u0440\u0430\u043d\u0441\u043f\u043e\u0440\u0442 \u0431\u044b\u043b \u0441\u043c\u0435\u043d\u043d\u044b\u043c<\/h3>\n

\u041a\u043e\u043d\u0441\u0443\u043b\u044c\u0442\u0430\u043d\u0442 \u0443 \u043c\u0435\u043d\u044f \u2014 \u044d\u0442\u043e \u0430\u0433\u0435\u043d\u0442\u043d\u044b\u0439 \u0446\u0438\u043a\u043b. \u0411\u0435\u0440\u0451\u043c \u0438\u0441\u0442\u043e\u0440\u0438\u044e \u0434\u0438\u0430\u043b\u043e\u0433\u0430 \u0438\u0437 \u0431\u0430\u0437\u044b, \u043e\u0442\u0434\u0430\u0451\u043c \u043c\u043e\u0434\u0435\u043b\u0438; \u043f\u043e\u043a\u0430 \u043e\u043d\u0430 \u043f\u0440\u043e\u0441\u0438\u0442 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442, \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u043c \u0435\u0433\u043e; \u0432 \u043a\u043e\u043d\u0446\u0435 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u0442\u0435\u043a\u0441\u0442 \u043e\u0442\u0432\u0435\u0442\u0430. \u0418\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442 \u0443 \u043c\u043e\u0434\u0435\u043b\u0438 \u0440\u043e\u0432\u043d\u043e \u043e\u0434\u0438\u043d, submit_lead<\/code>: \u043a\u043e\u0433\u0434\u0430 \u0437\u0430\u0434\u0430\u0447\u0430 \u043a\u043b\u0438\u0435\u043d\u0442\u0430 \u043f\u043e\u043d\u044f\u0442\u043d\u0430, \u043c\u043e\u0434\u0435\u043b\u044c \u0437\u0430\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u043f\u043e\u043b\u044f \u0437\u0430\u044f\u0432\u043a\u0438, \u0437\u0430\u043f\u0438\u0441\u044c \u043b\u043e\u0436\u0438\u0442\u0441\u044f \u0432 \u0431\u0430\u0437\u0443, \u0430 \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0441 \u043a\u043d\u043e\u043f\u043a\u0430\u043c\u0438 \u0443\u0445\u043e\u0434\u0438\u0442 \u0432 \u0440\u0430\u0431\u043e\u0447\u0438\u0439 \u0447\u0430\u0442. \u041d\u0438 \u043e\u0434\u043d\u0430 \u0441\u0442\u0440\u043e\u043a\u0430 \u044d\u0442\u043e\u0433\u043e \u0446\u0438\u043a\u043b\u0430 \u043d\u0435 \u0437\u043d\u0430\u0435\u0442, \u0438\u0437 \u043a\u0430\u043a\u043e\u0433\u043e \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0430 \u043f\u0440\u0438\u0448\u0451\u043b \u0447\u0435\u043b\u043e\u0432\u0435\u043a.<\/p>\n

\u0427\u0442\u043e\u0431\u044b \u0442\u0430\u043a \u043f\u043e\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c, \u0430\u0434\u0430\u043f\u0442\u0435\u0440 \u0434\u043e\u043b\u0436\u0435\u043d \u0441\u043e\u0431\u043b\u044e\u0441\u0442\u0438 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0434\u043e\u0433\u043e\u0432\u043e\u0440\u0451\u043d\u043d\u043e\u0441\u0442\u0435\u0439.<\/p>\n

\u041d\u0430\u0447\u043d\u0451\u043c \u0441 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f. \u0412 Telegram \u0443 \u043d\u0435\u0433\u043e \u0435\u0441\u0442\u044c id<\/code>, username<\/code> \u0438 \u0438\u043c\u044f, \u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0437\u0430\u0432\u043e\u0434\u0438\u0442 \u0437\u0430\u043f\u0438\u0441\u044c \u043f\u043e \u044d\u0442\u0438\u043c \u043f\u043e\u043b\u044f\u043c. \u0414\u043b\u044f MAX \u044f \u0441\u0434\u0435\u043b\u0430\u043b \u00ab\u0443\u0442\u0438\u043d\u044b\u0439\u00bb \u043e\u0431\u044a\u0435\u043a\u0442 \u0441 \u0442\u0435\u043c\u0438 \u0436\u0435 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430\u043c\u0438, \u0438 \u0444\u0443\u043d\u043a\u0446\u0438\u044f get_or_create_user<\/code> \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0434\u043b\u044f \u043e\u0431\u043e\u0438\u0445 \u043a\u0430\u043d\u0430\u043b\u043e\u0432, \u043d\u0435 \u0437\u043d\u0430\u044f \u043e \u0440\u0430\u0437\u043b\u0438\u0447\u0438\u044f\u0445:<\/p>\n

class _MaxUser:    \"\"\"Duck-typed stand-in for an aiogram User, so repo.get_or_create_user works for both channels.\"\"\"    def __init__(self, raw: dict[str, Any]):        self.max_id = int(raw[\"user_id\"])        self.id = -self.max_id  # negative ids = MAX users        self.username = raw.get(\"username\") or None        name = raw.get(\"name\") or \" \".join(p for p in (raw.get(\"first_name\"), raw.get(\"last_name\")) if p)        self.full_name = name or None<\/code>
<\/span><\/a><\/div><\/pre>\n
\u0414\u0430\u043b\u044c\u0448\u0435 \u043e\u0431\u0449\u0430\u044f \u0442\u0430\u0431\u043b\u0438\u0446\u0430. \u041f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u043e\u0431\u043e\u0438\u0445 \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u043e\u0432 \u043b\u0435\u0436\u0430\u0442 \u0432 \u043e\u0434\u043d\u043e\u0439 \u0442\u0430\u0431\u043b\u0438\u0446\u0435 users<\/code>. \u0427\u0442\u043e\u0431\u044b \u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0441\u0442\u0432\u0430 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u043e\u0432 \u043d\u0435 \u043f\u0435\u0440\u0435\u0441\u0435\u043a\u043b\u0438\u0441\u044c, id \u0438\u0437 MAX \u0445\u0440\u0430\u043d\u0438\u0442\u0441\u044f \u043e\u0442\u0440\u0438\u0446\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u043c, \u0430 \u043f\u043e\u043b\u0435 channel<\/code> \u0433\u043e\u0432\u043e\u0440\u0438\u0442, \u043e\u0442\u043a\u0443\u0434\u0430 \u0447\u0435\u043b\u043e\u0432\u0435\u043a. \u0422\u043e\u0442 \u0436\u0435 \u043f\u0440\u0438\u0451\u043c \u0441 \u043a\u043b\u044e\u0447\u0430\u043c\u0438 \u0432 Redis: \u0430\u043d\u0442\u0438\u0444\u043b\u0443\u0434 \u0438 \u0434\u043d\u0435\u0432\u043d\u043e\u0439 \u0431\u044e\u0434\u0436\u0435\u0442 \u0442\u043e\u043a\u0435\u043d\u043e\u0432 \u0441\u0447\u0438\u0442\u0430\u044e\u0442\u0441\u044f \u043f\u043e \u0442\u043e\u043c\u0443 \u0436\u0435 \u043e\u0442\u0440\u0438\u0446\u0430\u0442\u0435\u043b\u044c\u043d\u043e\u043c\u0443 id, \u0438 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u0432\u0435\u0442\u043e\u043a \u0434\u043b\u044f \u0432\u0442\u043e\u0440\u043e\u0433\u043e \u043a\u0430\u043d\u0430\u043b\u0430 \u0432 \u043a\u043e\u0434\u0435 \u043d\u0435\u0442.<\/p>\n
\u0418 \u0432\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435. \u041a\u0430\u043d\u0430\u043b \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u043e\u0434\u043d\u043e\u0439 \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0439 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f MAX_BOT_TOKEN<\/code>. \u041f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u0430\u044f \u043f\u0443\u0441\u0442\u0430\u044f, \u0438 \u043a\u043b\u0438\u0435\u043d\u0442 MAX \u0440\u0430\u0432\u0435\u043d None<\/code>; \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u043e\u0435 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u044d\u0442\u043e\u0433\u043e \u043d\u0435 \u0437\u0430\u043c\u0435\u0447\u0430\u0435\u0442.<\/p>\n
\u0427\u0442\u043e \u0432 MAX Bot API \u0443\u0441\u0442\u0440\u043e\u0435\u043d\u043e \u0438\u043d\u0430\u0447\u0435<\/h3>\n
\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u043d\u0430 dev.max.ru \u044f \u0441\u0432\u0435\u0440\u044f\u043b 1 \u043e\u043a\u0442\u044f\u0431\u0440\u044f 2026 \u0441 \u0442\u0435\u043c, \u0447\u0442\u043e \u0440\u0435\u0430\u043b\u044c\u043d\u043e \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u0441\u0435\u0440\u0432\u0435\u0440. \u0412\u043e\u0442 \u0447\u0442\u043e \u043e\u0442\u043b\u0438\u0447\u0430\u0435\u0442\u0441\u044f \u043e\u0442 Telegram Bot API \u0438 \u043e\u0442 \u0441\u0442\u0430\u0440\u044b\u0445 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0433\u0443\u043b\u044f\u044e\u0442 \u043f\u043e \u0441\u0435\u0442\u0438.<\/p>\n
\u0425\u043e\u0441\u0442 \u0442\u0435\u043f\u0435\u0440\u044c platform-api2.max.ru<\/code>. \u0421\u0442\u0430\u0440\u044b\u0439 platform-api.max.ru<\/code> \u0438\u0437 \u0440\u0430\u043d\u043d\u0438\u0445 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u0432 \u0443\u0436\u0435 \u043d\u0435 \u0442\u043e\u0442.<\/p>\n
\u0422\u043e\u043a\u0435\u043d \u043f\u0435\u0440\u0435\u0434\u0430\u0451\u0442\u0441\u044f \u0432 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0435 Authorization<\/code> \u043a\u0430\u043a \u0435\u0441\u0442\u044c, \u0431\u0435\u0437 Bearer<\/code> \u0438 \u0431\u0435\u0437 query-\u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430.<\/p>\n
\u0421\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u043c POST \/messages?user_id=\u2026<\/code> \u0438\u043b\u0438 ?chat_id=\u2026<\/code>, \u043f\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u0447\u0435\u0440\u0435\u0437 PUT \/messages?message_id=\u2026<\/code>, \u043e\u0442\u0432\u0435\u0442 \u043d\u0430 \u043d\u0430\u0436\u0430\u0442\u0438\u0435 \u043a\u043d\u043e\u043f\u043a\u0438 \u0443\u0445\u043e\u0434\u0438\u0442 \u0432 POST \/answers?callback_id=\u2026<\/code>. \u0415\u0441\u043b\u0438 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 \u043d\u0430 \u043a\u043d\u043e\u043f\u043a\u0443 \u043f\u0435\u0440\u0435\u0434\u0430\u0442\u044c message<\/code>, \u0438\u0441\u0445\u043e\u0434\u043d\u043e\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0437\u0430\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u0446\u0435\u043b\u0438\u043a\u043e\u043c. \u0422\u0430\u043a \u0443 \u043c\u0435\u043d\u044f \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043a\u0430\u0440\u0442\u043e\u0447\u043a\u0430 \u0437\u0430\u044f\u0432\u043a\u0438 \u043f\u043e\u0441\u043b\u0435 \u043a\u043d\u043e\u043f\u043a\u0438 \u00ab\u0412\u0437\u044f\u0442\u044c \u0432 \u0440\u0430\u0431\u043e\u0442\u0443\u00bb.<\/p>\n
\u041b\u0438\u043c\u0438\u0442\u044b \u0442\u0430\u043a\u0438\u0435: 30 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432 \u0432 \u0441\u0435\u043a\u0443\u043d\u0434\u0443 \u0438 4 000 \u0437\u043d\u0430\u043a\u043e\u0432 \u0432 \u0442\u0435\u043a\u0441\u0442\u0435. \u041d\u0430 429 \u043a\u043b\u0438\u0435\u043d\u0442 \u0434\u0435\u043b\u0430\u0435\u0442 \u043f\u0430\u0443\u0437\u0443 \u0432 \u0441\u0435\u043a\u0443\u043d\u0434\u0443 \u0438 \u043f\u043e\u0432\u0442\u043e\u0440\u044f\u0435\u0442 \u0437\u0430\u043f\u0440\u043e\u0441 \u043e\u0434\u0438\u043d \u0440\u0430\u0437, \u0434\u043b\u0438\u043d\u043d\u044b\u0439 \u043e\u0442\u0432\u0435\u0442 \u043c\u043e\u0434\u0435\u043b\u0438 \u0440\u0435\u0436\u0435\u0442\u0441\u044f \u043d\u0430 \u0447\u0430\u0441\u0442\u0438 \u043f\u043e \u0430\u0431\u0437\u0430\u0446\u0430\u043c \u0438 \u043f\u0440\u043e\u0431\u0435\u043b\u0430\u043c.<\/p>\n
\u041a\u043b\u0430\u0432\u0438\u0430\u0442\u0443\u0440\u0430 \u043e\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0432\u043b\u043e\u0436\u0435\u043d\u0438\u0435\u043c \u0442\u0438\u043f\u0430 inline_keyboard<\/code>, \u043a\u043d\u043e\u043f\u043a\u0438 \u0431\u044b\u0432\u0430\u044e\u0442 callback<\/code> \u0441 payload \u0438 link<\/code> \u0441 url.<\/p>\n
def inline_keyboard(rows: list[list[dict[str, str]]]) -> dict[str, Any]:    buttons = []    for row in rows:        out = []        for b in row:            if \"url\" in b:                out.append({\"type\": \"link\", \"text\": b[\"text\"], \"url\": b[\"url\"]})            else:                out.append({\"type\": \"callback\", \"text\": b[\"text\"], \"payload\": b[\"payload\"]})        buttons.append(out)    return {\"type\": \"inline_keyboard\", \"payload\": {\"buttons\": buttons}}<\/code>
<\/span><\/a><\/div><\/pre>\n
\u0411\u043e\u043b\u044c\u0448\u0435 \u0432\u0441\u0435\u0433\u043e \u0432\u0440\u0435\u043c\u0435\u043d\u0438 \u0441\u044a\u0435\u043b \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442. \u0421\u0435\u0440\u0432\u0435\u0440 platform-api2.max.ru<\/code> \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442, \u0432\u044b\u043f\u0443\u0449\u0435\u043d\u043d\u044b\u0439 \u00abRussian Trusted Sub CA\u00bb, \u044d\u0442\u043e \u0446\u0435\u043f\u043e\u0447\u043a\u0430 \u041c\u0438\u043d\u0446\u0438\u0444\u0440\u044b. \u0412 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0445 \u043d\u0430\u0431\u043e\u0440\u0430\u0445 \u043a\u043e\u0440\u043d\u0435\u0432\u044b\u0445 \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0432 \u0435\u0451 \u043d\u0435\u0442, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 aiohttp \u0447\u0435\u0441\u0442\u043d\u043e \u043f\u0430\u0434\u0430\u0435\u0442 \u0441 CERTIFICATE_VERIFY_FAILED<\/code>. \u041e\u0442\u043a\u043b\u044e\u0447\u0430\u0442\u044c \u043f\u0440\u043e\u0432\u0435\u0440\u043a\u0443 \u043d\u0435\u043b\u044c\u0437\u044f, \u0438\u043d\u0430\u0447\u0435 \u0442\u043e\u043a\u0435\u043d \u0431\u043e\u0442\u0430 \u0443\u0439\u0434\u0451\u0442 \u043f\u0435\u0440\u0432\u043e\u043c\u0443, \u043a\u0442\u043e \u0432\u0441\u0442\u0430\u043d\u0435\u0442 \u043f\u043e\u0441\u0435\u0440\u0435\u0434\u0438\u043d\u0435. \u042f \u0434\u043e\u0431\u0430\u0432\u0438\u043b \u043f\u0440\u043e\u043c\u0435\u0436\u0443\u0442\u043e\u0447\u043d\u044b\u0439 \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442 \u0434\u043e\u0432\u0435\u0440\u0435\u043d\u043d\u044b\u043c \u044f\u043a\u043e\u0440\u0435\u043c \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u043a\u043b\u0438\u0435\u043d\u0442\u0430 MAX, \u0430 \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u043e\u0435 \u0445\u0440\u0430\u043d\u0438\u043b\u0438\u0449\u0435 \u0438 \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u044f \u0441 Telegram \u0438 Anthropic \u043e\u0441\u0442\u0430\u0432\u0438\u043b \u043a\u0430\u043a \u0431\u044b\u043b\u0438.<\/p>\n
_CA_FILE = Path(__file__).parent \/ \"certs\" \/ \"russian_trusted_sub_ca.pem\"def _ssl_context() -> ssl.SSLContext:    ctx = ssl.create_default_context()    if _CA_FILE.exists():        ctx.load_verify_locations(cafile=str(_CA_FILE))        ctx.verify_flags |= ssl.VERIFY_X509_PARTIAL_CHAIN  # the Sub CA is the anchor; its root is not shipped    return ctx<\/code>
<\/span><\/a><\/div><\/pre>\n
\u0424\u043b\u0430\u0433 VERIFY_X509_PARTIAL_CHAIN<\/code> \u043d\u0443\u0436\u0435\u043d, \u043f\u043e\u0442\u043e\u043c\u0443 \u0447\u0442\u043e \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442 \u041c\u0438\u043d\u0446\u0438\u0444\u0440\u044b \u0432 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u044f \u043d\u0435 \u043a\u043b\u0430\u0434\u0443. \u042f\u043a\u043e\u0440\u0435\u043c \u0441\u043b\u0443\u0436\u0438\u0442 \u043f\u0440\u043e\u043c\u0435\u0436\u0443\u0442\u043e\u0447\u043d\u044b\u0439, \u0442\u043e\u0442 \u0441\u0430\u043c\u044b\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u0438\u0441\u044b\u043b\u0430\u0435\u0442 \u0441\u0435\u0440\u0432\u0435\u0440. \u0415\u0433\u043e \u043e\u0442\u043f\u0435\u0447\u0430\u0442\u043e\u043a \u0437\u0430\u043f\u0438\u0441\u0430\u043d \u0440\u044f\u0434\u043e\u043c \u0432 README, \u0447\u0442\u043e\u0431\u044b \u043f\u0440\u0438 \u0437\u0430\u043c\u0435\u043d\u0435 \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u0430 \u0431\u044b\u043b\u043e \u0441 \u0447\u0435\u043c \u0441\u0440\u0430\u0432\u043d\u0438\u0442\u044c.<\/p>\n
\u0422\u0438\u043f\u044b \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0439, \u043d\u0430 \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u044f \u043f\u043e\u0434\u043f\u0438\u0441\u044b\u0432\u0430\u044e\u0441\u044c: message_created<\/code>, message_callback<\/code>, bot_started<\/code>, bot_added<\/code>, bot_admin_permissions_changed<\/code>. \u041f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0435 \u0434\u0432\u0430 \u043d\u0443\u0436\u043d\u044b \u0434\u043b\u044f \u0431\u044b\u0442\u043e\u0432\u043e\u0439 \u0432\u0435\u0449\u0438. \u041a\u043e\u0433\u0434\u0430 \u0431\u043e\u0442\u0430 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u044e\u0442 \u0432 \u0433\u0440\u0443\u043f\u043f\u0443 \u0438 \u0434\u0435\u043b\u0430\u044e\u0442 \u0430\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0442\u043e\u0440\u043e\u043c, \u043e\u043d \u0441\u0430\u043c \u043f\u0438\u0448\u0435\u0442 \u0442\u0443\u0434\u0430 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 \u0447\u0430\u0442\u0430, \u0438 \u0435\u0433\u043e \u043d\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u0438\u0441\u043a\u0430\u0442\u044c. \u041f\u0440\u043e \u0433\u0440\u0443\u043f\u043f\u044b \u0435\u0441\u0442\u044c \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u0430\u044f \u0434\u0435\u0442\u0430\u043b\u044c: \u0441\u043e\u0431\u044b\u0442\u0438\u044f \u0438\u0437 \u0433\u0440\u0443\u043f\u043f\u044b \u0431\u043e\u0442 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0441 \u043f\u0440\u0430\u0432\u043e\u043c \u0430\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0442\u043e\u0440\u0430 \u00ab\u0447\u0438\u0442\u0430\u0442\u044c \u0432\u0441\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f\u00bb.<\/p>\n
\u0412\u0435\u0431\u0445\u0443\u043a \u0432\u043c\u0435\u0441\u0442\u043e polling<\/h3>\n
\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435 \u0443\u0434\u043e\u0431\u0435\u043d long polling, GET \/updates<\/code> \u0441 \u043c\u0430\u0440\u043a\u0435\u0440\u043e\u043c, \u043f\u043e\u0447\u0442\u0438 \u043a\u0430\u043a getUpdates<\/code> \u0432 Telegram. \u0412 \u0431\u043e\u044e MAX \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0432\u0435\u0431\u0445\u0443\u043a. \u041f\u043e\u0434\u043f\u0438\u0441\u043a\u0430 \u0434\u0435\u043b\u0430\u0435\u0442\u0441\u044f \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u043c POST \/subscriptions<\/code>, \u0430\u0434\u0440\u0435\u0441 \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043d\u0430 HTTPS \u0438 \u043f\u043e\u0440\u0442\u0443 443, \u0441\u0435\u0440\u0442\u0438\u0444\u0438\u043a\u0430\u0442 \u043e\u0442 \u0434\u043e\u0432\u0435\u0440\u0435\u043d\u043d\u043e\u0433\u043e \u0446\u0435\u043d\u0442\u0440\u0430, \u043e\u0442\u0432\u0435\u0442 200 \u043d\u0443\u0436\u043d\u043e \u0432\u0435\u0440\u043d\u0443\u0442\u044c \u0437\u0430 30 \u0441\u0435\u043a\u0443\u043d\u0434. Caddy \u0441 Let\u2019s Encrypt \u0437\u0430\u043a\u0440\u044b\u0432\u0430\u0435\u0442 \u044d\u0442\u043e \u0431\u0435\u0437 \u0443\u0441\u0438\u043b\u0438\u0439.<\/p>\n
\u041d\u0430 \u044d\u0442\u043e\u043c \u043c\u0435\u0441\u0442\u0435 \u044f \u043f\u043e\u0442\u0435\u0440\u044f\u043b \u0447\u0430\u0441. \u041f\u043e\u043a\u0430 \u043f\u043e\u0434\u043f\u0438\u0441\u043a\u0430 \u0430\u043a\u0442\u0438\u0432\u043d\u0430, long polling \u0441 \u0442\u0435\u043c \u0436\u0435 \u0442\u043e\u043a\u0435\u043d\u043e\u043c \u043c\u043e\u043b\u0447\u0430 \u043d\u0438\u0447\u0435\u0433\u043e \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 (\u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u044d\u0442\u043e \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043e, \u043d\u043e \u043a\u0442\u043e \u0447\u0438\u0442\u0430\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0434\u043e \u043f\u0435\u0440\u0432\u043e\u0433\u043e \u0431\u0430\u0433\u0430). \u041b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0431\u043e\u0442 \u0437\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u0442\u0441\u044f, \u043e\u0448\u0438\u0431\u043e\u043a \u043d\u0435\u0442, \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u043d\u0435 \u043f\u0440\u0438\u0445\u043e\u0434\u044f\u0442. \u0422\u0435\u043f\u0435\u0440\u044c \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0432 \u0440\u0435\u0436\u0438\u043c\u0435 polling \u043f\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435 \u0441\u043c\u043e\u0442\u0440\u0438\u0442 \u0441\u043f\u0438\u0441\u043e\u043a \u043f\u043e\u0434\u043f\u0438\u0441\u043e\u043a \u0438 \u043f\u0438\u0448\u0435\u0442 \u043f\u0440\u0435\u0434\u0443\u043f\u0440\u0435\u0436\u0434\u0435\u043d\u0438\u0435 \u0432 \u043b\u043e\u0433.<\/p>\n
\u0421\u0430\u043c \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u0432\u0435\u0431\u0445\u0443\u043a\u0430 \u043a\u043e\u0440\u043e\u0442\u043a\u0438\u0439. \u041f\u0440\u043e\u0432\u0435\u0440\u043a\u0438 \u0434\u0432\u0435, \u043a\u0430\u043a \u0438 \u0443 \u0432\u0435\u0431\u0445\u0443\u043a\u0430 Telegram: \u043d\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u0441\u0435\u043a\u0440\u0435\u0442 \u0432 \u043f\u0443\u0442\u0438 \u0434\u0430\u0451\u0442 404, \u043d\u0435\u0432\u0435\u0440\u043d\u044b\u0439 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a X-Max-Bot-Api-Secret<\/code> \u0434\u0430\u0451\u0442 403. \u0414\u0430\u043b\u044c\u0448\u0435 MAX \u043d\u0443\u0436\u043d\u043e \u043e\u0442\u0432\u0435\u0442\u0438\u0442\u044c \u0441\u0440\u0430\u0437\u0443, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u0443\u0445\u043e\u0434\u0438\u0442 \u0432 \u0444\u043e\u043d\u043e\u0432\u0443\u044e \u0437\u0430\u0434\u0430\u0447\u0443.<\/p>\n
@router.post(\"\/max\/webhook\/{secret}\")async def max_webhook(secret: str, request: Request,                      x_max_bot_api_secret: str | None = Header(default=None)) -> dict:    service = getattr(request.app.state, \"max_service\", None)    if service is None or secret != settings.max_webhook_path_secret:        raise HTTPException(status_code=404, detail=\"Not found\")    if x_max_bot_api_secret != settings.max_webhook_secret:        raise HTTPException(status_code=403, detail=\"Forbidden\")    update = await request.json()    msg = update.get(\"message\") or {}    ident = ((update.get(\"callback\") or {}).get(\"callback_id\")             or (msg.get(\"body\") or {}).get(\"mid\")             or (update.get(\"user\") or {}).get(\"user_id\"))    if ident is not None:        key = f\"upd:max:{update.get('update_type')}:{ident}:{update.get('timestamp')}\"        if not await redis.set(key, 1, nx=True, ex=3600):            return {\"ok\": True}   # MAX redelivers when it gets no 200 in time    service.spawn(update)         # answer right away, handle in the background    return {\"ok\": True}<\/code>
<\/span><\/a><\/div><\/pre>\n
\u041f\u043e\u0432\u0442\u043e\u0440\u043d\u0430\u044f \u0434\u043e\u0441\u0442\u0430\u0432\u043a\u0430 \u0441\u043b\u0443\u0447\u0430\u0435\u0442\u0441\u044f \u043d\u0430 \u043f\u0440\u0430\u043a\u0442\u0438\u043a\u0435. \u0415\u0441\u043b\u0438 MAX \u043d\u0435 \u043f\u043e\u043b\u0443\u0447\u0438\u043b 200 \u0432\u043e\u0432\u0440\u0435\u043c\u044f, \u043e\u043d \u043f\u0440\u0438\u0441\u044b\u043b\u0430\u0435\u0442 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437, \u0438 \u0431\u0435\u0437 \u044d\u0442\u043e\u0433\u043e \u043a\u043b\u044e\u0447\u0430 \u0432 Redis \u043a\u043b\u0438\u0435\u043d\u0442 \u043f\u043e\u043b\u0443\u0447\u0430\u043b \u0431\u044b \u0434\u0432\u0430 \u043e\u0442\u0432\u0435\u0442\u0430 \u043d\u0430 \u043e\u0434\u043d\u043e \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435. \u0414\u043b\u044f Telegram \u0443 \u043c\u0435\u043d\u044f \u0442\u0430\u043a\u0430\u044f \u0436\u0435 \u0437\u0430\u0449\u0438\u0442\u0430 \u043f\u043e update_id<\/code>.<\/p>\n
\u0415\u0441\u043b\u0438 \u043f\u043e\u0434\u043f\u0438\u0441\u043a\u0430 \u043f\u0440\u0438 \u0441\u0442\u0430\u0440\u0442\u0435 \u043d\u0435 \u0432\u0441\u0442\u0430\u043b\u0430, \u0442\u043e \u0435\u0441\u0442\u044c POST \/subscriptions<\/code> \u0432\u0435\u0440\u043d\u0443\u043b \u043e\u0448\u0438\u0431\u043a\u0443 \u0438\u043b\u0438 \u0430\u0434\u0440\u0435\u0441\u0430 \u043d\u0435\u0442 \u0432 GET \/subscriptions<\/code>, \u043a\u0430\u043d\u0430\u043b \u0443\u0445\u043e\u0434\u0438\u0442 \u043d\u0430 polling. \u042d\u043d\u0434\u043f\u043e\u0438\u043d\u0442 \/healthz<\/code> \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442, \u0432 \u043a\u0430\u043a\u043e\u043c \u0440\u0435\u0436\u0438\u043c\u0435 \u0436\u0438\u0432\u0451\u0442 MAX: webhook<\/code>, polling<\/code> \u0438\u043b\u0438 polling-fallback<\/code>. \u0422\u0430\u043a \u0432\u0438\u0434\u043d\u043e, \u0447\u0442\u043e \u0441\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c \u0441 \u043f\u043e\u0434\u043f\u0438\u0441\u043a\u043e\u0439, \u043d\u0435 \u0447\u0438\u0442\u0430\u044f \u043b\u043e\u0433\u0438.<\/p>\n
\u041e\u0434\u0438\u043d \u0445\u043e\u0434 \u043d\u0430 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0438 \u043f\u0440\u043e\u0447\u0438\u0435 \u0433\u0440\u0430\u0431\u043b\u0438<\/h3>\n
\u0427\u0435\u043b\u043e\u0432\u0435\u043a \u0432 \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0435 \u0447\u0430\u0441\u0442\u043e \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u0442 \u0434\u0432\u0430 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f \u043f\u043e\u0434\u0440\u044f\u0434. \u0415\u0441\u043b\u0438 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c \u0438\u0445 \u043f\u0430\u0440\u0430\u043b\u043b\u0435\u043b\u044c\u043d\u043e, \u0432\u0442\u043e\u0440\u043e\u0435 \u0432\u043e\u0437\u044c\u043c\u0451\u0442 \u0438\u0441\u0442\u043e\u0440\u0438\u044e \u0431\u0435\u0437 \u043f\u0435\u0440\u0432\u043e\u0433\u043e, \u0430 \u043c\u043e\u0434\u0435\u043b\u044c \u043c\u043e\u0436\u0435\u0442 \u043e\u0444\u043e\u0440\u043c\u0438\u0442\u044c \u0437\u0430\u044f\u0432\u043a\u0443 \u0434\u0432\u0430\u0436\u0434\u044b. \u0412 aiogram \u044d\u0442\u043e \u0440\u0435\u0448\u0430\u0435\u0442\u0441\u044f \u0432 \u043e\u0434\u043d\u0443 \u0441\u0442\u0440\u043e\u043a\u0443, Dispatcher(events_isolation=SimpleEventIsolation())<\/code>. \u0414\u043b\u044f MAX \u044f \u0434\u0435\u0440\u0436\u0443 asyncio.Lock<\/code> \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f \u0432\u043d\u0443\u0442\u0440\u0438 \u0441\u0435\u0440\u0432\u0438\u0441\u0430; \u043f\u0440\u043e\u0446\u0435\u0441\u0441 uvicorn \u043e\u0434\u0438\u043d, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0437\u0430\u043c\u043a\u043e\u0432 \u0432 \u043f\u0430\u043c\u044f\u0442\u0438 \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e. \u0412\u0442\u043e\u0440\u043e\u0435 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435 \u0436\u0434\u0451\u0442, \u043f\u043e\u043a\u0430 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442\u0441\u044f \u043f\u0435\u0440\u0432\u043e\u0435.<\/p>\n
\u0415\u0449\u0451 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u0435\u043b\u043e\u0447\u0435\u0439, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0443 \u043a\u0430\u043d\u0430\u043b\u043e\u0432 \u0440\u0430\u0437\u043d\u044b\u0435.<\/p>\n