5.14-bob: Telegram bot — node-telegram-bot-api va Telegraf

  Foydalanuvchi ──xabar──▶ Telegram serveri ──update──▶ Sizning botingiz (Node.js)
  Foydalanuvchi ◀──javob── Telegram serveri ◀──API──── Sizning botingiz

  Siz Telegram serveriga gapirasiz (Bot API), u foydalanuvchiga yetkazadi.
  Foydalanuvchini to'g'ridan ko'rmaysiz — Telegram orqali.

  1. Telegram'da @BotFather'ni oching
  2. /newbot buyrug'ini yuboring
  3. Botga nom va username bering (username "bot" bilan tugashi shart: mydo'kon_bot)
  4. BotFather TOKEN beradi: 123456789:AbCdefGhIJKlmNoPQRsTUVwxyZ

  1. LONG POLLING — bot Telegram'dan "yangi xabar bormi?" deb DOIM so'raydi
     Foydalanuvchi  Telegram serveri  bot so'raydi (getUpdates)
      Sodda: domen/SSL/public URL kerak emas; lokal dev'da ishlaydi
      Bot doim so'rab turadi; bitta instansiya

  2. WEBHOOK — Telegram update'ni SIZNING URL'ingizga o'zi yuboradi (push)
     Foydalanuvchi  Telegram serveri  POST https://senit.uz/webhook
      Tez, samarali, masshtablanadi (production)
      Public HTTPS URL + SSL kerak (domen/deploy — 10)

  node-telegram-bot-api  — eski, mashhur, oddiy; event-based (bot.on)
                           past darajali, ko'p narsa qo'lda
  Telegraf               — zamonaviy, framework; middleware (Express kabi — 5.6)
                           Context, Scenes, Sessions tayyor; TypeScript-first

bot.on("text", (ctx) => {
  ctx.message.text       // kelgan xabar matni
  ctx.from               // kim yubordi (id, ism, username)
  ctx.chat               // qaysi chat (id)
  ctx.reply("Salom");    // javob yuborish (eng muhim metod)
});

// Har update'da ishlaydi (logging, auth — 5.6 ruhida)
bot.use(async (ctx, next) => {
  console.log(`${ctx.from.id} dan update`);   // log (5.12)
  await next();                                // keyingi handler'ga (5.6)
});

bot.start((ctx) => ctx.reply("Xush kelibsiz!"));   // /start (maxsus — birinchi ochilganda)
bot.help((ctx) => ctx.reply("Yordam: ..."));        // /help
bot.command("buyurtma", (ctx) => ctx.reply("Buyurtma..."));   // /buyurtma (ixtiyoriy nom)

bot.hears("salom", (ctx) => ctx.reply("Va alaykum salom"));   // aniq matn
bot.hears(/narx/i, (ctx) => ctx.reply("Narxlar..."));         // RegEx (2.13-JS)
bot.on("text", (ctx) => ctx.reply(`Siz: ${ctx.message.text}`));   // har qanday matn
bot.on("photo", (ctx) => ctx.reply("Rasm qabul qilindi"));    // rasm
bot.on("contact", (ctx) => ctx.reply("Raqam olindi"));        // telefon (klaviatura — 2.10)

ctx.reply("matn");                          // oddiy matn
ctx.reply("*qalin*", { parse_mode: "Markdown" });   // formatlash (2.15)
ctx.replyWithPhoto({ url: "..." });         // rasm
ctx.replyWithDocument({ source: "fayl.pdf" });   // hujjat
ctx.replyWithLocation(41.3, 69.2);          // joylashuv (xarita)
ctx.editMessageText("yangi matn");          // xabarni tahrirlash (inline tugma bilan — 2.11)
ctx.answerCbQuery("Bajarildi!");            // callback javobi (2.11)

import { Markup } from "telegraf";

ctx.reply("Tanlang:", Markup.keyboard([
  [" Buyurtma", " Aloqa"],              // birinchi qator (ikki tugma)
  [" Ma'lumot"],                           // ikkinchi qator
]).resize());                                // ekranga moslab kichraytirish

// Maxsus tugmalar:
Markup.keyboard([
  [Markup.button.contactRequest(" Raqamni yuborish")],   // telefon so'rash (2.8)
  [Markup.button.locationRequest(" Joylashuv")],          // joylashuv so'rash
]).resize();

import { Markup } from "telegraf";

ctx.reply("Mahsulotni tanlang:", Markup.inlineKeyboard([
  [Markup.button.callback(" Sotib olish", "sotib_1")],   // callback_data: "sotib_1"
  [Markup.button.callback(" Saralash", "saralash_1")],
  [Markup.button.url(" Sayt", "https://senit.uz")],       // havola (callback emas)
]));

// Callback'ni ushlash (tugma bosilganda)
bot.action("sotib_1", async (ctx) => {
  await ctx.answerCbQuery("Savatga qo'shildi!");   //  MAJBURIY (yuqoridagi "soat" yo'qoladi)
  await ctx.editMessageText(" Savatga qo'shildi");   // xabarni yangilash (2.9)
});

// Dinamik callback (RegEx bilan — ID o'zgaruvchan)
bot.action(/sotib_(\d+)/, async (ctx) => {
  const id = ctx.match[1];                          // tugmadagi ID (2.13-JS)
  await ctx.answerCbQuery();
  await ctx.reply(`${id}-mahsulot tanlandi`);
});

import { session } from "telegraf";
bot.use(session());                          // sessiya middleware (2.6)

bot.on("text", (ctx) => {
  ctx.session ??= {};                        // boshlang'ich (2.1-JS)
  ctx.session.count = (ctx.session.count || 0) + 1;   // har foydalanuvchi uchun alohida
  ctx.reply(`Siz ${ctx.session.count} marta yozdingiz`);
});

  BaseScene    — kirish/chiqish + o'z handlerlari (erkin boshqaruv)
  WizardScene  — qadamlar ketma-ketligi (1-qadam  2-qadam  ...) — sehrgar

// Telegraf webhook'ni Express route sifatida (5.6)
app.use(bot.webhookCallback("/telegram-webhook"));   // bu yo'lga Telegram POST qiladi
await bot.telegram.setWebhook("https://senit.uz/telegram-webhook");   // Telegram'ga URL bering

ctx.reply("*Qalin* _kursiv_ `kod`", { parse_mode: "Markdown" });
ctx.reply("<b>Qalin</b> <i>kursiv</i> <a href='url'>havola</a>", { parse_mode: "HTML" });
ctx.replyWithMarkdownV2("Narx: *50 000* so'm");

bot.catch((err, ctx) => {                    // global xato handler (5.10 ruhida)
  console.error(`Xato (${ctx.updateType}):`, err);   // log (5.12)
  ctx.reply("Kechirasiz, xatolik yuz berdi. Qayta urinib ko'ring.");
});

  Foydalanuvchi ro'yxati   DB (6): users (telegramId, ism, telefon)
  Buyurtmalar              DB: orders; admin'ga bildirishnoma 2.11-bob
  SMS tasdiqlash           OTP (5.16, 5.18: Eskiz)
  To'lov                   Payme/Click integratsiyasi
  Admin panel              web (React — 11) + bot bir DB'ni ishlatadi

   Token .env'da (14, 5.8); git'ga qo'ymang 4.5-bob; sizsa /revoke
   Kelgan ma'lumotni validatsiya (telefon, matn — 5.9, 14)
   Admin amallarini himoyalang (faqat admin ID — middleware, 2.6)
   Rate limiting (spam — 5.20); foydalanuvchi floodga qarshi
   Sessiyani Redis'da (production — 2.12, 2.14)
   Webhook URL maxfiy/tasodifiy yo'l (14); secret_token tekshiring
   answerCbQuery doim chaqiring 2.11-bob
   Xatoni bot.catch bilan ushlang (2.16)

import { Telegraf, Markup, session, Scenes } from "telegraf";
const bot = new Telegraf(process.env.BOT_TOKEN);   // (5.8)

bot.use(session());                          // sessiya (2.12)
bot.start((ctx) => ctx.reply("..."));        // /start (2.7)
bot.command("nom", (ctx) => {...});          // /nom
bot.hears("matn", (ctx) => {...});           // matn (2.8)
bot.on("text", (ctx) => {...});              // har matn (oxirda!)
bot.action("data", (ctx) => {...});          // inline callback (2.11)
ctx.reply("matn", Markup.inlineKeyboard([...]));   // tugma (2.11)
ctx.answerCbQuery();                          // callback javobi (MAJBURIY — 2.11)
bot.catch((err, ctx) => {...});              // xato (2.16)

bot.launch();                                 // polling (dev — 2.3)
// yoki: app.use(bot.webhookCallback("/path")) (webhook — 2.14)
process.once("SIGINT", () => bot.stop());    // graceful (5.10)

// Eski, oddiy kutubxona (eski loyihalarda uchraydi — 2.4)
import TelegramBot from "node-telegram-bot-api";
const bot = new TelegramBot(process.env.BOT_TOKEN, { polling: true });   // (2.3, 5.8)

bot.onText(/\/start/, (msg) => {                       // /start (RegEx)
  bot.sendMessage(msg.chat.id, "Salom! Men botman.");  // chat.id ga javob
});
bot.on("message", (msg) => {
  if (msg.text === "salom") bot.sendMessage(msg.chat.id, "Va alaykum");
});
// Past darajali: chat.id'ni qo'lda boshqarasiz, middleware/scene yo'q

import { Telegraf } from "telegraf";
const bot = new Telegraf(process.env.BOT_TOKEN);       // (5.8)

bot.start((ctx) => ctx.reply(`Salom, ${ctx.from.first_name}!`));   // /start (2.7)
bot.help((ctx) => ctx.reply("Yordam: /start, /menyu"));            // /help
bot.on("text", (ctx) => ctx.reply(`Siz yozdingiz: ${ctx.message.text}`));   // (2.8)

bot.launch();                                          // polling (dev — 2.3)
console.log("Bot ishga tushdi");

// Graceful shutdown (5.10)
process.once("SIGINT", () => bot.stop("SIGINT"));
process.once("SIGTERM", () => bot.stop("SIGTERM"));

bot.start((ctx) => ctx.reply("Xush kelibsiz! /menyu ni bosing"));   // (2.7)
bot.command("menyu", (ctx) => ctx.reply(" Menyu: Taomlar, Ichimliklar"));
bot.command("aloqa", (ctx) => ctx.reply(" +998 90 123 45 67"));

bot.hears("salom", (ctx) => ctx.reply("Va alaykum salom! "));     // aniq (2.8)
bot.hears(/narx|qancha/i, (ctx) => ctx.reply("Narxlar /menyu da")); // RegEx (2.8)

//  Bu OXIRDA — hamma matnni ushlaydi (2.8)
bot.on("text", (ctx) => ctx.reply("Tushunmadim. /menyu ni bosing"));

import { Markup } from "telegraf";

bot.start((ctx) =>
  ctx.reply("Asosiy menyu:", Markup.keyboard([
    [" Buyurtma berish", " Savatim"],
    [" Aloqa", " Biz haqimizda"],
    [Markup.button.contactRequest(" Raqamni ulashish")],   // telefon (2.10)
  ]).resize())                                              // ekranga moslash
);

// Klaviatura tugmalarini hears bilan ushlash (2.8)
bot.hears(" Buyurtma berish", (ctx) => ctx.reply("Mahsulotni tanlang..."));
bot.hears(" Aloqa", (ctx) => ctx.reply("+998 90 123 45 67"));
bot.on("contact", (ctx) =>                                   // telefon kelganda (2.8)
  ctx.reply(`Rahmat! Raqamingiz: ${ctx.message.contact.phone_number}`)
);

import { Markup } from "telegraf";

const mahsulotlar = [
  { id: 1, nom: "Olma", narx: 12000 },
  { id: 2, nom: "Banan", narx: 18000 },
];

bot.command("mahsulotlar", (ctx) => {
  // Har mahsulot uchun inline tugma (2.11)
  const tugmalar = mahsulotlar.map((m) =>
    [Markup.button.callback(`${m.nom} — ${m.narx} so'm`, `sotib_${m.id}`)]
  );
  ctx.reply("Mahsulotlar:", Markup.inlineKeyboard(tugmalar));
});

// Callback'ni dinamik ushlash (ID bilan — 2.11)
bot.action(/sotib_(\d+)/, async (ctx) => {
  const id = Number(ctx.match[1]);                          // RegEx guruh (2.13-JS)
  const m = mahsulotlar.find((x) => x.id === id);
  await ctx.answerCbQuery(`${m.nom} savatga qo'shildi!`);   // MAJBURIY (2.11)
  await ctx.editMessageText(` ${m.nom} (${m.narx} so'm) savatga qo'shildi`);   // (2.9)
});

import { Telegraf, session } from "telegraf";
const bot = new Telegraf(process.env.BOT_TOKEN);

bot.use(session({ defaultSession: () => ({ savat: [] }) }));   // sessiya (2.12)

bot.action(/qosh_(\d+)/, async (ctx) => {
  const id = Number(ctx.match[1]);
  ctx.session.savat.push(id);                                // foydalanuvchi savatiga
  await ctx.answerCbQuery("Qo'shildi");
  await ctx.reply(`Savatda ${ctx.session.savat.length} ta mahsulot`);
});

bot.command("savat", (ctx) => {
  const soni = ctx.session?.savat?.length || 0;
  ctx.reply(soni ? `Savatda ${soni} ta` : "Savat bo'sh");
});
//  Production: sessiyani Redis'da (2.12, 2.14, 5.21)

import { Telegraf, Scenes, session, Markup } from "telegraf";
const bot = new Telegraf(process.env.BOT_TOKEN);

// Ko'p qadamli ro'yxatdan o'tish (ism  telefon  tasdiq — 2.13)
const royxat = new Scenes.WizardScene(
  "royxat",                                          // scene nomi
  // 1-qadam: ism so'rash
  (ctx) => {
    ctx.reply("Ismingizni kiriting:");
    return ctx.wizard.next();                        // keyingi qadamga (2.13)
  },
  // 2-qadam: ismni saqlab, telefon so'rash
  (ctx) => {
    ctx.wizard.state.ism = ctx.message.text;         // wizard holati
    ctx.reply("Telefon raqamingizni yuboring:",
      Markup.keyboard([[Markup.button.contactRequest(" Yuborish")]]).resize());
    return ctx.wizard.next();
  },
  // 3-qadam: telefonni saqlab, tugatish
  async (ctx) => {
    const telefon = ctx.message.contact?.phone_number || ctx.message.text;
    const { ism } = ctx.wizard.state;
    await User.create({ telegramId: ctx.from.id, ism, telefon });   // DB (6, 2.17)
    await ctx.reply(` Ro'yxatdan o'tdingiz!\nIsm: ${ism}\nTel: ${telefon}`,
      Markup.removeKeyboard());
    return ctx.scene.leave();                        // scene'dan chiqish
  }
);

const stage = new Scenes.Stage([royxat]);            // scene'larni ro'yxatga oling
bot.use(session());                                  // scene sessiya talab qiladi (2.13)
bot.use(stage.middleware());

bot.command("royxat", (ctx) => ctx.scene.enter("royxat"));   // scene'ga kirish

import { Scenes } from "telegraf";

const aloqaScene = new Scenes.BaseScene("aloqa");

aloqaScene.enter((ctx) => ctx.reply("Xabaringizni yozing (chiqish: /bekor):"));
aloqaScene.command("bekor", (ctx) => {               // scene ichida buyruq
  ctx.reply("Bekor qilindi");
  return ctx.scene.leave();
});
aloqaScene.on("text", async (ctx) => {               // matn kelganda
  await Feedback.create({ userId: ctx.from.id, matn: ctx.message.text });   // DB (6)
  await ctx.reply(" Xabaringiz yuborildi. Rahmat!");
  return ctx.scene.leave();                          // chiqish
});
// Stage'ga qo'shish: new Scenes.Stage([royxat, aloqaScene])

// Logging middleware (har update — 2.6, 5.12)
bot.use(async (ctx, next) => {
  const boshlandi = Date.now();
  await next();                                      // keyingi handler (5.6)
  console.log(`${ctx.updateType} (${ctx.from?.id}) — ${Date.now() - boshlandi}ms`);
});

// Admin middleware (faqat admin — 2.18, 14)
const ADMINLAR = [123456789];                         // admin Telegram ID'lari (.env — 5.8)
const adminOnly = async (ctx, next) => {
  if (!ADMINLAR.includes(ctx.from.id)) {
    return ctx.reply(" Ruxsat yo'q");               // rad (14)
  }
  await next();
};

bot.command("statistika", adminOnly, async (ctx) => {   // faqat admin (5.6: zanjir)
  const soni = await User.count();                   // DB (6)
  ctx.reply(`Jami foydalanuvchi: ${soni}`);
});

bot.catch((err, ctx) => {                            // global (2.16, 5.10)
  console.error(`Xato [${ctx.updateType}]:`, err);   // log (5.12)
  ctx.reply(" Xatolik yuz berdi. Birozdan keyin urinib ko'ring.")
    .catch(() => {});                                 // javob ham xato bersa, e'tiborsiz
});

// Handler ichida ham try/catch (muhim amallar — 5.10)
bot.command("buyurtma", async (ctx) => {
  try {
    const buyurtma = await Order.create({ userId: ctx.from.id });   // DB (6)
    await ctx.reply(` Buyurtma #${buyurtma.id} qabul qilindi`);
  } catch (err) {
    await ctx.reply(" Buyurtma berishda xato");
    throw err;                                        // bot.catch'ga (2.16)
  }
});

import express from "express";
import { Telegraf } from "telegraf";
import { config } from "./config/index.js";          // (5.8)

const bot = new Telegraf(config.botToken);
const app = express();

bot.start((ctx) => ctx.reply("Salom!"));

// Webhook'ni Express route sifatida (5.6, 2.14)
const WEBHOOK_PATH = `/tg/${config.webhookSecret}`;   // tasodifiy yo'l (14)
app.use(bot.webhookCallback(WEBHOOK_PATH));

app.listen(config.port, async () => {
  // Telegram'ga URL'ni ayt (2.14)
  await bot.telegram.setWebhook(`${config.publicUrl}${WEBHOOK_PATH}`);
  console.log("Bot webhook rejimida");
});
//  Sessiya Redis'da bo'lsin (ko'p instansiya — 2.14, 5.21)

import { Telegraf, Markup, Scenes, session } from "telegraf";

const buyurtmaScene = new Scenes.WizardScene(
  "buyurtma",
  (ctx) => { ctx.reply("Mahsulot nomi?"); return ctx.wizard.next(); },
  (ctx) => {
    ctx.wizard.state.mahsulot = ctx.message.text;
    ctx.reply("Manzilingiz?");
    return ctx.wizard.next();
  },
  async (ctx) => {
    const { mahsulot } = ctx.wizard.state;
    const manzil = ctx.message.text;
    // 1. DB'ga saqlash (6, 2.17)
    const buyurtma = await Order.create({
      userId: ctx.from.id, mahsulot, manzil, holat: "yangi",
    });
    // 2. Mijozga tasdiq
    await ctx.reply(` Buyurtma #${buyurtma.id} qabul qilindi!`);
    // 3. Admin'ga real-time bildirishnoma (2.11)
    await ctx.telegram.sendMessage(config.adminChatId,
      ` Yangi buyurtma #${buyurtma.id}\nMahsulot: ${mahsulot}\nManzil: ${manzil}`,
      Markup.inlineKeyboard([
        [Markup.button.callback(" Tasdiqlash", `tasdiq_${buyurtma.id}`)],
      ]));
    // 4. SMS yuborish (5.18: Eskiz) — mijozga
    // await smsService.send(user.telefon, `Buyurtma #${buyurtma.id} qabul qilindi`);
    return ctx.scene.leave();
  }
);
// Admin tasdiqlasa (2.11)
bot.action(/tasdiq_(\d+)/, async (ctx) => {
  await Order.update(ctx.match[1], { holat: "tasdiqlandi" });   // DB (6)
  await ctx.answerCbQuery("Tasdiqlandi");
  await ctx.editMessageText(ctx.update.callback_query.message.text + "\n\n TASDIQLANDI");
});

//  token kodda  git'ga ketadi (14, 2.2, 4.5)
const bot = new Telegraf("123456:AbCdef...");

//  .env'da (5.8)
const bot = new Telegraf(process.env.BOT_TOKEN);

//  tugma "osilib" qoladi (2.11)
bot.action("x", (ctx) => ctx.reply("..."));

//  answerCbQuery
bot.action("x", async (ctx) => { await ctx.answerCbQuery(); await ctx.reply("..."); });

//  hamma matnni ushlaydi, hears/command ishlamaydi (2.8)
bot.on("text", ...); bot.hears("salom", ...);

//  on("text") OXIRDA
bot.hears("salom", ...); bot.command("x", ...); bot.on("text", ...);

 default (xotira) sessiya + webhook/ko'p instansiya  holat yo'qoladi (2.12, 2.14)
 Redis sessiya (5.21)

//  telefon formatini tekshirmasdan DB'ga (14, 5.9)
await User.create({ telefon: ctx.message.text });

//  validatsiya (5.9)
if (!/^\+998\d{9}$/.test(telefon)) return ctx.reply("Noto'g'ri raqam");

//  bir xato butun botni to'xtatadi (2.16)
bot.command("x", async (ctx) => { await risky(); });

//  bot.catch + try/catch (Misol 10)