📄 توثيق WhatsApp API
أرسل رسائل WhatsApp برمجياً باستخدام API Key الخاص بك.
🔐 المصادقة
كل الطلبات تحتاج API Key. أرسله بأي طريقة من الثلاث:
🌐 Base URL
https://hawerapp.com/api/whatsapp
📤 إرسال رسالة
POST
/api/whatsapp/send
يرسل رسالة نصية (أو مع صورة) لرقم واحد. الأرقام المحلية (05xx) تُحوَّل تلقائياً للصيغة الدولية.
المعاملات
| الحقل | النوع | إلزامي؟ | الوصف |
|---|---|---|---|
| to | string | Required | رقم الهاتف (05xx أو 9665xx) |
| message | string | Required | نص الرسالة (حد أقصى 4000 حرف) |
| image_url | string | Optional | رابط صورة ترفق مع الرسالة |
| account_id | integer | Optional | ID الرقم للإرسال منه (يختار تلقائياً) |
أمثلة الكود
مثال الاستجابة
{"success":true,"message_id":42,"to":"966501234567","status":"sent"}
📨 إرسال جماعي
POST
/api/whatsapp/send-bulk
يرسل نفس الرسالة لعدة أرقام (حد أقصى 500). تُعالَج تدريجياً في الخلفية.
المعاملات
| الحقل | النوع | إلزامي؟ | الوصف |
|---|---|---|---|
| numbers | array | Required | مصفوفة الأرقام (1–500) |
| message | string | Required | نص الرسالة |
| image_url | string | Optional | رابط صورة |
| account_id | integer | Optional | ID الرقم للإرسال منه |
أمثلة الكود
{"success":true,"queued":3,"status":"processing"}
🔍 حالة الرسالة
GET
/api/whatsapp/messages/{id}
يرجع حالة رسالة بعينها عبر message_id المُعاد من endpoint الإرسال.
{"id":42,"to":"966501234567","status":"sent","sent_at":"2026-05-10T14:30:00+03:00","error":null}
قيم الحالة
| pending | في قائمة الانتظار |
| sending | جاري الإرسال الآن |
| sent | تم الإرسال بنجاح ✓ |
| failed | فشل (راجع حقل error) |
📱 الأرقام المتصلة
GET
/api/whatsapp/accounts
يرجع قائمة أرقام WhatsApp المتصلة مع إحصائياتها.
{"accounts":[{"id":1,"name":"رقم الدعم","phone_number":"966501234567","status":"connected","today_sent":45,"month_sent":1230,"daily_limit":500,"monthly_limit":5000}]}
📊 الرصيد والحدود
GET
/api/whatsapp/balance
يرجع معلومات الباقة والرسائل المستخدمة والمتبقية لهذا الشهر.
{"plan":"أساسية","subscription_ends":"2026-06-10","messages":{"limit":5000,"used":1230,"remaining":3770},"accounts":{"limit":2,"connected":1}}
⚠️ أكواد الأخطاء
| HTTP | السبب | الحل |
|---|---|---|
401 | API Key مفقود أو غلط | تحقق من الـ Key |
403 | حساب موقوف أو اشتراك منتهي | جدد اشتراكك |
422 | لا يوجد رقم متصل / خطأ في البيانات | أضف رقماً وتأكد من الحقول |
429 | تم استنفاد حد الرسائل الشهري | رقّ للباقة التالية |
502 | خطأ في خدمة WhatsApp الداخلية | تحقق أن الرقم متصل وأعد المحاولة |
WhatsApp API © 2026