بدء سريع · الإرسال

إرسال أول رسالة واتساب

بعد أن يصبح لديك مفتاح API، تحتاج شيئًا واحدًا آخر فقط: رقم واتساب متصل. بعدها رسالتك الأولى هي طلب HTTP واحد.

لم تنشئ مفتاح API بعد؟

راجع بدء سريع: الحصول على مفتاح API أولًا — تستغرق أقل من دقيقتين.

١. اربط رقم واتساب واحصل على معرّف الجلسة

من لوحة التحكم: الجلسات ← إضافة جلسة، ثم امسح رمز QR من واتساب على هاتفك (الأجهزة المرتبطة ← ربط جهاز). الرقم يصبح نشطًا خلال دقائق. معرّف الجلسة الناتج يظهر في اللوحة، ويمكن أيضًا قراءته برمجيًا:

bash
curl https://wasaas.org/api/v1/sessions \
  -H "Authorization: Bearer wsa_your_api_key"
json
[
  {
    "session_id": "customer-5-1",
    "phone": "+966501234567",
    "status": "connected",
    "created_at": "2026-05-01T10:00:00.000Z"
  }
]

الإرسال يعمل فقط عندما تكون الحالة connected. إن كانت qr_pending أو disconnected، ارجع للوحة التحكم وأعد مسح الرمز.

٢. أرسل الرسالة

أرقام المستلمين بصيغة دولية بدون علامة + في البداية (مثل 966501234567 للسعودية):

bash
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 👋"
  }'

استجابة ناجحة:

json
{ "success": true, "to": "966501234567", "status": "sent" }

إن فشل الطلب

الرمزالسبب
401مفتاح API غير صالح أو ملغى
404معرّف الجلسة لا ينتمي لحسابك أو مكتوب خطأ
429استهلكت حصة الرسائل الشهرية لباقتك
500فشل واتساب في التسليم — تحقق أن حالة الجلسة ما زالت connected

حدود حقيقية

هذا ربط غير رسمي ومبني على الجلسات عبر رمز QR، وليس منصة واتساب الرسمية لمنتجات الأعمال. أنواع الرسائل المدعومة هي النص والصورة والمستند فقط — الرسائل الصوتية والموقع الجغرافي والأزرار التفاعلية غير متاحة. ولا يوجد حاليًا إرسال أحداث (webhooks) إلى سيرفرك الخاص عند وصول أو تسليم رسالة.

إلى أين تذهب بعد ذلك

بدء سريع: إرسال أول رسالة واتساب | Wasaas