ایران ناتیفیکیشن

پیام‌های ارسالی ربات

تاریخچهٔ پیام‌هایی که ربات فرستاده.

GEThttps://api.irnoti.com/v1/botbuilder/bots/{id}/messages
scope: bot.read

هر ردیف: وضعیت (queued/sent/failed)، خطا و هزینه (ریال، رشته).

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ ربات.
takequeryintegerتعداد (حداکثر ۲۰۰).
beforequerystringفقط شناسه‌های کوچک‌تر.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundربات پیدا نشد یا متعلق به شما نیست.

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

باز کردن در کنسول کامل ←

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

curl -X GET 'https://api.irnoti.com/v1/botbuilder/bots/5/messages' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "3301",
    "kind": "text",
    "error": null,
    "price": "0",
    "chatId": "123456",
    "status": "sent",
    "createdAt": "2026-10-30T10:00:00.000Z"
  }
]
پیام‌های ارسالی ربات — مستندات API | ایران ناتیفیکیشن