محادثات واتساب ويب
يعرض محادثات جلسة تملكها. كل عنصر يتضمن conversationContext جاهزاً. استخدم type=group للمجموعات الأصلية. الطلب يصل لمزوّد واتساب ويب الحي — اجعل limit منخفضاً (الحد 50).
متى تستخدمه. لنسخ chatId وconversationContext إلى POST /api/v2/messages/send.
مثال الطلب
مثال صحيح: مجموعات الجلسة
curl --location 'https://raselsms.com/api/v2/whatsapp-web/chats' \--header 'X-API-Key: YOUR_API_KEY'مثال خاطئ: خطأ: بدون accountId
curl --location 'https://raselsms.com/api/v2/whatsapp-web/chats' \--header 'X-API-Key: YOUR_API_KEY'accountId إلزامي.
مثال الاستجابة
200 — مجموعات الجلسة
{ "success": true, "data": { "accountId": "session-user-whatsapp-1", "chats": [ { "accountId": "session-user-whatsapp-1", "chatId": "120363012345678901@g.us", "kind": "group", "title": "Support group", "phoneNumber": null, "conversationKey": "whatsapp_web:session-user-whatsapp-1:120363012345678901@g.us", "conversationContext": { "moduleType": "whatsapp_web", "accountId": "session-user-whatsapp-1", "chatId": "120363012345678901@g.us" } } ], "nextCursor": null, "hasMore": false }}400 — خطأ: بدون accountId
{ "success": false, "code": "VALIDATION_ERROR", "error": "accountId is required"}accountId إلزامي.
401 — مفتاح API مفقود أو غير صالح.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "UNAUTHORIZED", "error": "Missing or invalid API key"}403 — الهاتف غير موثّق أو الصلاحية غير كافية (غالباً messages:create أو api_keys:read).
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "FORBIDDEN", "error": "Phone not verified or missing permission"}429 — تم تجاوز حد الطلبات. انتظر Retry-After إن وُجد.
{ "success": false, "requestId": "msgreq_1739012345678_abc123", "code": "RATE_LIMITED", "error": "Rate limit exceeded", "retryAfterSeconds": 30}طلب HTTP
GET /api/v2/whatsapp-web/chats
ترويسات الطلب
| الترويسة | النوع | الوصف |
|---|---|---|
| X-API-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
معاملات الاستعلام
| الحقل | النوع | الوصف |
|---|---|---|
| accountId | string | اسم جلسة واتساب ويب، أو معرّف بوت تلغرام المستخدم في conversationContext.accountId. * |
| type | all | direct | group | قيمة الفلتر. في المحادثات: all أو direct أو group. في حركات المحفظة: credit أو debit. |
| limit | integer | حجم الصفحة. عادة 1–50 لسياق المحادثة و1–500 لقوائم الحساب. |
| cursor | string | مؤشر ترقيم غير شفاف من الاستجابة السابقة. |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| success | boolean | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. | |
| data | json | البيانات الأساسية في مسارات القوائم وملخص الحساب. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 200 | نجاح. |
| 400 | طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 404 | المورد غير موجود لمالك مفتاح API. |
| 409 | تعارض، مثل إعادة استخدام مفتاح Idempotency بجسم مختلف، أو جلسة غير جاهزة. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
| 502 | فشل المزوّد الخارجي في معالجة الطلب. |
| 503 | المزوّد غير متاح أو انتهت مهلة الاتصال. |
جرّب الطلب
المتغيرات
اسم جلسة واتساب ويب، أو معرّف بوت تلغرام المستخدم في conversationContext.accountId.
قيمة الفلتر. في المحادثات: all أو direct أو group. في حركات المحفظة: credit أو debit.
حجم الصفحة. عادة 1–50 لسياق المحادثة و1–500 لقوائم الحساب.
مؤشر ترقيم غير شفاف من الاستجابة السابقة.
الطلب
GET /api/v2/whatsapp-web/chats?type=allالاستجابة
نفّذ طلباً لعرض الاستجابة.