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

ارسال درخواست به تلگرام

هر متد Bot API (sendMessage، sendPhoto، getChat، …) را از طریق بروکر اجرا کنید.

POSThttps://api.irnoti.com/v1/broker/bots/{id}/request
scope: broker.request

method نام متد تلگرام و params پارامترهای آن (JSON) است. جواب خودِ تلگرام در response و کد HTTP آن در status برمی‌گردد؛ خطای تلگرام هم همین‌جا می‌آید. آپلود فایل مستقیم (multipart) پشتیبانی نمی‌شود؛ file_id یا URL بدهید، یا مستقیم با لینک ربات کار کنید. متدهای logOut و close مجاز نیستند و setWebhook / deleteWebhook مثل نقطه‌های وب‌هوک ثبت می‌شوند.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسه ربات در بروکر.
method *بدنهstringنام متد Bot API.
paramsبدنهobjectپارامترهای متد.

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

400invalid_methodنام متد معتبر یا مجاز نیست.
403subscription_requiredاشتراک یا افزونهٔ بروکر فعال نیست.
503broker_unavailableاتصال به بروکر برقرار نشد؛ کمی بعد دوباره تلاش کنید.

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

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

→ قبلی
حذف ربات
بعدی ←
دریافت درخواست‌ها (Polling)
curl -X POST 'https://api.irnoti.com/v1/broker/bots/31/request' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "sendMessage",
  "params": {
    "text": "سلام از ایران 👋",
    "chat_id": 123456789
  }
}'
پاسخ نمونه200 OK
{
  "status": 200,
  "response": {
    "ok": true,
    "result": {
      "chat": {
        "id": 123456789
      },
      "text": "سلام از ایران 👋",
      "message_id": 55
    }
  }
}