Telegram Bot API

دستورات ربات تلگرام: setMyCommands، اسکوپ دستورات و دیپ‌لینک /start

· 8 دقیقه مطالعه

دستورات ربات تلگرام کلیدواژه‌هایی با / مثل /start یا /help هستند که اپ‌های تلگرام آن‌ها را در پیام‌ها هایلایت می‌کنند، وقتی کاربر / تایپ می‌کند پیشنهاد می‌دهند و در منوی ربات نمایش می‌دهند. لیست دستورات را با /setcommands در @BotFather یا با متد setMyCommands تنظیم می‌کنید؛ این متد از اسکوپ (دستورات متفاوت برای گروه‌ها، ادمین‌ها یا یک چت خاص) و لیست جداگانه برای هر زبان هم پشتیبانی می‌کند. ربات دستور را مثل یک پیام متنی معمولی دریافت می‌کند و /start می‌تواند پارامتر دیپ‌لینک داشته باشد. در این راهنما همه‌ی این موارد را با مثال curl، پایتون و جاوااسکریپت می‌بینید.

دستورات ربات تلگرام چطور کار می‌کنند

دستور فقط پیامی است که متن آن با / شروع می‌شود. ثبت دستورات چیزی را در آنچه ربات دریافت می‌کند تغییر نمی‌دهد؛ فقط به اپ‌های تلگرام می‌گوید چه چیزی را پیشنهاد دهند. قوانین لیستی که با setMyCommands ثبت می‌کنید (شیء BotCommand):

تلگرام از هر ربات می‌خواهد دستورات عمومی /start (شروع تعامل که پارامترهای دیپ‌لینک را هم دریافت می‌کند) و /help (اینکه ربات چه کاری می‌کند و لیست دستورات) و اگر ربات تنظیمات دارد /settings را پشتیبانی کند. دستورات مشخص مثل /newlocation را به یک /new کلی که آرگومان اضافه لازم دارد ترجیح دهید.

تنظیم دستورات با @BotFather

روش بدون کد، مناسب برای یک لیست ثابت:

  1. @BotFather را باز کنید و /setcommands را بفرستید.
  2. ربات خود را انتخاب کنید.
  3. لیست را بفرستید، هر دستور در یک خط با فرمت command - description:
start - شروع ربات
help - راهنمای استفاده از ربات
settings - تنظیمات شما

اگر هنوز ربات ندارید، از آموزش ساخت ربات تلگرام شروع کنید.

تنظیم دستورات با setMyCommands

setMyCommands همین کار را از داخل کد انجام می‌دهد، پس لیست دستورات می‌تواند در مخزن کد شما باشد و هنگام دیپلوی به‌روز شود. پارامترها: commands (الزامی، آرایه‌ای از BotCommand)، scope (اختیاری، پیش‌فرض اسکوپ default) و language_code (اختیاری، کد دوحرفی ISO 639-1). خروجی آن true است:

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setMyCommands" \
  -H "Content-Type: application/json" \
  -d '{"commands":[{"command":"start","description":"شروع ربات"},{"command":"help","description":"راهنمای استفاده از ربات"}]}'

برای امتحان بدون کد، setMyCommands را در Bot API Tester باز کنید، توکن را وارد کنید، دستورات را پر کنید و Execute را بزنید. بعد getMyCommands را صدا بزنید تا لیست ذخیره‌شده را ببینید.

اسکوپ دستورات و زبان‌ها

اسکوپ تعیین می‌کند چه کسی یک لیست را ببیند. 7 نوع BotCommandScope وجود دارد:

type اسکوپچه کسی لیست را می‌بیندفیلدهای اضافه
defaultهمه، اگر لیست محدودتری اعمال نشود—
all_private_chatsهمه‌ی چت‌های خصوصی با ربات—
all_group_chatsهمه‌ی گروه‌ها و سوپرگروه‌ها—
all_chat_administratorsادمین‌های همه‌ی گروه‌ها و سوپرگروه‌ها—
chatیک چت مشخصchat_id
chat_administratorsادمین‌های یک گروه یا سوپرگروهchat_id
chat_memberیک عضو از یک گروه یا سوپرگروهchat_id، user_id

chat_id یک شناسه‌ی عددی یا @username سوپرگروه است؛ کانال‌ها و چت‌های پیام مستقیم کانال پشتیبانی نمی‌شوند. هر اسکوپ می‌تواند برای هر زبان لیست جداگانه داشته باشد: با language_code لیست به کاربرانی می‌رسد که زبان اپ آن‌ها همان است و بدون آن به همه‌ی کسانی در آن اسکوپ که لیست مخصوص زبانشان ندارند.

تلگرام اولین لیست تنظیم‌شده را نشان می‌دهد و از محدودترین اسکوپ به سمت کلی‌ترین بررسی می‌کند. در چت خصوصی ترتیب chat ← all_private_chats ← default است؛ در گروه‌ها chat_member ← chat_administrators ← chat ← all_chat_administrators ← all_group_chats ← default (اسکوپ‌های ادمین فقط برای ادمین‌ها اعمال می‌شوند). در هر مرحله لیستی که language_code کاربر را دارد بر لیست بدون زبان مقدم است.

این اسکریپت یک لیست پیش‌فرض، یک ترجمه‌ی فارسی و دستورات اضافه برای ادمین‌های گروه تنظیم می‌کند و بعد یکی را می‌خواند:

import os
import requests

TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"


def call(method, **params):
    data = requests.post(f"{API}/{method}", json=params, timeout=10).json()
    if not data["ok"]:
        raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
    return data["result"]


# لیست پیش‌فرض برای همه
call("setMyCommands", commands=[
    {"command": "start", "description": "Start the bot"},
    {"command": "help", "description": "How to use the bot"},
    {"command": "settings", "description": "Your settings"},
])

# همان دستورات برای کاربرانی که زبان اپ تلگرامشان فارسی است
call("setMyCommands", language_code="fa", commands=[
    {"command": "start", "description": "شروع ربات"},
    {"command": "help", "description": "راهنمای استفاده از ربات"},
    {"command": "settings", "description": "تنظیمات شما"},
])

# دستورات اضافه برای ادمین‌های همه‌ی گروه‌ها
call("setMyCommands", scope={"type": "all_chat_administrators"}, commands=[
    {"command": "help", "description": "How to use the bot"},
    {"command": "stats", "description": "Group statistics"},
])

print(call("getMyCommands", scope={"type": "all_chat_administrators"}))
const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;

async function call(method, params = {}) {
  const res = await fetch(`${API}/${method}`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(params),
  });
  const data = await res.json();
  if (!data.ok) throw new Error(`${method}: ${data.error_code} ${data.description}`);
  return data.result;
}

// لیست پیش‌فرض برای همه
await call("setMyCommands", {
  commands: [
    { command: "start", description: "Start the bot" },
    { command: "help", description: "How to use the bot" },
    { command: "settings", description: "Your settings" },
  ],
});

// همان دستورات برای کاربرانی که زبان اپ تلگرامشان فارسی است
await call("setMyCommands", {
  language_code: "fa",
  commands: [
    { command: "start", description: "شروع ربات" },
    { command: "help", description: "راهنمای استفاده از ربات" },
    { command: "settings", description: "تنظیمات شما" },
  ],
});

// دستورات اضافه برای ادمین‌های همه‌ی گروه‌ها
await call("setMyCommands", {
  scope: { type: "all_chat_administrators" },
  commands: [
    { command: "help", description: "How to use the bot" },
    { command: "stats", description: "Group statistics" },
  ],
});

console.log(await call("getMyCommands", { scope: { type: "all_chat_administrators" } }));

اسکوپ‌ها فقط کنترل می‌کنند کاربر چه چیزی را ببیند. آپدیت‌ها نمی‌گویند دستور از کدام اسکوپ آمده و کاربر می‌تواند هر دستوری را تایپ کند، حتی دستوری که هرگز ثبت نکرده‌اید. همیشه در سرور بررسی کنید که دستور وجود دارد و کاربر اجازه‌ی اجرای آن را دارد (مثلاً دسترسی ادمین را با getChatMember چک کنید).

getMyCommands و deleteMyCommands

getMyCommands آرایه‌ی BotCommand را برای scope و language_code داده‌شده برمی‌گرداند، یا اگر چیزی تنظیم نشده آرایه‌ی خالی. deleteMyCommands لیست آن اسکوپ و زبان را حذف می‌کند؛ پس از آن کاربران مربوطه لیست بعدی را به ترتیب جستجو می‌بینند:

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/deleteMyCommands" \
  -H "Content-Type: application/json" \
  -d '{"scope":{"type":"all_chat_administrators"}}'

پردازش دستورات و پارامتر /start

دستورات به صورت آپدیت‌های معمولی message با همان متنی که تایپ شده می‌رسند. در گروه‌ها ممکن است دستور به شکل /command@your_bot خطاب به یک ربات خاص باشد، پس بخش @username را جدا کنید و دستوراتی را که برای ربات‌های دیگر است نادیده بگیرید. دیپ‌لینک این‌طور کار می‌کند:

یک ربات long polling که دستورات را تجزیه می‌کند، /start را با پارامتر و بدون آن پردازش می‌کند و یک دیپ‌لینک base64url می‌سازد:

import base64
import os
import re
import requests

TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"
BOT_USERNAME = requests.get(f"{API}/getMe", timeout=10).json()["result"]["username"]
COMMAND_RE = re.compile(r"^/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(?:\s+(.*))?$", re.S)


def make_start_link(payload: str) -> str:
    # base64url بدون padding "=": فقط A-Z a-z 0-9 _ - باقی می‌ماند (حداکثر 64 کاراکتر)
    code = base64.urlsafe_b64encode(payload.encode()).decode().rstrip("=")
    return f"https://t.me/{BOT_USERNAME}?start={code}"


def read_start_param(code: str) -> str:
    return base64.urlsafe_b64decode(code + "=" * (-len(code) % 4)).decode()


def parse_command(text):
    m = COMMAND_RE.match(text)
    if not m or (m[2] and m[2].lower() != BOT_USERNAME.lower()):
        return None  # دستور نیست، یا دستوری برای ربات دیگر است
    return m[1].lower(), (m[3] or "").strip()


def send(chat_id, text):
    requests.post(f"{API}/sendMessage", json={"chat_id": chat_id, "text": text}, timeout=10)


print("Share this link:", make_start_link("ref:42"))
offset = 0
while True:
    resp = requests.get(f"{API}/getUpdates", params={"offset": offset, "timeout": 30}, timeout=40).json()
    for update in resp["result"]:
        offset = update["update_id"] + 1
        msg = update.get("message")
        parsed = parse_command(msg.get("text", "")) if msg else None
        if not parsed:
            continue
        name, args = parsed
        chat_id = msg["chat"]["id"]
        if name == "start" and args:
            try:
                send(chat_id, "خوش آمدید! از اینجا آمده‌اید: " + read_start_param(args))
            except ValueError:
                send(chat_id, "خوش آمدید! پارامتر start ناشناخته است.")
        elif name == "start":
            send(chat_id, "خوش آمدید! برای دیدن کارهایی که می‌توانم انجام دهم /help را بفرستید.")
        elif name == "help":
            send(chat_id, "/start - شروع ربات\n/help - همین پیام\n/settings - تنظیمات شما")
        elif name == "settings":
            send(chat_id, "هنوز تنظیماتی وجود ندارد.")
const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;
const BOT_USERNAME = (await (await fetch(`${API}/getMe`)).json()).result.username;
const COMMAND_RE = /^\/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(?:\s+([\s\S]*))?$/;

function makeStartLink(payload) {
  // base64url در Node بدون padding "=" است: فقط A-Z a-z 0-9 _ - باقی می‌ماند (حداکثر 64 کاراکتر)
  const code = Buffer.from(payload).toString("base64url");
  return `https://t.me/${BOT_USERNAME}?start=${code}`;
}

function readStartParam(code) {
  return Buffer.from(code, "base64url").toString("utf8");
}

function parseCommand(text) {
  const m = COMMAND_RE.exec(text);
  if (!m || (m[2] && m[2].toLowerCase() !== BOT_USERNAME.toLowerCase())) {
    return null; // دستور نیست، یا دستوری برای ربات دیگر است
  }
  return { name: m[1].toLowerCase(), args: (m[3] ?? "").trim() };
}

async function send(chatId, text) {
  await fetch(`${API}/sendMessage`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ chat_id: chatId, text }),
  });
}

console.log("Share this link:", makeStartLink("ref:42"));
let offset = 0;
while (true) {
  const resp = await (await fetch(`${API}/getUpdates?offset=${offset}&timeout=30`)).json();
  for (const update of resp.result) {
    offset = update.update_id + 1;
    const msg = update.message;
    const parsed = msg ? parseCommand(msg.text ?? "") : null;
    if (!parsed) continue;
    const { name, args } = parsed;
    const chatId = msg.chat.id;
    if (name === "start" && args) {
      await send(chatId, "خوش آمدید! از اینجا آمده‌اید: " + readStartParam(args));
    } else if (name === "start") {
      await send(chatId, "خوش آمدید! برای دیدن کارهایی که می‌توانم انجام دهم /help را بفرستید.");
    } else if (name === "help") {
      await send(chatId, "/start - شروع ربات\n/help - همین پیام\n/settings - تنظیمات شما");
    } else if (name === "settings") {
      await send(chatId, "هنوز تنظیماتی وجود ندارد.");
    }
  }
}

نسخه‌ی جاوااسکریپت را با نام bot.mjs و Node.js 18 یا بالاتر اجرا کنید (از await در سطح بالا استفاده می‌کند). پارامتر start را ورودی غیرقابل‌اعتماد بدانید: هر کسی می‌تواند لینک بسازد، پس هرگز رمزی در آن نگذارید که به‌تنهایی دسترسی بدهد. تا وقتی وب هوک تنظیم است getUpdates کار نمی‌کند؛ برای production آموزش ست کردن وب هوک ربات تلگرام را ببینید.

دستورات در گروه‌ها و privacy mode

ربات‌ها در گروه به طور پیش‌فرض در privacy mode کار می‌کنند. در این حالت دستوراتی را که صریحاً برای خودشان است (/command@your_bot)، دستورات عمومی مثل /start فقط اگر آخرین رباتی بوده‌اند که در گروه پیام فرستاده، ریپلای‌ها به پیام‌هایشان و پیام‌های سرویسی را دریافت می‌کنند. وقتی چند ربات در یک گروه هستند، از کاربران بخواهید دستورات را از لیست لمس کنند تا بخش @your_bot اضافه شود. برای دریافت همه‌ی پیام‌ها، ربات را ادمین کنید یا privacy mode را با /setprivacy در @BotFather خاموش کنید.

در چت‌های خصوصی، دکمه‌ی منو کنار فیلد ورودی به طور پیش‌فرض لیست دستورات را باز می‌کند. می‌توانید آن را با setChatMenuButton به یک Mini App یا دوباره به دستورات وصل کنید؛ بدون chat_id مقدار پیش‌فرض همه‌ی چت‌ها را تغییر می‌دهد:

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setChatMenuButton" \
  -H "Content-Type: application/json" \
  -d '{"menu_button":{"type":"commands"}}'

انواع دیگر web_app (با text و web_app) و default هستند. از Bot API 10.2 یک BotCommand می‌تواند is_ephemeral: true هم داشته باشد: چنین دستوری اگر در گروه فرستاده شود برای بقیه‌ی اعضا و ربات‌ها نامرئی می‌ماند و فقط ربات آن را دریافت می‌کند.

نکات خوب برای دستورات ربات

رفع مشکلات

نشانهعلت احتمالیراه‌حل
400 با BOT_COMMAND_INVALIDحروف بزرگ، خط تیره، / در ابتدا یا بیش از 32 کاراکتر در commandاز 1 تا 32 حرف کوچک، رقم و زیرخط بدون اسلش استفاده کنید
دستورات تنظیم شده، اما کاربر لیست دیگری می‌بیندیک اسکوپ محدودتر یا لیست مخصوص زبان کاربر اولویت داردهر اسکوپ و زبان را با getMyCommands بررسی کنید
ربات /start را در گروه نادیده می‌گیردprivacy mode و اینکه ربات دیگری آخر پیام داده/start@your_bot را بفرستید یا privacy mode را تغییر دهید
پارامتر start نمی‌رسدکاراکترهای خارج از A-Z a-z 0-9 _ - (مثلاً padding =) یا بیش از 64 کاراکتربا base64url کد کنید، padding را حذف کنید، payload را کوتاه کنید
401 Unauthorizedتوکن اشتباه یا باطل‌شدهراهنمای توکن ربات تلگرام را ببینید

پرسش‌های متداول

چطور به ربات تلگرام دستور (کامند) اضافه کنم؟

یا به @BotFather دستور /setcommands را بفرستید و ربات را انتخاب کنید، یا متد setMyCommands را با لیستی از اشیای BotCommand صدا بزنید. بعد از آن اپ‌های تلگرام وقتی کاربر / تایپ می‌کند دستورات را پیشنهاد می‌دهند و در منو نشان می‌دهند.

دستور ربات تلگرام چه کاراکترهایی می‌تواند داشته باشد؟

در setMyCommands متن دستور 1 تا 32 کاراکتر است و فقط حروف کوچک انگلیسی، رقم و زیرخط مجاز است. توضیح 1 تا 256 کاراکتر است. برای هر اسکوپ و زبان حداکثر 100 دستور می‌توان تنظیم کرد.

چطور به /start پارامتر بدهم؟

از دیپ‌لینکی مثل https://t.me/your_bot?start=airplane استفاده کنید. ربات پیام /start airplane را دریافت می‌کند. پارامتر می‌تواند تا 64 کاراکتر از A-Z، a-z، 0-9، _ و - باشد؛ برای داده‌های دیگر از base64url استفاده کنید.

چرا ربات من دستورات را در گروه نمی‌بیند؟

وقتی privacy mode روشن است (پیش‌فرض)، ربات در گروه دستوراتی را می‌گیرد که صریحاً برای خودش هستند، مثل /command@your_bot، و دستورات عمومی مثل /start را فقط اگر آخرین رباتی بوده که در آن گروه پیام فرستاده. از شکل @your_bot استفاده کنید، ربات را ادمین کنید یا privacy mode را با /setprivacy خاموش کنید.

چطور به ادمین‌های گروه دستورات متفاوتی نشان دهم؟

setMyCommands را با scope برابر {"type": "all_chat_administrators"} برای همه‌ی گروه‌ها، یا {"type": "chat_administrators", "chat_id": ...} برای یک گروه صدا بزنید. با این حال دسترسی را در سرور هم بررسی کنید: آپدیت‌ها نمی‌گویند دستور از کدام اسکوپ آمده است.

چطور همه‌ی دستورات ربات را حذف کنم؟

deleteMyCommands را برای هر اسکوپ و language_code که تنظیم کرده‌اید صدا بزنید. بعد از حذف، کاربران لیست بعدی را به ترتیب جستجو می‌بینند، مثلاً دستورات پیش‌فرض.

ساخت ربات تلگرام: آموزش قدم‌به‌قدم از BotFather تا اولین پیام با Python

ساخت ربات تلگرام قدم‌به‌قدم: ساخت ربات در BotFather، گرفتن توکن، تست با getMe، پیدا کردن chat id و ارسال اولین پیام با curl و Python.

دیپلوی ربات تلگرام: راه‌اندازی روی VPS، داکر و هاست Serverless

آموزش دیپلوی و هاست ربات تلگرام: polling یا وب هوک، سرویس systemd روی VPS، داکر، Cloudflare Workers با secret_token و چک‌لیست راه‌اندازی.

Telegram Bot API 10.0 تا 10.5: تنظیمات ربات، ویجت‌ها، پیام‌های rich و ephemeral، حالت مهمان و بیشتر

تغییرات Telegram Bot API 10.0 تا 10.5: متد setMySettings و BotFullInfo، ویجت‌های HTML، پیام‌های rich و ephemeral و حالت مهمان، همراه با مثال JSON.

خطاهای Telegram Bot API: معنی هر خطا و روش رفع آن

خطاهای ربات تلگرام به زبان ساده: 400 chat not found، 403 bot was blocked by the user، 409 Conflict و 429 retry_after؛ علت، راه حل و کد مدیریت خطا.

محدودیت‌های Telegram Bot API: نرخ ارسال، خطای 429، حجم فایل و طول پیام

محدودیت‌های Telegram Bot API به زبان ساده: 30 پیام در ثانیه، 1 پیام در ثانیه در هر چت، 20 در دقیقه در گروه، مدیریت خطای 429 و محدودیت حجم فایل.

کیبورد ربات تلگرام: دکمه شیشه‌ای (inline keyboard)، دکمه‌های callback و reply keyboard

ساخت دکمه شیشه‌ای ربات تلگرام: inline keyboard با callback_data، پاسخ با answerCallbackQuery، ویرایش پیام بعد از کلیک، reply keyboard و ForceReply.

اتصال n8n به تلگرام: وصل کردن ربات، اجرای ورک‌فلو و ارسال پیام

اتصال n8n به تلگرام: توکن ربات به عنوان Access Token، وب هوک Telegram Trigger روی HTTPS عمومی، ارسال پیام با چت آیدی و رفع خطاهای رایج.

ارسال پیام با ربات تلگرام از طریق API تلگرام (sendMessage)

آموزش ارسال پیام با ربات تلگرام از طریق API تلگرام: متد sendMessage با curl، Python و JavaScript، قالب‌بندی HTML و MarkdownV2، دکمه شیشه‌ای و رفع خطاها.

توکن ربات تلگرام: چیست، چطور بگیریم، بررسی و باطل کنیم

توکن ربات تلگرام چیست و از کجا بگیریم؟ گرفتن توکن از BotFather، پیدا کردن توکن ربات قبلی، تست با getMe، باطل کردن توکن لو رفته و نگهداری امن آن.

وب هوک ربات تلگرام: راه‌اندازی setWebhook، بررسی و رفع خطا

آموزش ست وب هوک تلگرام با setWebhook: پیش‌نیازهای HTTPS و پورت‌ها، secret_token، بررسی با getWebhookInfo، حذف وب هوک و رفع خطاهای رایج مثل 409.

چت آیدی تلگرام: چیست، کجاست و چطور chat id کاربر، گروه و کانال را پیدا کنیم

چت آیدی تلگرام کجاست؟ پیدا کردن chat_id کاربر، گروه، سوپرگروه، کانال و تاپیک با getUpdates، معنی آیدی‌های منفی و رفع مشکل نتیجه خالی و خطای 409.

ربات اینلاین تلگرام: فعال کردن حالت inline و پاسخ به کوئری‌ها

ساخت ربات اینلاین تلگرام: فعال کردن حالت inline با @BotFather یا setMySettings، دریافت آپدیت inline_query و پاسخ با answerInlineQuery.

پرداخت با Telegram Stars در ربات: فاکتور، پیش‌پرداخت، بازپرداخت و اشتراک

دریافت پرداخت با استارز تلگرام در ربات: sendInvoice با ارز XTR، پاسخ به pre_checkout_query، successful_payment، بازپرداخت و اشتراک با کد پایتون و JS.

سرور تست تلگرام: چطور ربات را در محیط تست تلگرام تست کنیم

سرور تست تلگرام برای ربات‌ها: ورود به محیط تست، ساخت ربات تست در BotFather، فراخوانی Bot API با مسیر /test/ و سوییچ TEST در تستر ما.

ویجت تلگرام برای سایت: ورود با تلگرام، جاسازی پست، کامنت‌ها و دکمه اشتراک‌گذاری

ورود با تلگرام در سایت با Telegram Login (OIDC) و ویجت قدیمی همراه کد بررسی hash، جاسازی پست کانال، ویجت کامنت و دکمه اشتراک‌گذاری تلگرام.

مرجع API جاوااسکریپت TelegramWidget: رویدادها، کدهای خطا و محدودیت‌ها

مرجع API جاوااسکریپت ویجت تلگرام: ویژگی‌ها، request()، رویدادها، کدهای خطا، متغیرهای CSS، widget_query و answerWidgetQuery و همه محدودیت‌ها.

مثال ویجت تلگرام: کد کامل HTML و ربات پایتون

مثال‌های کامل ویجت تلگرام با کد: کارت سفارش ثابت، شمارنده با widget_query، نظرسنجی زنده با ویجت اشتراکی و پیش‌نمایش در مرورگر با ربات پایتون.

ویجت تلگرام چیست؟ HTML تعاملی داخل پیام‌های ربات

ویجت تلگرام در Bot API 10.4 چیست؟ ارسال با sendWidget، وضعیت chat_data و public_data، محدودیت‌ها، جاهایی که فعلاً کار می‌کند و تفاوت با مینی اپ.

تست مینی اپ تلگرام: از mock در مرورگر تا اجرای واقعی در تلگرام

تست مینی اپ تلگرام قدم به قدم: حالت mock در مرورگر، اجرای localhost با تونل HTTPS، محیط تست، DevTools در هر پلتفرم و اعتبارسنجی initData در سرور.