Telegram-бот: webhook или long polling, secret_token и деплой на serverless
Yangilanishlarni olishning ikkita usuli
Bot API kiruvchi xabarlarni ikkita o'zaro eksklyuziv usulda yetkazib beradi:
- Uzoq so'rov - botning o'zi
getUpdatesparametri bilantimeoutchaqiradi, Telegram yangilanishlar paydo bo'lguncha so'rovni ochiq saqlaydi. Doimiy ishlaydigan jarayon kerak, kiruvchi portlar kerak emas. - Webhook - Telegram har bir yangilanishni POST so'rovi bilan HTTPS manzilingizga yuboradi. Jarayon har doim ham ishlamasligi mumkin, shuning uchun variant serversiz.
Ular bir vaqtning o'zida ishlamaydi: webhook o'rnatilganda, getUpdates 409 Conflict xatosini qaytaradi. Bu mahalliy nusxa serverda so'rov rejimida ishga tushirilganda "bot javob berishni to'xtatgan" keng tarqalgan sababdir.
| | Uzoq ovoz berish | Webhuk | |---|---|---| | Qayerga yugurish | VPS, konteyner, mahalliy | serversiz, har qanday HTTPS serveri | | Umumiy manzil | kerak emas | 443, 80, 88 yoki 8443 portidagi HTTPS | | Rivojlanish | oddiy, NAT | tufayli ishlaydi mahalliy disk raskadrovka uchun tunnel kerak | | Oddiy jarayon | yangilanishlar navbatda kutilmoqda | Telegram yetkazib berishni takrorlaydi |
Bir VPS-da ishlab chiqish va bot uchun uzoq so'rovlar osonroq. Vercel, Cloudflare Workers yoki funksiyada joylashtirish uchun - faqat webhook.
maxfiy_tokenli vebhuk
Webhook URL manzilini sir deb hisoblash mumkin emas. Tekshiruvsiz, uni tanigan har qanday foydalanuvchi nomidan soxta yangilanish yuboradi. Vebhukni oʻrnatishda secret_token parametri buni hal qiladi: Telegram uni har bir soʻrovning X-Telegram-Bot-Api-Secret-Token sarlavhasida uzatadi.
SECRET=$(openssl rand -hex 32) # допустимы A-Z, a-z, 0-9, _ и -, до 256 символов
curl -s "https://api.telegram.org/bot${BOT_TOKEN}/setWebhook" \
-d "url=https://example.com/api/telegram" \
-d "secret_token=${SECRET}" \
-d 'allowed_updates=["message","callback_query"]' \
-d "drop_pending_updates=true"allowed_updates vebhukga keladigan hodisalar turlarini cheklaydi - kamroq keraksiz funksiya chaqiruvlari. drop_pending_updates to'plangan navbatni tashlab yuboradi, shunda bot o'rnatilgandan keyin yuzlab eski xabarlarga javob bermaydi.
Next.js da ishlov beruvchi
// app/api/telegram/route.ts
import { timingSafeEqual } from "node:crypto";
import { db } from "@/lib/db";
const TOKEN = process.env.TELEGRAM_BOT_TOKEN!;
const SECRET = process.env.TELEGRAM_WEBHOOK_SECRET!;
function validSecret(header: string | null) {
if (!header) return false;
const a = Buffer.from(header), b = Buffer.from(SECRET);
return a.length === b.length && timingSafeEqual(a, b);
}
async function tg(method: string, body: unknown) {
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/${method}`, {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify(body),
});
if (!res.ok) console.error("telegram", method, res.status, await res.text());
}
export async function POST(req: Request) {
if (!validSecret(req.headers.get("x-telegram-bot-api-secret-token"))) {
return new Response("forbidden", { status: 403 });
}
const update = await req.json();
const first = await db.query(
"INSERT INTO tg_updates (update_id) VALUES ($1) ON CONFLICT DO NOTHING",
[update.update_id]
);
if (first.rowCount === 0) return new Response("ok");
const msg = update.message;
if (msg?.text === "/start") {
await tg("sendMessage", { chat_id: msg.chat.id, text: "Привет! Пришлите номер заказа." });
} else if (msg?.text) {
await tg("sendMessage", { chat_id: msg.chat.id, text: await lookupOrder(msg.text) });
}
return new Response("ok");
}Nega shunday:
- Avval sir tekshiriladi va
timingSafeEqualorqali. - `update_id` boʻyicha nusxa koʻchirish. Agar javob oʻz vaqtida kelmasa yoki 2xx qaytarilmasa, Telegram yetkazib berishni takrorlaydi. Deuplikatsiyasiz foydalanuvchi ikkita javob yoki yaratilgan ikkita buyurtmani oladi.
- Har doim qayta ishlashdan keyin 200, hatto xabar tan olinmasa ham. Noto'g'ri holat qayta urinishlarga olib keladi va yangilash navbati tiqilib qoladi.
- URL manzilidagi bot tokeni. Bot API-ga so‘rovlarning to‘liq URL manzillarini kiritmang: token jurnallarda tugaydi. Misolda faqat usul va holat qayd etilgan.
Shuningdek, siz method maydoni (masalan, {"method":"sendMessage","chat_id":...,"text":"..."}) bilan JSONni qaytargan holda webhook javobining asosiy qismida ham javob berishingiz mumkin. Bu bitta chiquvchi soʻrovni saqlaydi, lekin siz xabar yetkazilganligini bilmay qolasiz.
Serversiz xususiyatlar
- Bajarish vaqti. Agar ishlov berish uzoq davom etsa (LLM chaqiruvi, fayl yaratish), funksiya platforma chegarasiga mos kelmasligi mumkin va Telegram yetkazib berishni muvaffaqiyatsiz deb hisoblaydi. 200 bilan tezda javob bering va ishni navbatga yoki fon vazifasiga o'tkazing va natijani
sendMessageorqali yuboring. - Paralellik.
setWebhookdagimax_connectionsparametri (1 dan 100 gacha, standart 40) Telegram bir vaqtning o‘zida qancha so‘rov yuborishini belgilaydi. Parallel ishlov berish jarayonida bitta foydalanuvchidan kelgan xabarlarning tartibi kafolatlanmaydi. Agar bot bosqichma-bosqich dialog o'tkazayotgan bo'lsa, holatni ma'lumotlar bazasida saqlang va poygalarni hisobga oling. - Sovuq ishga tushirish. Bo'sh vaqtdan keyingi birinchi xabar sekinroq qayta ishlanadi. Botlar uchun bu odatda qabul qilinadi.
Diagnostika
curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getWebhookInfo"Javobda pending_update_count (qancha yangilanishlar yetkazilishi kutilmoqda), last_error_date va last_error_message mavjud. Oddiy xatolar:
Wrong response from the webhook: 403 Forbidden- muhit o'zgaruvchilaridagi sirsetWebhookga uzatilganiga mos kelmaydi.SSL erroryokiConnection refused- mavjud bo'lmagan manzil yoki Telegram ishonmaydigan sertifikat.pending_update_countni oshirish - ishlov beruvchi xato bilan javob beradi yoki vaqt tugamaydi.
Uzoq ovoz berishda qachon qolish kerak
Agar bot o'z serverida yashasa, yuk engil va siz HTTPS so'nggi nuqtasini nashr qilishni xohlamasangiz, uzoq so'rov ishonchli va oddiy. GramY va Telegraf kabi kutubxonalar ikkala rejimni ham qo'llab-quvvatlaydi va keyin o'tish bir necha qatorni oladi.