آموزش کامل راه‌اندازی Webhook برای بات تلگرام

در این آموزش، به‌صورت ساده و کاربردی یاد می‌گیرید که چطور Webhook را برای بات تلگرام خود فعال کرده و پیام‌های کاربران را به سرور خود دریافت کنید.


۱. پیش‌نیازها

  • توکن بات تلگرام (از @BotFather دریافت کنید)
  • دامنه یا IP معتبر با پروتکل HTTPS
  • یک فایل backend برای دریافت پیام‌ها (مثلاً PHP, Python, Node.js)

۲. ساخت فایل دریافت پیام (مثال با PHP)

<?php
$content = file_get_contents("php://input");
$update = json_decode($content, true);

if(isset($update["message"])) {
    $chat_id = $update["message"]["chat"]["id"];
    $text = $update["message"]["text"];

    file_put_contents("log.txt", "Message from $chat_id: $text\n", FILE_APPEND);
}
?>

۳. ثبت Webhook در سرور تلگرام

از دستور زیر برای اتصال دامنه خود به بات استفاده کنید:

https://api.telegram.org/botYOUR_BOT_TOKEN/setWebhook?url=https://yourdomain.com/yourfile.php

به جای YOUR_BOT_TOKEN توکن بات خود و به‌جای yourfile.php مسیر فایل گیرنده را وارد کنید.

۴. بررسی اتصال وب‌هوک

برای بررسی وضعیت Webhook از آدرس زیر استفاده کنید:

https://api.telegram.org/botYOUR_BOT_TOKEN/getWebhookInfo

۵. حذف Webhook در صورت نیاز

https://api.telegram.org/botYOUR_BOT_TOKEN/deleteWebhook

۶. نکات امنیتی

  • از مسیرهای خاص و غیرقابل‌حدس برای فایل Webhook استفاده کنید.
  • در صورت نیاز، آی‌پی‌های تلگرام را بررسی و محدود کنید.
  • فایل PHP را در پوشه‌ای با دسترسی محدود قرار دهید.

آموزش توسط مسترگروپ