الشروحات والمساعدة

افتح موقع الواتس المباشر

اذهب إلى الموقع الرئيسي للمرسل الذكي من خلال المتصفح.

اضغط "ابدأ مجانا" أو "إنشاء حساب"

ستجد زر "ابدأ مجانا" في أعلى الصفحة أو في وسطها. اضغط عليه للانتقال لصفحة التسجيل.

أدخل بياناتك

املأ النموذج بالمعلومات التالية:

• • الاسم: اسمك الكامل
• • رقم الهاتف: بالصيغة الدولية بدون + 9665XXXXXXXX
• • كلمة المرور: اختر كلمة مرور قوية

استلم رمز التحقق OTP

سيتم إرسال رمز تحقق (OTP) مكون من 6 أرقام إلى رقم واتساب الخاص بك.

أدخل رمز التحقق

أدخل رمز OTP المكون من 6 أرقام في الحقل المخصص لتأكيد رقم هاتفك.

تم إنشاء الحساب!

تهانينا! تم إنشاء حسابك بنجاح. يمكنك الآن تسجيل الدخول واستخدام لوحة التحكم والإضافة.

افتح متصفح Google Chrome

الإضافة تعمل حصريا على متصفح Google Chrome أو المتصفحات المبنية على Chromium (مثل Edge، Brave).

افتح صفحة الإضافة في سوق Chrome الإلكتروني

اضغط على الرابط التالي للانتقال مباشرة لصفحة الإضافة في المتجر:

أو ابحث عن "الواتس المباشر" في سوق Chrome الإلكتروني.

اضغط "إضافة إلى Chrome"

في صفحة الإضافة بالمتجر، اضغط على زر "إضافة إلى Chrome" (أو "Add to Chrome"). ستظهر نافذة تأكيد بالصلاحيات المطلوبة.

وافق على الصلاحيات

ستظهر نافذة منبثقة تطلب الموافقة على صلاحيات الإضافة. اضغط "إضافة إضافة" (Add extension) للمتابعة.

ثبّت أيقونة الإضافة في شريط الأدوات

بعد التثبيت، اضغط على أيقونة الإضافات (😏) في شريط أدوات المتصفح، ثم اضغط على رمز التثبيت (📌) بجانب "الواتس المباشر" لتثبيتها في الشريط.

افتح واتساب ويب

افتح web.whatsapp.com وسجّل الدخول بحسابك. ستلاحظ ظهور زر "الواتس المباشر" العائم في أسفل يسار الشاشة.

افتح واتساب ويب

تأكد أنك على صفحة web.whatsapp.com وأنك مسجّل الدخول بحساب واتساب الخاص بك.

اضغط على زر الواتس المباشر

في أسفل يسار شاشة واتساب ويب، ستجد زر "الواتس المباشر" العائم. اضغط عليه لفتح نافذة الإضافة.

سجّل الدخول

أدخل رقم هاتفك وكلمة المرور (نفس بيانات لوحة التحكم). ثم اضغط "تسجيل الدخول".

تأكد من حالة الاتصال

بعد تسجيل الدخول بنجاح، ستتغير حالة الإضافة إلى "متصل" مع نقطة خضراء. هذا يعني أن الإضافة جاهزة للعمل.

فعّل الإرسال التلقائي

قم بتفعيل خيار "إرسال تلقائي" لتبدأ الإضافة بإرسال الرسائل المعلقة تلقائيا بمجرد وجودها. يمكنك تركها مفعّلة دائما.

اذهب إلى "إرسال رسالة"

من لوحة التحكم، اضغط على "إرسال رسالة" في القائمة الجانبية أو من الصفحة الرئيسية.

أدخل أرقام الهواتف

لرسالة فردية: أدخل رقم هاتف واحد بالصيغة الدولية.

لرسائل جماعية: أدخل عدة أرقام، كل رقم في سطر منفصل أو مفصولة بفاصلة.

اكتب محتوى الرسالة

اكتب نص الرسالة التي تريد إرسالها. يمكنك إضافة إيموجي والكتابة بأي لغة.

اختياري: يمكنك إرفاق ملف (صورة، مستند، فيديو) مع الرسالة عبر زر "إرفاق ملف".

اضغط "إرسال"

اضغط زر "إرسال". سيتم إضافة الرسائل إلى قائمة الانتظار بحالة "معلق".

افتح واتساب ويب مع الإضافة

تأكد أن واتساب ويب مفتوح ومسجل الدخول، وأن إضافة الواتس المباشر متصلة والإرسال التلقائي مفعّل.

تابع تقدم الإرسال

ستبدأ الإضافة بإرسال الرسائل واحدة تلو الأخرى تلقائيا. يمكنك متابعة التقدم من نافذة الإضافة:

إدارة الرسائل من الإضافة

من تبويب "الرسائل" في الإضافة، يمكنك:

• • مشاهدة قائمة جميع الرسائل وحالاتها
• • حذف رسالة تسبب مشكلة في الإرسال
• • تغيير حالة رسالة إلى "فشل" لتخطيها

احصل على مفتاح API

من لوحة التحكم، اذهب إلى "الإعدادات" وانسخ مفتاح API الخاص بحسابك. المفتاح يبدأ بـ wsk_

المصادقة (Authentication)

يمكنك المصادقة بإحدى طريقتين:

الطريقة 1: مفتاح API - أضف المفتاح في ترويسة (Header) كل طلب:

الطريقة 2: Basic Auth - استخدم رقم الهاتف وكلمة المرور:

مثال: للرقم 966501234567 وكلمة المرور mypass أرسل الترويسة Authorization: Basic OTY2NTAxMjM0NTY3Om15cGFzcw==

إرسال رسالة واحدة

لإرسال رسالة لرقم واحد، استخدم هذا الطلب:

أرسل JSON يحتوي على رقم الهاتف ومحتوى الرسالة، أو FormData لإرفاق ملف (صورة، مستند، فيديو).

إرسال رسائل جماعية

لإرسال لعدة أرقام دفعة واحدة مع إمكانية إرفاق ملف:

أرسل FormData يحتوي على الأرقام والمحتوى والملف (اختياري).

مثال JavaScript (fetch)

// Method 1: API Key authentication
const response = await fetch('/api/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'wsk_your_api_key'
  },
  body: JSON.stringify({
    phone: '966501234567',
    content: 'Hello from API!'
  })
});

// Method 2: Basic Auth (phone:password)
const response2 = await fetch('/api/messages', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + btoa('966501234567:your_password')
  },
  body: JSON.stringify({
    phone: '966501234567',
    content: 'Hello from API!'
  })
});

// Send with file attachment
const form = new FormData();
form.append('phone', '966501234567');
form.append('content', 'Check this file!');
form.append('attachment', fileInput.files[0]);
const response3 = await fetch('/api/messages', {
  method: 'POST',
  headers: { 'X-API-Key': 'wsk_your_api_key' },
  body: form
});

مثال cURL

# Single message (API Key)
curl -X POST https://your-domain.com/api/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: wsk_your_api_key" \
  -d '{"phone":"966501234567","content":"Hello!"}'

# Single message (Basic Auth)
curl -X POST https://your-domain.com/api/messages \
  -u "966501234567:your_password" \
  -H "Content-Type: application/json" \
  -d '{"phone":"966501234567","content":"Hello!"}'

# Single message with file attachment
curl -X POST https://your-domain.com/api/messages \
  -H "X-API-Key: wsk_your_api_key" \
  -F "phone=966501234567" \
  -F "content=Check this file!" \
  -F "attachment=@/path/to/image.jpg"

# Bulk messages with file
curl -X POST https://your-domain.com/api/messages/bulk \
  -H "X-API-Key: wsk_your_api_key" \
  -F "phones=966501234567,966509876543" \
  -F "content=Hello everyone!" \
  -F "file=@/path/to/image.jpg"

التوثيق الكامل للـ API

للاطلاع على جميع نقاط النهاية (Endpoints) والبارامترات والأمثلة التفصيلية: