إنشاء جلسة

حجز معرف جلسة جديد في النظام.

POST

https://api.wawp.net/v2/session/create?access_token=YOUR_ACCESS_TOKEN

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

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

تسجيل الدخول

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

يدعم

POST

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

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

أمان الجلسة

حافظ على سرية معرف الجلسة session_id ولا تشاركه علنًا أبدًا.

حالة الجلسة

تحقق من حالة الجلسة بانتظام أو استخدم Webhooks للتحديثات.

توصيات

قم بإنشاء الجلسات 'عند الطلب' للحفاظ على نظافة لوحة التحكم وتعظيم استخدام حصتك.
أتبع دائماً استدعاء الإنشاء باستدعاء البدء (Start) لبدء عملية توليد رمز QR.
تأكد من أن مخطط قاعدة البيانات لديك يمكنه التعامل مع سلاسل أبجدية رقمية مكونة من 12 حرفاً لـ 'instance_id'.

إنشاء جلسة Wawp: الخطوة الأولى في رحلة الأتمتة

تعد نقطة النهاية /v2/session/create بمثابة "بوابة الدخول" إلى كامل منظومة Wawp. هي ليست مجرد أمر برمجي، بل هي عملية هندسية معقدة تتم خلف الكواليس لتخصيص موارد سحابية معزولة وضمان جاهزية المحرك لربط حساب واتساب خاص بك.

كيف يعمل "مصنع الجلسات"؟

عندما تُرسل طلباً لإنشاء جلسة، يقوم نظامنا بعدة عمليات متسلسلة في أجزاء من الثانية:

التحقق من الهوية والقواعد: نتأكد من أن access_token الخاص بك صالح وأنك لم تتجاوز الحصة المسموح بها (Quota) في خطتك الحالية.
اختيار العقدة (Node Selection): نختار أفضل خادم حالي متاح من حيث الموارد والقرب الجغرافي لضمان أقل زمن استجابة (Latency).
توليد الهوية الفريدة: يتم إنشاء instance_id فريد تماماً، وهو المعرف الذي سيرافقك في كافة العمليات البرمجية القادمة.
تجهيز البيئة المعزولة: يتم إنشاء حاوية (Container) مخصصة لهذه الجلسة فقط، لضمان عدم تداخل البيانات بين حساباتك المختلفة.

الاستخدام الذكي: متى وكيف تُنشيء الجلسات؟

استراتيجية "الإنشاء عند الطلب" (Just-In-Time Provisioning)

من الأخطاء الشائعة بين المطورين المبتدئين إنشاء مئات الجلسات مسبقاً قبل الحاجة الفعلية إليها. هذا يؤدي إلى استهلاك غير مبرر لحصتك المتاحة. الطريقة الاحترافية: أنشئ الجلسة فقط عندما يقوم المستخدم بالنقر على زر "ربط واتساب" في واجهة تطبيقك. هذا يضمن أن كل جلسة في حسابك هي جلسة نشطة ومستهدفة.

تكامل قاعدة البيانات

عند نجاح عملية الإنشاء، تعيد لك API كلاً من instance_id و server_name.

[!IMPORTANT] يجب عليك حفظ هذين المعطيين فوراً في قاعدة بياناتك وربطهما بمعرف المستخدم (User ID) في نظامك. بدون تسجيلهما، ستفقد القدرة على التحكم في الجلسة برمجياً.

أفضل الممارسات الأمنية والتقنية

1. حماية الـ Access Token

تذكر أن كلاً من access_token و instance_id يمنحان السيطرة الكاملة على الجلسة. لا تقم أبداً بتمرير هذه القيم في مسار الرابط (URL Parameters) أو عرضها في سجلات المتصفح الأمامية. اجعل كافة الطلبات تتم عبر خادمك الخلفي (Backend) لإبقاء مفاتيحك آمنة.

2. التعامل مع الحصص (Quota Management)

إذا تلقيت استجابة 403 Forbidden مع رسالة "Quota Reached"، فهذا يعني أنك بلغت الحد الأقصى للجلسات المسموح بها في خطتك.

الحل البرمجي: ابحث في قاعدة بياناتك عن الجلسات القديمة التي لم تعد تُستخدم وقم بحذفها عبر /v2/session/delete لتحرير مكان لجلسة جديدة، أو قم بترقية خطتك.

3. ثبات الخادم (Server Stability)

حقل server_name الذي نرسله لك يساعد فريق الدعم الفني لدينا في تحديد مكان جلستك بدقة إذا واجهت أي مشاكل. ننصح بعرضه في "معلومات النظام" داخل لوحة تحكم تطبيقك لتسهيل التواصل مع الدعم.

حالات استخدام عملية

أ- منصات خدمة العملاء (CRM)

عندما يقوم عميل جديد بالتسجيل في منصتك، يمكنك تلقائياً استدعاء create لتجهيز بيئة الواتساب الخاصة به، مما يجعل عملية الإعداد (Onboarding) سريعة وسلسة.

ب- أنظمة إخطارات المتجر الإلكتروني

بدلاً من استخدام رقم واحد لكل الإخطارات، يمكنك إنشاء جلسات منفصلة (بأرقام واتساب مختلفة) لكل قسم: "المبيعات"، "الدعم الفني"، "تأكيد الطلبات". هذا يوزع ضغط الرسائل ويقلل احتمالية حظر الرقم من قِبل واتساب.

استكشاف الأخطاء وإصلاحها (Troubleshooting)

الخطأ: "Instance ID already exists"

على الرغم من أننا نولد المعرفات تلقائياً في معظم الأحيان، إلا أنك إذا كنت توفر معرفاً خاصاً، فتأكد من أنه فريد. يفضل ترك النظام يولد المعرف لضمان عدم التصادم.

الخطأ: "Invalid Access Token"

تحقق من أنك تنسخ الرمز بالكامل وبدون مسافات زائدة. تذكر أن الرمز حساس لحالة الأحرف.

الخطوات القادمة بعد الإنشاء

إنشاء الجلسة هو مجرد "حجز مكان". هي الآن في حالة STOPPED. لتفعيلها فعلياً، يجب عليك دائماً اتباع عملية create باستدعاء فوري لنقطة النهاية /v2/session/start. لا تتوقع الحصول على رمز QR أو إرسال رسائل قبل إتمام خطوة "البدء".

البارامترات

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

محتوى الطلب

يرسل كـ JSON

string

مفتاح الوصول

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/session/create";
3const params = new URLSearchParams({
4  "access_token": "YOUR_ACCESS_TOKEN"
5}).toString();
6
7
8fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
9  method: "POST",
10  headers: { "Content-Type": "application/json" },
11  
12})
13  .then(async (response) => {
14    if (response.ok) {
15      const data = await response.json();
16      console.log("Success:", data);
17      return data;
18    }
19    
20    // Error Handling
21    if (response.status === 400) {
22      console.error("Error 400: Bad Request - Missing Token");
23    }
24    if (response.status === 401) {
25      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
26    }
27    if (response.status === 403) {
28      console.error("Error 403: ممنوع - تم الوصول إلى الحصة أو الحد");
29    }
30    if (response.status === 500) {
31      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
32    }
33
34    const errorText = await response.text();
35    console.error(`Error ${response.status}: ${errorText}`);
36  })
37  .catch((error) => console.error("Network Error:", error));

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

Ln 37, Col 1javascript

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

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

تم إنشاء الجلسة بنجاح وجاهزة للتفعيل.

Bad Request - Missing Token

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

Command Palette

Search for a command to run...