Rasel / Docs
AR
GET/api/v2/telegram-bots/{botId}/subscribers

مشتركو بوت تلغرام

يعرض المستخدمين الذين بدأوا هذا البوت. كل عنصر يتضمن conversationContext جاهزاً لـ POST /api/v2/messages/send مع channel=telegram_bot.

مثال الاستجابة

استجابة ناجحة

{
  "success": true,
  "data": {
    "accountId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "subscribers": [
      {
        "accountId": "64f1a2b3c4d5e6f7a8b9c0d1",
        "chatId": "123456789",
        "telegramUserId": "123456789",
        "username": "customer",
        "firstName": "Ali",
        "lastName": null,
        "lastSeenAt": "2026-08-31T12:00:00.000Z",
        "conversationKey": "telegram_bot:64f1a2b3c4d5e6f7a8b9c0d1:123456789",
        "conversationContext": {
          "moduleType": "telegram_bot",
          "accountId": "64f1a2b3c4d5e6f7a8b9c0d1",
          "chatId": "123456789"
        }
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1,
    "hasMore": false
  }
}

طلب HTTP

GET /api/v2/telegram-bots/{botId}/subscribers

ترويسات الطلب

الترويسةالنوعالوصف
X-API-Keystringمفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. *

معاملات المسار

الحقلالنوعالوصف
botIdstringمعرّف بوت تلغرام من GET /api/v2/telegram-bots (نفس accountId). *

معاملات الاستعلام

الحقلالنوعالوصف
qstringبحث اختياري في chatId أو username أو الاسم.
pageintegerرقم الصفحة بدءاً من 1. الافتراضي 1.
limitintegerحجم الصفحة. عادة 1–50 لسياق المحادثة و1–500 لقوائم الحساب.

حقول الاستجابة

الحقلالنوعالوصفمثال
successbooleanصحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة.true
dataobjectالحمولة الأساسية لمسارات القائمة واللقطة.

رموز الحالة

الحالةالوصف
200نجاح.
400طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة.
401مفتاح API مفقود أو غير صالح.
403الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء.
404المورد غير موجود لمالك مفتاح API.
429تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى.

جرّب الطلب

الاستجابة

نفّذ طلباً لعرض الاستجابة.