أهلًا بك 👋
إدارة أرقامك ورسائلك من مكان واحد.
أرقام واتساب
حالة الاتصال والأجهزة المرتبطة
| الرقم / الاسم | الجهاز المرتبط | الحالة | آخر تحديث |
|---|
آخر الرسائل
متابعة سريعة لآخر عمليات الإرسال
| المستلم | الرسالة | رقم الإرسال | الحالة | التاريخ |
|---|
أرقام واتساب
أضف جلسات واتساب متعددة واربط أجهزتك.
بعد إضافة الرقم، افتح واتساب على هاتفك ← الأجهزة المرتبطة ← ربط جهاز، ثم امسح رمز QR الظاهر هنا.
إرسال رسالة
أرسل رسالة اختبارية من أحد أرقامك المتصلة.
قائمة الرسائل
الرسائل المرسلة والمجدولة والمحاولات المتعثرة.
| المستلم | محتوى الرسالة | رقم الإرسال | الحالة | المحاولات | التاريخ | إجراءات |
|---|
تحديد ودمج الرسائل القديمة
اختر رسائل من تاريخ معين ودمجها في رسالة واحدة للحفاظ على الحد اليومي.
الإرسال التلقائي
تحكم في أوقات الإرسال والفاصل بين كل رسالة.
واجهة API
أضف رسائل إلى قائمة الانتظار باستخدام طلب HTTP.
إضافة مجموعة رسائل من الشاشة
أدخل كل مستلم في سطر مستقل. ستُحفظ الرسائل في MySQL وتُرسل حسب إعدادات الجدولة.
التكامل البرمجي
استخدم الطلب التالي من تطبيقك لإضافة رسالة واحدة أو مجموعة.
/api/v1/messagesللنص استخدم JSON. للمرفق أرسل multipart/form-data بحقول sessionId وphone وmedia، وحقل message اختياري كوصف. الملف حتى 15 ميجابايت.
curl.exe -X POST http://localhost:3000/api/v1/messages ` -H "Authorization: Bearer YOUR_API_KEY" ` -F "sessionId=my-whatsapp" -F "phone=2010xxxxxxxx" ` -F "message=وصف اختياري" -F "media=@C:\path\to\file.pdf"
الرؤوس
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
رسالة واحدة
{
"sessionId": "my-whatsapp",
"phone": "2010xxxxxxxx",
"message": "مرحبًا بك"
}
إرسال مجموعة (حتى 1000 رسالة)
{
"messages": [
{ "sessionId": "my-whatsapp", "phone": "2010xxxxxxxx", "message": "مرحبًا" },
{ "sessionId": "my-whatsapp", "phone": "2011xxxxxxxx", "message": "أهلًا" }
]
}
مثال باستخدام curl
curl -X POST http://localhost:3000/api/v1/messages ^
-H "Authorization: Bearer YOUR_API_KEY" ^
-H "Content-Type: application/json" ^
-d "{\"sessionId\":\"my-whatsapp\",\"phone\":\"2010xxxxxxxx\",\"message\":\"مرحبًا\"}"
ضع API_KEY في ملف .env ولا تشاركه علنًا. هذه الواجهة تضيف الرسائل للطابور ولا ترسلها فورًا.
ربط الأرقام عبر API
يبدأ الربط ويرجّع رمز QR أو كود الربط في نفس الرد — يكفي نداء واحد من تطبيقك.
/api/sessions/:id/link{
"method": "qr", // أو "code" للربط بالكود
"phone": "2010xxxxxxx", // اختياري: يُستخدم الرقم المسجّل إن لم يُمرَّر
"timeout": 30
}
// الرد عند النجاح:
// { "success": true, "method": "qr", "qr": "data:image/png;base64,..." }
// { "success": true, "method": "pairing-code", "pairing_code": "ABCD1234" }
تشغيل/إيقاف إرسال رقم
أوقف إرسال رقم بعينه مؤقتًا دون فصله أو حذفه، وبقيت الأرقام تعمل.
/api/sessions/:id/enable{ "enabled": false } // أوقف الإرسال من هذا الرقم
{ "enabled": true } // أعِد تشغيله
تحميل مواصفة OpenAPI: /api/v1/openapi.json