ایران ناتیفیکیشن
ورودشروع رایگان
مستنداتv1 stable
SDKهادریافت کلید API

تنظیم آدرس بازگشتی (وب‌هوک)

آدرس سرور خودتان را بدهید؛ آپدیت‌های تلگرام از طریق بروکر به همان آدرس POST می‌شوند.

PUThttps://api.irnoti.com/v1/broker/bots/{id}/webhook
scope: broker.write

آدرس باید http/https عمومی باشد (آدرس شبکهٔ داخلی رد می‌شود). اگر secretToken بدهید، بروکر آن را در هدر X-Telegram-Bot-Api-Secret-Token هر درخواست می‌فرستد تا اصالت را بسنجید. آدرس در پنل هم نمایش داده می‌شود. پاسخ سرور شما (مثلاً reply درون‌خطی) به تلگرام برمی‌گردد.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسه ربات در بروکر.
url *بدنهstringآدرس وب‌هوک سرور شما.
secretTokenبدنهstringحداکثر ۲۵۶ نویسه: حروف لاتین، عدد، _ و -.
allowedUpdatesبدنهstring[]مثلاً ["message", "callback_query"].
dropPendingUpdatesبدنهbooleanپاک‌کردن آپدیت‌های معلق.

خطاهای خاص این endpoint

400invalid_webhook_urlآدرس نامعتبر یا داخلی است.

اجرای زنده (محیط تست)

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی
وضعیت وب‌هوک
بعدی ←
حذف وب‌هوک
curl -X PUT 'https://api.irnoti.com/v1/broker/bots/31/webhook' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://shop.example.ir/telegram",
  "secretToken": "my_secret_123"
}'
پاسخ نمونه200 OK
{
  "status": 200,
  "response": {
    "ok": true,
    "result": true,
    "description": "Webhook was set"
  }
}