# دليل دمج واتساب لاين - الربط غير الرسمي (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"
}
```

---

شكراً لاستخدامكم **واتساب لاين - القسم الرسمي**!

واتساب لاين API (غير رسمي)

دليلك التقني لدمج حسابات الواتساب العادية (Multi-Device) في تطبيقاتك بسهولة واحترافية.