ابزار ست وبهوک ربات تلگرام و بله

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

توکن را از @BotFather (تلگرام) یا @botfather (بله) دریافت کنید. این مقدار محرمانه است.
آدرس فایل گیرنده روی سرور شما. حتماً باید با HTTPS و گواهی SSL معتبر باشد.

لینک نهایی شما

ست وبهوک در ۴ مرحله

۱

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

در تلگرام به @BotFather و در بله به @botfather پیام دهید، دستور /newbot را بزنید و توکن ربات را کپی کنید.

۲

آماده‌سازی فایل گیرنده روی سرور

یک فایل مثل bot.php روی هاست خود با HTTPS قرار دهید که آپدیت‌های ورودی را دریافت و پردازش کند (نمونه کد در پایین صفحه آمده است).

۳

ساخت لینک با این ابزار

پلتفرم را انتخاب کنید، توکن و آدرس فایل گیرنده را وارد کرده و روی «ساخت لینک» کلیک کنید.

۴

اجرا و تأیید

روی «بررسی وضعیت» بزنید تا نتیجه واقعی سرور را ببینید. پاسخ "ok":true یعنی وبهوک با موفقیت تنظیم شد.

متن پیام‌ها یعنی چی؟

وقتی کاربر به ربات شما پیام می‌دهد، پلتفرم یک «آپدیت» (Update) به‌صورت JSON به آدرس وبهوک شما ارسال می‌کند. مهم‌ترین متن‌هایی که باید بشناسید:

دستور /start
اولین پیامی که کاربر هنگام شروع کار با ربات می‌فرستد. معمولاً ربات با یک پیام خوش‌آمدگویی + دکمه‌های منو پاسخ می‌دهد.
پیام متنی (message.text)
هر متنی که کاربر تایپ می‌کند در این فیلد قرار می‌گیرد. ربات بر اساس آن تصمیم می‌گیرد چه جوابی بدهد.
کلیک روی دکمه (callback_query)
وقتی کاربر روی دکمه‌های شیشه‌ای کلیک می‌کند، یک callback با مقدار data ارسال می‌شود.
دستور /help
برای نمایش راهنمای استفاده از ربات. متن پیشنهادی: «📚 راهنما: برای شروع /start را بزنید.»

نمونه کد فایل گیرنده (bot.php)

این کد را در فایل bot.php قرار دهید. توکن خود را جایگزین کنید. هم با تلگرام و هم با بله سازگار است.

bot.php
<?php
// توکن ربات خود را اینجا قرار دهید
$token = "123456789:ABC-YOUR-TOKEN";

// آدرس API: تلگرام یا بله
$apiBase = "https://api.telegram.org/bot"; // بله: https://tapi.bale.ai/bot

// دریافت آپدیت ورودی به صورت JSON
$update = json_decode(file_get_contents("php://input"), true);

// تابع ارسال پیام
function sendMessage($chatId, $text) {
    global $token, $apiBase;
    file_get_contents($apiBase . $token . "/sendMessage?" . http_build_query([
        "chat_id" => $chatId,
        "text"    => $text,
    ]));
}

// پردازش پیام متنی
if (isset($update["message"])) {
    $chatId = $update["message"]["chat"]["id"];
    $text   = $update["message"]["text"] ?? "";

    if ($text === "/start") {
        sendMessage($chatId, "سلام 👋 به ربات رایا وردپرس خوش آمدید!");
    } elseif ($text === "/help") {
        sendMessage($chatId, "📚 راهنما: برای شروع /start را بزنید.");
    } else {
        sendMessage($chatId, "پیام شما دریافت شد ✅");
    }
}

// پاسخ به پلتفرم
http_response_code(200);
echo "OK";

امکانات این ابزار

ساخت لینک هوشمند

لینک ست وبهوک برای تلگرام و بله به‌صورت خودکار و استاندارد ساخته می‌شود؛ بدون نیاز به دانش فنی.

بررسی آنلاین وضعیت

با یک کلیک، درخواست واقعی به سرور ارسال می‌شود و پاسخ JSON واقعی را همان‌جا مشاهده می‌کنید.

مدیریت کامل وبهوک

علاوه بر ست وبهوک، امکان دریافت اطلاعات (getWebhookInfo) و حذف وبهوک (deleteWebhook) نیز فراهم است.

سوالات متداول

وبهوک (Webhook) دقیقاً چیست؟

وبهوک روشی است که در آن پلتفرم (تلگرام/بله) به‌محض دریافت پیام جدید، آن را بلافاصله به آدرس سرور شما ارسال می‌کند. برخلاف روش Long Polling که ربات باید مدام سرور را چک کند، وبهوک سریع‌تر، بهینه‌تر و مناسب میزبانی روی هاست است.

آیا توکن من جایی ذخیره می‌شود؟

خیر. تمام پردازش‌ها در مرورگر شما (سمت کلاینت) انجام می‌شود و هیچ اطلاعاتی به سرور ما ارسال یا ذخیره نمی‌گردد. لینک نهایی فقط بین مرورگر شما و سرور رسمی تلگرام/بله رد و بدل می‌شود.

آدرس وبهوک حتماً باید HTTPS باشد؟

بله. هم تلگرام و هم بله برای امنیت، فقط آدرس‌هایی با پروتکل HTTPS و گواهی SSL معتبر را می‌پذیرند. آدرس‌های HTTP یا لوکال‌هاست پذیرفته نمی‌شوند.

تفاوت API بله و تلگرام چیست؟

ساختار متدها و آپدیت‌ها در بله بسیار شبیه تلگرام است، اما آدرس پایه فرق دارد: تلگرام از api.telegram.org/bot و بله از tapi.bale.ai/bot استفاده می‌کند. این ابزار به‌صورت خودکار آدرس درست را بر اساس پلتفرم انتخابی می‌سازد.

بستن