انتقل إلى المحتوى
WbizTool

أرسل رسائل WhatsApp باستخدام cURL

جرّب WbizTool WhatsApp API من الطرفية قبل أن تكتب أي شيفرة. كل أمر أدناه طلب POST واحد إلى https://wbiztool.com/api/v1/، وتُرسل الرسالة من رقمك الخاص، المربوط مثل WhatsApp Web.

ابدأ مجانًا

فترة تجريبية مجانية: 50 رسالة خلال أي 30 يومًا، دون بطاقة.

كيف يعمل

  1. احصل على مفتاح API واربط رقمك

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

  2. اختبر بيانات اعتمادك

    أرسل client_id وapi_key بطلب POST إلى /api/v1/me/. يعني "status": 1 مع "message": "Okay" أنها تعمل. لا يرسل شيئًا ولا يستهلك أي رسائل.

  3. أرسل رسالة

    أرسل POST إلى /api/v1/send_msg/ مع رقم الهاتف والنص. الرد الذي يحتوي على "status": 1 وmsg_id يعني أن الرسالة أُضيفت إلى قائمة الانتظار على رقمك.

  4. تحقّق من أنها أُرسلت

    أرسل POST إلى /api/v1/message/status/<msg_id>/. الحالة 1 تعني مُرسَلة؛ والحالة 2 تعني فاشلة، مع السبب في error.

أمثلة شيفرة cURL

تحقّق من بيانات اعتمادك
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
إرسال نص
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
الرد
{"status": 1, "message": "Created", "msg_id": 9817263}
إرسال صورة من رابط
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
إرسال ملف PDF من رابط
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
رفع ملف من جهازك
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
جدولة رسالة
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
التحقق من حالة الرسالة
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

ما يمكنك فعله

  • JSON أو حقول نموذج

    أرسل الجسم بصيغة JSON، أو كحقول نموذج، أو كبيانات نموذج multipart ‏(-F) عند رفع ملف. تعمل الأمثلة كما هي بمجرد أن تضع معرّفاتك ومفتاحك.

  • الصور والملفات

    يرسل msg_type بالقيمة 1 صورة من img_url، وmsg_type بالقيمة 2 ملفًا من file_url. يمكن أن تصل الملفات المرتبطة إلى 100 MB، ويجب أن يكون الرابط عامًا.

  • الجدولة مع منطقة زمنية

    يقبل schedule_msg ‏date (dd/mm/yyyy) وtime (HH:MM) واسم timezone مثل America/New_York أو اختصارًا مثل IST أو EST.

  • Webhooks لكل حالة

    أضف "webhook": "https://…" وسيرسل WbizTool إليه msg_id وSENT أو FAILED أو CANCELLED أو EXPIRED بطلب POST عند تغيّر حالة الرسالة.

  • الاستدعاءات نفسها من أي أداة

    ترسل Make وPabbly Connect وأدوات الأتمتة الأخرى هذه الطلبات نفسها بوحدة HTTP لديها. وتتوفر أيضًا مجموعة Postman في التوثيق.

من المفيد معرفته

  • "status": 1 يعني أن الرسالة أُضيفت إلى قائمة الانتظار، لا أنها سُلّمت. «مُرسَلة» هي حالة النجاح النهائية؛ ولا يُبلغ API عما إذا كانت الرسالة قد سُلّمت أو قُرئت.
  • داخل JSON، اكتب السطر الجديد في msg بالشكل \n. فاصل السطر الخام أو الفاصلة الزائدة في النهاية يجعلان JSON غير صالح.
  • يُقبل الوقت المجدول الذي مضى ويُرسل فورًا. يبدأ التاريخ باليوم (24/12/2026)، فتحقّق منه قبل الإرسال.
  • تعود أخطاء «إرسال رسالة» مع HTTP 400 (و429 عند بلوغ الحد اليومي)؛ أما أخطاء «جدولة رسالة» فتعود عادةً مع HTTP 200 و"status": 0، لذا فكّ ترميز الجسم دائمًا وتحقّق من status.
  • يعمل الإرسال إلى مجموعة WhatsApp عبر API (group_name بدلًا من phone) على كل الباقات، بما فيها الفترة التجريبية المجانية.
  • تتضمن الفترة التجريبية المجانية 50 رسالة خلال أي 30 يومًا ورقمًا واحدًا، دون بطاقة. تبدأ الباقات المدفوعة من $25 شهريًا في الولايات المتحدة (سعرك في صفحة الأسعار) وترسل رسائل غير محدودة في إطار الاستخدام العادل: حتى 1,000 رسالة يوميًا لكل رقم.
  • تُرسل الرسائل من رقم WhatsApp الخاص بك، لذا تنطبق قواعد WhatsApp نفسها: راسل من يتوقعون رسائلك.

أسئلة

ما نقطة نهاية WhatsApp API لإرسال رسالة؟
أرسل POST إلى https://wbiztool.com/api/v1/send_msg/ مع client_id وapi_key وwhatsapp_client وphone (وcountry_code إذا لم يكن للرقم رمز دولة) وmsg. يحتوي الرد على status و، عند النجاح، msg_id.
كيف أجدول رسالة WhatsApp باستخدام cURL؟
أرسل POST إلى https://wbiztool.com/api/v1/schedule_msg/ بالحقول نفسها إضافة إلى date (dd/mm/yyyy) وtime (HH:MM) وtimezone. يتيح لك msg_id في الرد التحقق منها أو إلغاءها لاحقًا.
كيف أعرف أن الرسالة أُرسلت؟
الرد الذي يحتوي على "status": 1 وmsg_id يعني أنها في قائمة الانتظار. مرّر رابط webhook لتتلقى POST مع SENT أو FAILED أو CANCELLED أو EXPIRED، أو استدعِ نقطة النهاية «حالة الرسالة» مع msg_id. «مُرسَلة» هي الحالة النهائية: لا يُبلغ API عن التسليم أو القراءة.
ما صيغة رقم الهاتف التي يجب أن أرسلها؟
أرسل الرقم مع رمز الدولة (919876543210)، أو دونه (9876543210) مع country_code ‏(91). تُحذف المسافات و+ والشرطات والأقواس تلقائيًا، فيعمل ‎+91 98765-43210 أيضًا.
هل أحتاج إلى WhatsApp Business API أو موافقة Meta؟
لا. يرسل WbizTool من رقم WhatsApp أو WhatsApp Business الخاص بك، المربوط مثل WhatsApp Web. لا توجد موافقة من Meta، ولا قوالب رسائل تحتاج إلى اعتماد.
هل هناك تكلفة على كل رسالة؟
لا. تتضمن الفترة التجريبية المجانية 50 رسالة خلال أي 30 يومًا. ترسل الباقات المدفوعة رسائل غير محدودة في إطار الاستخدام العادل، حتى 1,000 رسالة يوميًا لكل رقم: Lite بسعر $25، وStandard بسعر $59، وAdvanced بسعر $149 شهريًا في الولايات المتحدة؛ وتعرض صفحة الأسعار سعر بلدك.

اقرأ الأدلة

ذات صلة

أرسل أول رسالة WhatsApp تلقائية اليوم

أنشئ حسابًا، وامسح رمز QR، وأرسل رسالة في أقل من خمس دقائق.

ابدأ مجانًا

تبدأ الباقات المدفوعة من $25 شهريًا في الولايات المتحدة. الأسعار