# دليل دمج واتساب لاين - الربط غير الرسمي (Unofficial V1) مرحباً بك في دليل المطورين الخاص بـ **الربط غير الرسمي**. يوفر هذا الإصدار (V1) واجهة برمجة تطبيقات (API) قوية لربط حسابات الواتساب العادية وإرسال الرسائل عبر نظام الأجهزة المرتبطة (Multi-Device). --- ## 1. الحصول على مفاتيح الربط قبل البدء، يجب عليك استخراج مفاتيح الربط الخاصة بك من لوحة التحكم: 1. انتقل إلى **الإعدادات** (Settings) في حسابك. 2. اختر قسم **تكامل API** (API Integration). 3. ستجد هناك قيمتين أساسيتين: * **App ID**: رقم تعريفي فريد لتطبيقك. * **Header Token**: مفتاح الأمان الخاص بالعمليات البرمجية. 4. يمكنك إعادة توليد هذه المفاتيح في أي وقت من نفس الصفحة. --- ## 2. المصادقة (Authentication) تعتمد جميع الطلبات على نظام المصادقة الخاص بالمنصة. يجب إرسال القيم التالية في ترويسة الطلب (Headers) كما يلي: ```http X-Header-App-Id: YOUR_APP_ID X-Header-Authorization: YOUR_HEADER_TOKEN Accept: application/json ``` --- ## 3. إدارة الجلسات ورمز QR ### POST /api/v1/get-qrcode [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#f680e674-3735-4639-bf43-92a25ced88b1) يستخدم هذا الطلب لبدء عملية ربط جهاز جديد وتوليد رمز QR. * **المعاملات (Body):** * `webhook_url` (اختياري): رابط لاستقبال التحديثات (Status & Messages). * **الاستجابة:** ستتلقى رمز QR بصيغة `base64` للبدء في مسحه عبر تطبيق واتساب. ### GET /api/v1/session-status/{session_id} [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6f12dad1-666f-40e4-956d-04ebd0bd264f) التأكد من أن الجهاز لا يزال متصلاً وحالته الحالية. ### DELETE /api/v1/delete-session/{session_id} [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#947237c1-7d04-4165-9ccd-b8ab621675e2) إغلاق الجلسة وحذف بيانات الربط من النظام نهائياً. ### POST /api/v1/reconnect-qrcode [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#d4a49cec-6dca-485c-94df-c92cdd177119) في حال تعطل الجلسة، يمكنك طلب رمز QR جديد لنفس الجهاز دون الحاجة لإنشاء جلسة جديدة. --- ## 4. إدارة الأجهزة ### GET /api/v1/devices [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#4d3546c5-4fbc-4143-8e40-dc9532547839) عرض كافة الأجهزة المرتبطة بحسابك وحالاتها التفصيلية. --- ## 5. إرسال الرسائل ### POST /api/v1/send-message [🔗 تجربة في Postman (نص)](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6bdb6654-2e5a-4ed8-bdb3-6efb30028e77) | [🔗 تجربة في Postman (ميديا)](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6ce3fa98-ad88-4bad-a57b-d76a61ed45e8) الـ Endpoint الرئيسي لإرسال الرسائل (نص، ميديا، ملفات) للأفراد أو المجموعات. * **المعاملات (Body):** * `phone`: رقم المستلم بصيغة دولية. * `group`: رقم الـ ID الخاص بالمجموعة. * `body`: نص الرسالة. * `media_src`: رابط مباشر للملف. --- ## 6. إدارة المجموعات والأرقام ### POST /api/v1/add-contact-numbers [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#d916dcf6-d7f1-47e1-9b6a-da4c7686b1a3) رفع قائمة أرقام وتنظيمها في مجموعة جديدة أو حالية. ### GET /api/v1/get-all-groups [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#676290c5-317c-4ca8-a057-b6a27320fa1b) جلب قائمة بكافة المجموعات التي قمت بإنشائها مسبقاً. ### DELETE /api/v1/delete-group/{group_id} [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#c5e59186-fe02-42a0-815c-ec7e3c83e8e8) حذف مجموعة معينة من النظام. --- شكراً لاستخدامكم **واتساب لاين**!
# دليل دمج واتساب لاين - الربط الرسمي (Official WABA) مرحباً بك في دليل المطورين الخاص بـ **الربط الرسمي عبر Meta (WABA)**. يوفر هذا النظام استقراراً عالي المستوى ومميزات متقدمة مثل القوالب (Templates) والأزرار التفاعلية. --- ## 1. الحصول على مفاتيح الربط 1. انتقل إلى **الإعدادات** (Settings) في حسابك. 2. اختر قسم **تكامل API** (API Integration). 3. استخرج الـ **App ID** والـ **Header Token**. --- ## 2. المصادقة (Authentication) يجب إرسال القيم التالية في ترويسة الطلب (Headers): ```http X-Header-App-Id: YOUR_APP_ID X-Header-Authorization: YOUR_HEADER_TOKEN Accept: application/json ``` --- ## 3. إدارة حسابات WABA (Devices) ### GET /api/integrate/official/v1/devices [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#701f95f5-a09c-4087-adac-a9687f7c5239) عرض كافة حسابات WABA المرتبطة والنشطة. * **الاستجابة:** قائمة بالأرقام الرسمية المسجلة وحالة كل منها. --- ## 4. القوالب (Templates) ### GET /api/integrate/official/v1/templates [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#50874bbc-af4b-4a34-ac80-d5bb01684938) جلب كافة القوالب المعتمدة في حسابك. يحتوي كل قالب على بيانات الجهاز المرتبط به (`session_id`) لتسهيل عملية الإرسال. ### GET /api/integrate/official/v1/templates/{id} [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6b143fba-86f3-42be-bd41-6eb745cd8885) عرض تفاصيل قالب معين. ### DELETE /api/integrate/official/v1/templates/{id} [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#1f226775-8888-4936-86b2-689764be5d80) حذف قالب معين من النظام. --- ## 5. إرسال الرسائل عبر القوالب ### POST /api/integrate/official/v1/send-message [🔗 تجربة في Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#dc42e621-9682-4937-b755-ea146e78066d) هذا المسار مخصص لإرسال الرسائل الرسمية باستخدام القوالب. * **المعاملات (Body):** * `phone` (مطلوب): رقم المستلم (مثال: `2010XXXXXXXX`). * `template_id` (مطلوب): المعرف الرقمي للقالب في النظام. * `device` (اختياري): معرف الجهاز (`session_id`). في حال عدم إرساله، سيتم استخدام أول جهاز رسمي متاح في الحساب. **ملاحظة:** يجب أن يكون القالب منتمياً لنفس الجهاز المختار. * `body_variables` (اختياري): مصفوفة تحتوي على القيم الخاصة بالمتغيرات في نص القالب (مثل `{{1}}`, `{{2}}`). * `button_variables` (اختياري): مصفوفة تحتوي على القيم الخاصة بالمتغيرات في الأزرار (مثل روابط الـ URL المتغيرة). * `header_media_url` (اختياري): رابط مباشر لملف الميديا (صورة، فيديو، مستند) إذا كان القالب يدعم الميديا في الهيدر. * `header_media_id` (اختياري): معرف الميديا المرفوعة مسبقاً (اختياري بدلاً من الرابط). **مثال للطلب (JSON):** ```json { "phone": "2010XXXXXXXX", "template_id": 123, "body_variables": ["عميلنا العزيز", "رقم الطلب 500"], "button_variables": ["order_status_abc"], "header_media_url": "https://example.com/image.jpg" } ``` --- شكراً لاستخدامكم **واتساب لاين - القسم الرسمي**!
مركز المطورين
أقسام الربط
Postman Collection
فتح في Postman
واتساب لاين API (غير رسمي)
دليلك التقني لدمج حسابات الواتساب العادية (Multi-Device) في تطبيقاتك بسهولة واحترافية.
الربط غير الرسمي
الربط الرسمي (WABA)