مرجع API
المصادقة
أضف مفتاح API في header كل طلب باستخدام:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
⚠️ لا تشارك مفتاح API الخاص بك مع أحد ولا تضعه في كود Frontend عام.
الـ Endpoints الرئيسية
POST
/api/send-messageإرسال رسالة نصية لجهة اتصال
session_idphonemessage
POST
/api/send-mediaإرسال صورة أو ملف أو صوت
session_idphonemedia_urlcaption
GET
/api/contactsالحصول على قائمة جهات الاتصال
pagelimitsearch
POST
/api/contactsإضافة جهة اتصال جديدة
phonenametags
GET
/api/sessionsقائمة جلسات واتساب المتاحة
POST
/api/broadcastبدء حملة بث جماعي
session_idcontactsmessagedelay_seconds
مثال عملي — إرسال رسالة
JavaScript:
// Send a WhatsApp message
const response = await fetch(
'https://your-server.com/api/send-message',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
session_id: 'session1',
phone: '96650XXXXXXX',
message: 'Hello!'
})
}
);
cURL:
curl -X POST https://your-server.com/api/send-message \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id":"s1","phone":"966XXXXXXX","message":"Hello"}'
Webhooks
استقبل الأحداث في الوقت الفعلي على خادمك عند وصول رسالة جديدة أو تغيير حالة طلب.
message.receivedرسالة جديدة واردةmessage.sentتم إرسال رسالةorder.createdتم إنشاء طلب جديدsession.disconnectedانقطع اتصال الجلسةحدود الاستخدام (Rate Limits)
100
طلب/دقيقة
الخطة الأساسية
1,000
طلب/دقيقة
الخطة الاحترافية
غير محدود
الخطة المؤسسية