استمرار البيانات

إيقاف الجلسة لا يحذف بيانات المصادقة. يمكنك إعادة التشغيل في أي وقت دون إعادة مسح QR.

فلسفة "الإيقاف النظيف" مقابل "الحذف"

من المهم جداً التمييز بين الإيقاف (stop) والحذف (delete). - الإيقاف (stop): يحافظ على "شخصية" الجلسة. عندما تعيد تشغيلها لاحقاً، ستظل مرتبطة بنفس رقم الهاتف ولن تحتاج لمسح رمز QR جديد. هو إجراء مؤقت للصيانة وتوفير الموارد. - الحذف (delete): إجراء مدمر يمسح كل شيء.

لماذا يجب عليك استخدام الإيقاف بانتظام؟

1. استقرار الأداء: الجلسات التي تعمل لأسابيع طويلة دون توقف قد تواجه أحياناً تسرباً في الذاكرة (Memory Leaks) بسبب طبيعة متصفح Headless Chrome. الإيقاف ثم التشغيل ينظف الذاكرة تماماً. 2. الامتثال لقواعد واتساب: إبقاء الجلسة متصلة 24/7 بينما لا يوجد نشاط حقيقي قد يثير أحياناً أنظمة الرقابة الآلية لدى واتساب. الإيقاف في

الأوركسترا التقنية: ماذا يحدث عند طلب الإيقاف؟

عند إرسال طلب إلى /v2/session/stop، يقوم نظام Wawp بالخطوات التالية: 1. إيقاف الاستلام (Intercept Stop): نتوقف فوراً عن استقبال أي رسائل جديدة من خوادم واتساب. 2. مزامنة البيانات (State Sync): نقوم بحفظ الحالة النهائية لقاعدة البيانات المحلية للتأكد من عدم فقدان أي "علامات قراءة" (Seen Marks) أو تعديلات أخيرة. 3. قتل ا

1. مؤقت الخمول

أحد أفضل الأنماط المعمارية هو تنفيذ "مؤقت خمول" في تطبيقك. مثال: إذا لم يقم المستخدم بإرسال رسالة ولم يستقبل النظام أي رسالة لهذا المستخدم خلال آخر 12 ساعة، قم تلقائياً باستدعاء /v2/session/stop. هذا يضمن أن خوادمك تعمل دائماً بأقصى كفاءة للجلسات النشطة فعلياً.

2. الصيانة المجدولة

ننصح بجدولة عملية إيقاف وتشغيل (Stop -> Start) لجميع الجلسات مرة كل أسبوع في ساعات الفجر. هذا الإجراء البسيط يضمن تحديث كافة الكاشات (Caches) وحل أي مشاكل تقنية خفية قد تكون تراكمت. ---

تفادي فقدان البيانات

قبل استدعاء stop عبر الكود الخاص بك، تأكد من أنك قمت بمعالجة كافة أحداث الويب هوك (Webhooks) الواردة. في اللحظة التي تتوقف فيها الجلسة، لن تصلك أي تحديثات حتى يتم التشغيل مرة أخرى.

حالة الطوارئ

إذا واجهت جلسة "مجمدة" (Frozen) لا تستجيب لأوامر الإرسال ولا ترسل ويب هوك، فإن استدعاء /v2/session/stop هو الخطوة الأولى لاستعادة السيطرة. هو بمثابة "إعادة تعيين قسري" للبيئة البرمجية. ---

الخطأ: "Instance is already stopped"

هذا يعني أن الطلب وصل ولكن الجلسة ليست في حالة تشغيل. يمكنك تجاهل هذا الخطأ في نظامك لأنه يعني الوصول للنتيجة المطلوبة.

الخطأ: "Stop request timed out"

في حالات نادرة، قد يرفض متصفح Chrome الإغلاق بسبب عملية معلقة. إذا حدث هذا، انتظر 30 ثانية ثم حاول مرة أخرى. نظامنا يمتلك "قاتل عمليات" تلقائي يعمل في الخلفية لمعالجة هذه الحالات. ---

قائمة التحقق للإيقاف الناجح:

1. تحقق أن الحالة الحالية هي WORKING أو SCAN_QR_CODE أو STARTING. 2. استدعِ /v2/session/stop. 3. راقب الحالة عبر /v2/session/info حتى تصبح STOPPED. 4. اعرض حالة "غير متصل" أو "في وضع السبات" لمستخدمك النهائي.

إدارة الجلسات

إيقاف جلسة الواتساب

تعطيل الإرسال المؤقت للجلسة بطلبات آمنة.

POST

https://api.wawp.net/v2/session/stop?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/session/stop

يدعم

POSTGET

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

Data Persistence

Stopping a session DOES NOT delete your authentication data. You can restart it anytime without re-scanning the QR code.

توصيات

Use this endpoint to reboot a session if it gets stuck.
Implement an idle-timer in your app to auto-stop sessions that haven't been used for 24+ hours.

Controlled Hibernation: The Power of the /v2/session/stop Endpoint

The /v2/session/stop endpoint is the specialized "Pause" button for your WhatsApp instance. Unlike a deletion, which wipes the slate clean, a "Stop" command puts your engine into a state of Controlled Hibernation. It preserves your authentication data and settings while releasing the underlying compute resources on our high-performance infrastructure.

🏗️ The Technical Lifecycle of a Stopped Session

When you initiate a stop command, Wawp executes a series of clean-up operations:

Queue Flushing: The engine attempts to finalize any outbound transmission tasks currently in the buffer.
Library Shutdown: The WhatsApp-bridge process is signaled to disconnect and save its internal state.
Container Freezing: The isolated environment is paused, meaning it consumes 0% CPU and RAM on our nodes, allowing us to maintain a more efficient and cost-effective ecosystem for you.
Data Persistence: Crucially, your Session Keys and Encryption Secrets are kept in secure persistent storage. This ensures that when you restart, no fresh QR scan is required.

🛡️ Strategic Best Practices

1. Resource Optimization

If you are a SaaS provider with thousands of instances, leaving every session running 24/7 is inefficient.

The Idle-Shutdown Strategy: Monitor your sessions. If a user has been inactive for 72 hours, call /v2/session/stop. This keeps your billing predictable and your dashboard organized.

2. The "Clean Reboot" Sequence

Sometimes, the underlying WhatsApp WebSocket can become "de-synced" from the mobile device.

The Fix: Instead of calling /v2/session/logout, try a sequence of stop followed by start. This forces the engine to reload its libraries and establish a fresh connection to the WhatsApp servers, often resolving transient issues.

3. Webhook Awareness

Remember that a STOPPED session is effectively "offline."

The Warning: You will not receive any message or status webhooks while an instance is stopped. WhatsApp's servers will buffer incoming messages for a limited time (usually 24-72 hours), but prolonged hibernation may lead to message loss once their internal TTL (Time-To-Live) expires.

💡 Industry-Standard Use Cases

A. Nightly Maintenance

For businesses that operate only during local business hours (e.g., a support desk open 9 AM - 5 PM), you can schedule a script to stop all support instances at 6 PM. This provides a clear "Offline" signal to anyone trying to message the business outside of hours.

B. Scalability Management

In a multi-agent environment, where agents log in and out throughout the day, use this endpoint to stop an agent's dedicated instance when they clock out. This ensures that no automated replies or background processes are running while the human agent is away.

⚠️ Common Pitfalls and Troubleshooting

"Instance Not Found" (404)

This error occurs if the session was deleted before the stop command was issued. Ensure your front-end logic respects the sequence of operations.

Delay in Restarting

After calling stop, we recommend waiting at least 3 seconds before calling start again. This gives our cloud orchestrator enough time to fully decommission the previous container before Spinning up a new one.

Summary of Capabilities:

Gracefully disconnect from WhatsApp servers.
Preserve all authentication and QR scan data for future use.
Optimize infrastructure resource consumption.
Provide a "Pause" state for maintenance or off-peak hours.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

	`string`		The 12-character ID of the instance مثال:
	`string`		Your API Access Token مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/session/stop";
3const params = new URLSearchParams({
4  "instance_id": "Your_Instance_ID",
5  "access_token": "YOUR_ACCESS_TOKEN"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "POST",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    if (response.status === 400) {
23      console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
24    }
25    if (response.status === 400) {
26      console.error("Error 400: طلب غير صالح (تنسيق XML)");
27    }
28    if (response.status === 400) {
29      console.error("Error 400: طلب غير صالح (نص عادي)");
30    }
31    if (response.status === 401) {
32      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33    }
34    if (response.status === 401) {
35      console.error("Error 401: غير مصرح (تنسيق XML)");
36    }
37    if (response.status === 404) {
38      console.error("Error 404: غير موجود - الجلسة غير موجودة");
39    }
40    if (response.status === 404) {
41      console.error("Error 404: غير موجود (تنسيق XML)");
42    }
43    if (response.status === 500) {
44      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
45    }
46    if (response.status === 500) {
47      console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
48    }
49    if (response.status === 502) {
50      console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
51    }
52    if (response.status === 502) {
53      console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
54    }
55
56    const errorText = await response.text();
57    console.error(`Error ${response.status}: ${errorText}`);
58  })
59  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 59, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

تم إيقاف الجلسة بنجاح

3 نسخ

النوع:

application/json

string *

object *

Example

{
"name": "wawp-84729105",
"status": "STOPPED",
"config": {
  "webhooks": {
    },
  "proxy": null
  }
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

غير مصرح - مفتاح الوصول غير صالح أو مفقود

2 نسخ

Command Palette

Search for a command to run...