GET/api/v2/telegram-bots/{botId}/subscribers
مشتركو بوت تلغرام
يعرض المستخدمين الذين بدأوا هذا البوت. كل عنصر يتضمن conversationContext جاهزاً لـ POST /api/v2/messages/send مع channel=telegram_bot.
متى تستخدمه. لنسخ chatId الرقمي قبل channel=telegram_bot.
مثال الطلب
مثال صحيح: مشتركو البوت
curl --location 'https://raselsms.com/api/v2/telegram-bots/64f1a2b3c4d5e6f7a8b9c0d1/subscribers' \--header 'X-API-Key: YOUR_API_KEY'مثال خاطئ: خطأ: بوت لا تملكه
curl --location 'https://raselsms.com/api/v2/telegram-bots/000000000000000000000000/subscribers' \--header 'X-API-Key: YOUR_API_KEY'لا يمكن قراءة مشتركي بوت لحساب آخر.
مثال الاستجابة
200 — مشتركو البوت
{ "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 }}404 — خطأ: بوت لا تملكه
{ "success": false, "code": "NOT_FOUND", "error": "Bot not found"}لا يمكن قراءة مشتركي بوت لحساب آخر.
401 — مفتاح غير صالح.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "UNAUTHORIZED", "error": "Missing or invalid API key"}طلب 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 | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. | |
| data | json | البيانات الأساسية في مسارات القوائم وملخص الحساب. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 400 | طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 404 | المورد غير موجود لمالك مفتاح API. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
جرّب الطلب
المتغيرات
معرّف بوت تلغرام من GET /api/v2/telegram-bots (نفس accountId).
بحث اختياري في chatId أو username أو الاسم.
رقم الصفحة بدءاً من 1. الافتراضي 1.
حجم الصفحة. عادة 1–50 لسياق المحادثة و1–500 لقوائم الحساب.
الطلب
GET /api/v2/telegram-bots//subscribersالاستجابة
نفّذ طلباً لعرض الاستجابة.