WhatsApp API — أرسل الرسائل برمجياً

واجهة WhatsApp API متكاملة لإرسال النصوص والوسائط وإدارة المحادثات عبر واجهة REST بسيطة. لا Puppeteer ولا متصفح headless — اتصال WebSocket خالص.

بداية سريعة

أرسل أول رسالة WhatsApp خلال أقل من دقيقة. أنشئ حساباً واربط رقمك واستدعِ الواجهة:

curl -X POST https://api2whats.com/send-text \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"to": "971501234567", "message": "Hello from the API!"}'

هذا كل شيء. طلب واحد. استجابة واحدة. لا حاجة إلى SDK.

ما هي واجهة WhatsApp API؟

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

هذا مفيد لأي شركة تحتاج إلى التواصل مع العملاء على نطاق واسع. تأكيدات الطلبات وتحديثات الشحن وتذكيرات المواعيد وردود دعم العملاء والحملات التسويقية — كلها يمكن أتمتتها عبر واجهة WhatsApp API. وتظهر الرسائل في محادثة WhatsApp نفسها التي يستخدمها العملاء بالفعل، ما يعني أنهم يقرؤونها فعلاً. وتتجاوز معدلات فتح رسائل WhatsApp عادةً 90%، مقارنة بـ 20% للبريد الإلكتروني.

الفكرة مباشرة: يرسل تطبيقك طلب HTTP إلى خادم الواجهة، ويسلّم خادم الواجهة الرسالة إلى المستلم عبر WhatsApp، وتحصل على استجابة تؤكد التسليم. وبالنسبة للرسائل الواردة، تعيد الواجهة توجيهها إلى عنوان URL الخاص بالـ webhook في الوقت الفعلي حتى يتمكن نظامك من معالجتها فوراً.

كيف تعمل واجهة WhatsApp API لدينا

واجهة البرمجة لدينا مبنية على بروتوكول WhatsApp Web باستخدام اتصالات WebSocket مباشرة. وهذا يختلف جوهرياً عن الحلول التي تستخدم Puppeteer أو المتصفحات headless لأتمتة واجهة ويب. فاتصال WebSocket المباشر يعني زمن استجابة أقل واستهلاكاً أقل للموارد وموثوقية أفضل بكثير.

يحافظ كل مثيل تنشئه على اتصال WebSocket مُصادق بخوادم WhatsApp. وعندما ترسل رسالة عبر الواجهة، تنتقل مباشرة عبر اتصال WebSocket هذا. لا يوجد عبء عرض متصفح ولا تحليل لقطات شاشة ولا معالجة DOM هشّة. والاتصال دائم ويتعامل مع إعادة الاتصال تلقائياً.

كما نشغّل مجمع وكلاء SOCKS5 موزّعاً عبر مناطق متعددة. وهذا يخدم غرضين: ضمان اتصال موثوق بغض النظر عن مكان خوادمك، وتوزيع الاتصالات عبر عناوين IP متعددة لتجنّب حدود المعدل. يتصل كل مثيل عبر وكيل مختلف، لذا حتى لو كنت تشغّل عشرة مثيلات في الوقت نفسه، فلكل منها مسار اتصال نظيف خاص به.

ما يمكنك فعله بالواجهة

إرسال رسائل نصية

أبسط حالات الاستخدام: إرسال رسالة نصية إلى أي رقم WhatsApp. تدعم الرسائل Unicode، لذا يمكنك إرسال نص بأي لغة بما في ذلك العربية والهندية والصينية والإيموجي. وتُسلَّم كل رسالة على حدة مع تتبع كامل لحالة التسليم.

إرسال الوسائط

تجاوز النصوص. أرسل الصور والفيديوهات والمستندات والملفات الصوتية والملصقات. يمكن توفير الوسائط عبر URL (تجلبها الواجهة وتسلّمها) أو كبيانات بترميز Base64 للإرسال المضمّن. ويمكن أن تكون المستندات PDF أو ملفات Word أو جداول بيانات — أي نوع ملفات يدعمه WhatsApp.

استقبال الرسائل عبر Webhooks

عندما يرسل شخص ما رسالة إلى رقمك المتصل، تعيد الواجهة توجيهها إلى عنوان URL الخاص بالـ webhook كطلب POST. وتحصل على رقم المرسل ومحتوى الرسالة وأي مرفقات وسائط ومعلومات الطابع الزمني. ويعالج معالج الـ webhook لديك الرسالة ويمكنه تشغيل أي استجابة آلية أو سير عمل.

إدارة أرقام متعددة

تدعم كل خطة عدة مثيلات، ما يعني أنه يمكنك ربط عدة أرقام WhatsApp وإدارتها جميعاً من لوحة تحكم واحدة. وتنقّل بين الأرقام عبر الواجهة بتحديد معرّف المثيل في طلبك. وهذا مفيد للشركات التي تعمل في مناطق أو علامات تجارية متعددة.

تتبع حالة الرسالة

تحصل كل رسالة ترسلها على معرّف فريد. ويمكنك الاستعلام عن حالة أي رسالة — سواء كانت معلقة أم مرسلة أم مُسلّمة أم مقروءة. كما تدفع الـ webhooks تحديثات الحالة في الوقت الفعلي، ليعرف نظامك لحظة تسليم الرسالة أو قراءتها دون الحاجة إلى الاستطلاع.

نقاط نهاية API

تتبع الواجهة تصميماً نظيفاً لـ REST. تقبل جميع نقاط النهاية JSON وتُرجع JSON. إليك نقاط النهاية الرئيسية:

  • POST /send-text — إرسال رسالة نصية
  • POST /send-image — إرسال صورة
  • POST /send-video — إرسال فيديو
  • POST /send-document — إرسال مستند أو ملف
  • POST /send-audio — إرسال ملف صوتي
  • POST /send-location — إرسال دبوس موقع
  • GET /message-status/{id} — التحقق من حالة التسليم
  • POST /set-webhook — تهيئة عنوان URL الخاص بالـ webhook
  • GET /instance/status — التحقق من حالة الاتصال

تتطلب كل نقطة نهاية مفتاح API يُمرَّر في ترويسة Authorization. وتُطبق حدود المعدل لكل خطة، وتُرجع الواجهة رسائل خطأ واضحة مع رموز حالة HTTP عندما يحدث خطأ ما.

طرق الاتصال

ربط رقم هاتف بالواجهة أمر بسيط. وندعم طريقتين:

الاتصال عبر رمز QR

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

الاتصال عبر رمز الاقتران

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

لغات البرمجة المدعومة

الواجهة مستقلة عن اللغة. فأي لغة قادرة على إرسال طلبات HTTP يمكنها استخدامها. ونوفر نماذج كود جاهزة لـ:

  • PHP — باستخدام cURL أو Guzzle
  • Python — باستخدام مكتبة requests
  • JavaScript — باستخدام fetch أو axios (Node.js والمتصفح)
  • cURL — الاستخدام المباشر من سطر الأوامر
  • Go — باستخدام net/http
  • Java — باستخدام HttpURLConnection أو OkHttp

إذا كانت لغتك قادرة على إرسال طلب HTTP POST بجسم JSON، فيمكنك استخدام هذه الواجهة. لا حاجة إلى تثبيت SDK.

مسار تسليم الرسالة

فهم كيفية تدفق الرسائل عبر النظام يساعدك على بناء تكاملات أفضل. عندما ترسل رسالة، إليك ما يحدث خطوة بخطوة:

  1. يرسل تطبيقك طلب HTTP إلى الواجهة مع مفتاح API وبيانات الرسالة
  2. تتحقق الواجهة من صحة طلبك: تفحص مفتاح API وتتحقق من صيغة رقم الهاتف وتؤكد أن المثيل متصل
  3. توضع الرسالة في قائمة الانتظار للتسليم عبر اتصال WebSocket الخاص بالمثيل المناسب
  4. تُنقل الرسالة إلى خوادم WhatsApp عبر اتصال WebSocket الدائم
  5. يسلّم WhatsApp الرسالة إلى هاتف المستلم
  6. تستقبل الواجهة تأكيد تسليم من WhatsApp وتحدّث حالة الرسالة
  7. إذا كان هناك webhook مهيأ، يُعاد توجيه تحديث الحالة إلى خادمك

يستغرق المسار بأكمله من طلبك إلى تأكيد التسليم عادةً من 1 إلى 3 ثوانٍ. وقد تستغرق تحديثات الحالة (مُسلّمة، مقروءة) وقتاً أطول اعتماداً على اتصال المستلم ووقت فتحه للرسالة.

إدارة المثيلات

يُطلق على كل رقم WhatsApp تربطه اسم "مثيل". ويمكنك إدارة عدة مثيلات من لوحة تحكم واحدة والتنقل بينها عبر الواجهة بتحديد معرّف المثيل. ولكل مثيل:

  • API key — رمز مصادقة فريد
  • Connection status — متصل أو مفصول أو قيد إعادة الاتصال
  • Phone number — رقم WhatsApp المرتبط بالمثيل
  • Webhook URL — وجهة إعادة توجيه الرسائل الواردة
  • Message history — سجل الرسائل المرسلة والمستقبلة

يمكن إنشاء المثيلات وفصلها وحذفها من لوحة التحكم أو عبر الواجهة. وعندما تفصل مثيلاً، تُنهى جلسة WhatsApp ولكن يمكنك إعادة الاتصال في أي وقت دون فقدان بياناتك.

الموثوقية والتوفر

نحافظ على اتفاقية مستوى خدمة توفر بنسبة 99.9% عبر جميع الخطط. وبنيتنا التحتية مصممة من أجل الموثوقية:

  • Automatic reconnection — إذا انقطع اتصال WebSocket، تعيد الواجهة الاتصال تلقائياً خلال ثوانٍ
  • Proxy failover — إذا واجه أحد خوادم الوكيل مشكلات، يُوجَّه المرور عبر وكيل آخر في المجمع
  • Message queuing — إذا كان اتصال WhatsApp غير متاح مؤقتاً، توضع الرسائل في قائمة انتظار وتُسلَّم عند استعادة الاتصال
  • Health monitoring — نراقب جميع المثيلات على مدار الساعة ونتعامل مع المشكلات استباقياً قبل أن تؤثر في التسليم

لا تُرجع الواجهة خطأ 503 Service Unavailable إلا عند استنفاد جميع مسارات الاتصال، وهو أمر نادر للغاية. ومن الناحية العملية، ستُسلَّم رسائلك حتى لو تعرضت مكونات فردية لانقطاعات قصيرة.

الأمان والخصوصية

جميع اتصالات الواجهة مشفّرة عبر HTTPS. وتُخزَّن مفاتيح API بشكل آمن بتجزئة bcrypt — ولا نخزّنها أبداً كنص عادي. وتُتحقق من صحة عناوين URL الخاصة بالـ webhook وتُوقَّع جميع حمولات webhook حتى تتمكن من التحقق من أنها جاءت فعلاً من خوادمنا.

لا نملك وصولاً إلى محتوى رسائلك ما لم تعِد توجيهه صراحةً عبر webhooks. وتبقى الرسائل بينك وبين عملائك خاصة. ويستخدم اتصال WhatsApp تشفيراً من الطرف إلى الطرف لطبقة نقل الرسائل.

الأسعار

تبدأ الخطط من 9.99 دولار شهرياً وتشمل عدداً محدداً من طلبات API يومياً ومثيلات وميزات. لا توجد رسوم خفية ولا رسوم لكل رسالة ولا مفاجآت تجاوز. ويمكنك الترقية أو التخفيض في أي وقت من لوحة التحكم.

نقبل العملات الرقمية وبطاقات الائتمان. وتتم معالجة المدفوعات عبر بوابات آمنة، ولا تُخزَّن معلومات الدفع الخاصة بك على خوادمنا أبداً.

حالات الاستخدام

تُستخدم واجهة WhatsApp API لدينا عبر مجموعة واسعة من الصناعات والتطبيقات. إليك بعض حالات الاستخدام الأكثر شيوعاً التي يبنيها عملاؤنا:

  • E-commerce — تأكيدات الطلبات وتحديثات الشحن وإشعارات التسليم وتحديثات حالة الإرجاع وتذكيرات سلة التسوق المتروكة
  • Healthcare — تذكيرات المواعيد وإشعارات إعادة صرف الوصفات وتسليم نتائج المختبر ومتابعات المرضى
  • Education — تأكيدات التسجيل في الدورات والمواعيد النهائية للواجبات ونتائج الامتحانات والتواصل بين أولياء الأمور والمعلمين
  • Real Estate — تنبيهات قوائم العقارات وتأكيدات المعاينات وإشعارات العروض والتواصل مع المستأجرين
  • Financial Services — تنبيهات المعاملات وتسليم الفواتير وتذكيرات الدفع وإشعارات الحساب
  • Restaurants — تأكيدات الطلبات وتذكيرات حجز الطاولات وجمع الملاحظات والعروض الترويجية
  • Logistics — تحديثات تتبع الشحنات وتأكيدات التسليم وتعيينات السائقين وإشعارات المستودعات

أي شركة تتواصل مع العملاء عبر WhatsApp يمكنها الاستفادة من أتمتة تلك المحادثات عبر الواجهة. والمفتاح هو تحديد الرسائل المتكررة والقابلة للتنبؤ — فهذه هي التي ينبغي أتمتتها.

البدء

  1. أنشئ حساباً مجانياً — يستغرق 30 ثانية
  2. اختر خطة تناسب احتياجاتك
  3. أنشئ مثيلاً من لوحة التحكم
  4. اربط رقم هاتفك عبر رمز QR أو رمز الاقتران
  5. استخدم مفتاح API لإرسال رسالتك الأولى

إذا كنت بحاجة إلى مساعدة للبدء، فراجع توثيق API أو تواصل مع فريق الدعم.

هل أنت مستعد للبناء باستخدام WhatsApp API؟

انضم إلى آلاف المطورين الذين يستخدمون واجهتنا لأتمتة المراسلة وبناء تجارب عملاء أفضل.

ابدأ مجاناً