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-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
معاملات المسار
| الحقل | النوع | الوصف |
|---|---|---|
| botId | string | معرّف بوت تلغرام من GET /api/v2/telegram-bots (نفس accountId). * |
معاملات الاستعلام
| الحقل | النوع | الوصف |
|---|---|---|
| q | string | بحث اختياري في chatId أو username أو الاسم. |
| page | integer | رقم الصفحة بدءاً من 1. الافتراضي 1. |
| limit | integer | حجم الصفحة. عادة 1–50 لسياق المحادثة و1–500 لقوائم الحساب. |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| success | boolean | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. | true |
| data | object | الحمولة الأساسية لمسارات القائمة واللقطة. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 400 | طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 404 | المورد غير موجود لمالك مفتاح API. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
جرّب الطلب
الاستجابة
نفّذ طلباً لعرض الاستجابة.