بدء سريع · الإرسال
إرسال أول رسالة واتساب
بعد أن يصبح لديك مفتاح API، تحتاج شيئًا واحدًا آخر فقط: رقم واتساب متصل. بعدها رسالتك الأولى هي طلب HTTP واحد.
لم تنشئ مفتاح API بعد؟
راجع بدء سريع: الحصول على مفتاح API أولًا — تستغرق أقل من دقيقتين.
١. اربط رقم واتساب واحصل على معرّف الجلسة
من لوحة التحكم: الجلسات ← إضافة جلسة، ثم امسح رمز QR من واتساب على هاتفك (الأجهزة المرتبطة ← ربط جهاز). الرقم يصبح نشطًا خلال دقائق. معرّف الجلسة الناتج يظهر في اللوحة، ويمكن أيضًا قراءته برمجيًا:
curl https://wasaas.org/api/v1/sessions \
-H "Authorization: Bearer wsa_your_api_key"[
{
"session_id": "customer-5-1",
"phone": "+966501234567",
"status": "connected",
"created_at": "2026-05-01T10:00:00.000Z"
}
]الإرسال يعمل فقط عندما تكون الحالة connected. إن كانت qr_pending أو disconnected، ارجع للوحة التحكم وأعد مسح الرمز.
٢. أرسل الرسالة
أرقام المستلمين بصيغة دولية بدون علامة + في البداية (مثل 966501234567 للسعودية):
curl -X POST https://wasaas.org/api/v1/messages \
-H "Authorization: Bearer wsa_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"session_id": "customer-5-1",
"to": "966501234567",
"message": "مرحبًا من Wasaas 👋"
}'استجابة ناجحة:
{ "success": true, "to": "966501234567", "status": "sent" }إن فشل الطلب
| الرمز | السبب |
|---|---|
| 401 | مفتاح API غير صالح أو ملغى |
| 404 | معرّف الجلسة لا ينتمي لحسابك أو مكتوب خطأ |
| 429 | استهلكت حصة الرسائل الشهرية لباقتك |
| 500 | فشل واتساب في التسليم — تحقق أن حالة الجلسة ما زالت connected |
حدود حقيقية
هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط — الرسائل الصوتية والموقع الجغرافي والأزرار التفاعلية غير متاحة. ولا يوجد حاليًا إرسال أحداث (webhooks) إلى سيرفرك الخاص عند وصول أو تسليم رسالة.
إلى أين تذهب بعد ذلك
- بدء سريع: Node.js — نفس الإرسال من كود Node.js بدلًا من curl
- بدء سريع: Laravel وPHP — نفس الإرسال من مشروع PHP أو Laravel
- بدء سريع: n8n — نفس الإرسال من تدفق أتمتة
- توثيق REST API: إرسال النصوص (بالإنجليزية) — كل الحقول وحالات الخطأ
- أسعار واجهة API للواتساب — حدود الرسائل لكل باقة