شرح واجهة واتساب Cloud API
واجهة واتساب Cloud API هي نسخة واجهة منصة واتساب للأعمال التي تستضيفها Meta نيابةً عنك. يرسل برنامجك الرسائل بطلبات HTTPS، ويستقبل الردود وحالات الرسائل عبر Webhook. أوقفت Meta واجهة On-Premises الأقدم في 23 أكتوبر 2025، فصار كل من يستخدم الواجهة يعمل على Cloud API.
بقلم موسى الحلو, مؤسس E-SAFQA · آخر تحديث · 7 دقائق قراءة · كيف نكتب هذه الأدلة ونختبرها
ما هي واجهة واتساب Cloud API؟
واجهة واتساب Cloud API هي الواجهة التي تستضيفها Meta لمنصة واتساب للأعمال. يستدعيها مطوّر، أو مزوّد حلول يبني التكامل لك، عبر HTTPS ومن خلال Graph API لإرسال رسائل نصية ووسائط ورسائل تفاعلية من رقم أعمال. وتصل الردود وتحديثات حالة الرسائل إلى رابط Webhook تتحكم به أنت. أنت لا تشغّل أي خادم لواتساب بنفسك، ولهذا تصفها مدونة Meta للمطورين بأنها Cloud API المستضافة لدى Meta.
وهي منتج للمطورين وليست تطبيقاً جاهزاً: لا يوجد صندوق وارد ولا لوحة تحكم إلا إذا بناها لك مطوّر أو مزوّد. لذلك يصل كثير من المتاجر إلى Cloud API عبر مزوّد حلول أعمال (BSP) أو عبر تطبيق مبني عليها.
ماذا حدث لواجهة On-Premises؟
قبل Cloud API كان بإمكان الشركة استضافة عميل On-Premises الخاص بواتساب على خوادمها. أوقفته Meta على مراحل، وتذكر صفحة الإيقاف لديها التواريخ التالية (راجعناها في أكتوبر 2026).
- إن كان مزوّدك أو تكاملك القديم ما زال يتحدث عن استضافة On-Premises، فاسأل هل جرى نقله إلى Cloud API.
| التاريخ | ما الذي تغيّر |
|---|---|
| 9 يناير 2024 | لا تُطرح الميزات الجديدة إلا على Cloud API. أما عميل On-Premises فيتلقى إصلاحات الأخطاء والتحديثات الأمنية فقط. |
| 1 يوليو 2024 | صار تسجيل أرقام الأعمال الجديدة ممكناً على Cloud API فقط. ومحاولة تسجيل رقم على On-Premises تُرجع رمز الخطأ 1005. |
| 23 أكتوبر 2025 | انتهت صلاحية آخر نسخة من On-Premises. لم يعد بإمكانها إرسال الرسائل، ولا تُسلَّم الرسائل الصادرة من الأرقام المسجلة عليها أو الواردة إليها. |
ما الذي تحتاجه لبدء استخدام Cloud API؟
يعدّد دليل البدء لدى Meta المتطلبات كما هي في أكتوبر 2026: حساب فيسبوك أو حساب Meta مُدار، والتسجيل كمطوّر، ومحفظة أعمال (Business Portfolio)، وجهاز عليه واتساب لاستقبال رسائل الاختبار. وهذه خطواته الرئيسية.
- أنشئ تطبيق Meta بحالة الاستخدام الخاصة بواتساب من لوحة تطبيقات Meta، واربطه بمحفظة أعمالك.
- اربط حساب واتساب وحساب مراسلة (Messaging account). تستخدم وثائق Meta الأحدث هذين المصطلحين؛ ويحتفظ حساب المراسلة بقوالب الرسائل وبيانات الفوترة، ويحدده الآن معرّف WABA القديم.
- أرسل رسالة اختبار من رقم الاختبار باستخدام رمز وصول مؤقت.
- أعدّ Webhook ليصل إلى خادمك ما يستجد من حالات الرسائل وردود العملاء.
- أنشئ مستخدم نظام (System User) ورمز وصول دائماً بصلاحيتي whatsapp_business_messaging وwhatsapp_business_management.
- سجّل رقم أعمالك الخاص وأعطه اسم عرض. الرقم المستخدم حالياً على واتساب يجب حذفه أولاً، إلا إذا ربطته عبر ميزة التعايش (Coexistence) التي توفرها Meta لمستخدمي تطبيق واتساب للأعمال.
كيف تعمل الرسائل والحدود في Cloud API؟
تذكر Meta ثلاث طرق لرفع الحد الابتدائي من 250 إلى 2,000: توثيق نشاطك التجاري، أو أن يوثّقه شريك، أو تسليم 2,000 رسالة قالب عالية الجودة خلال 30 يوماً. وتُفتح الشرائح الأعلى (10,000 ثم 100,000 ثم غير محدود) تلقائياً مع تحسّن الجودة والاستخدام.
| القاعدة | ما توثّقه Meta |
|---|---|
| موافقة العميل | لا يجوز أن تراسل إلا من وافق على تلقي رسائل نشاطك. |
| نافذة خدمة العملاء | عندما يراسلك العميل تُفتح نافذة مدتها 24 ساعة وتتجدد مع كل رسالة جديدة منه. داخلها تستطيع إرسال رسائل خدمة بنص حر. |
| رسائل القوالب | خارج النافذة لا تستطيع إرسال إلا قوالب معتمدة مسبقاً من فئات Marketing أو Utility أو Authentication. |
| حد المراسلة | عدد العملاء الفريدين الذين تراسلهم خارج نافذة الخدمة خلال 24 ساعة متحركة، ويُحدَّد لكل محفظة أعمال. تبدأ المحافظ الجديدة عند 250. |
| سرعة الإرسال | يرسل رقم الأعمال حتى 80 رسالة في الثانية افتراضياً، ويمكنك طلب المزيد. |
كم تكلّف واجهة واتساب Cloud API؟
تحاسب Meta على كل رسالة مسلَّمة. ومنذ 1 يوليو 2025 صار التسعير لكل رسالة بدل المحادثة، ويعتمد السعر على فئة الرسالة (Marketing أو Utility أو Authentication أو Service) وعلى رمز دولة المستلم. والسعودية من الأسواق المسمّاة في بطاقة أسعار Meta، فتُحاسَب الرسائل إلى الأرقام ذات رمز الدولة 966 بسعرها الخاص (راجع /ar/blog/whatsapp-api-saudi-arabia-pricing). ولا تحاسب Meta على الرسائل التي يرسلها العملاء إلى النشاط التجاري.
ومنذ 1 أكتوبر 2026 تُحتسب أيضاً ردود الخدمة داخل نافذة الـ 24 ساعة. وتذكر صفحة التسعير لدى Meta شريحة مجانية قدرها 1,000 رسالة خدمة لكل رقم أعمال شهرياً. ويضيف المزوّدون رسوم منصتهم فوق ذلك، وهي غير مدرجة في بطاقة أسعار Meta. وللاطلاع على الأسعار الحالية ومثال محسوب، راجع دليلنا للأسعار على /ar/blog/whatsapp-business-api-pricing-explained.
Cloud API أم تطبيق واتساب للأعمال أم تطبيق بجهاز مرتبط؟
| Cloud API | تطبيق واتساب للأعمال | تطبيق بجهاز مرتبط (واتساب بايلوت) | |
|---|---|---|---|
| من يبني التجربة | مطوّر أو مزوّد | واتساب، كتطبيق مجاني | واتساب بايلوت، تطبيق شوبيفاي من E-SAFQA |
| الرقم | رقم أعمال مسجّل على الواجهة | رقمك داخل التطبيق | رقمك الحالي، يُربط بمسح رمز QR |
| رسوم Meta لكل رسالة | نعم، لكل رسالة مسلَّمة | لا توجد | لا توجد |
| القوالب | مطلوبة خارج نافذة الـ 24 ساعة | لا تُستخدم | نص حر تعدّله في التطبيق |
| حالة التسليم والقراءة | تصل عبر Webhook | تظهر في التطبيق | غير متاحة مع الجهاز المرتبط |
| الأنسب لـ | الحجم الكبير والحملات وتعدد الموظفين والبوتات | شخص واحد يرد على المحادثات | متجر واحد يرسل رسائل الطلبات من رقمه |
هل يحتاج متجر شوبيفاي إلى Cloud API؟
ليس دائماً. إن كنت تحتاج حجماً كبيراً، وقوالب معتمدة، وحالات التسليم والقراءة، أو بوت محادثة، فـ Cloud API هي الأساس المناسب، وعادةً عبر مزوّد. أما إن كان المتجر يريد أساساً تأكيدات الطلبات وإشعارات الشحن وتذكيرات قائمة على موافقة العميل من رقم واتساب الذي يعرفه عملاؤه، فتطبيق الجهاز المرتبط أبسط.
يربط واتساب بايلوت، وهو تطبيق شوبيفاي من E-SAFQA، رقم واتساب الخاص بك كجهاز مرتبط بمسح رمز QR. لا توجد واجهة WhatsApp Business API ولا رسوم من Meta لكل رسالة، وخطة Pro بـ 15 دولاراً كل 30 يوماً. والمقابل أن إيصالات التسليم والقراءة غير متاحة. التفاصيل على /ar/how-it-works/whatsapp-connection.
الأسئلة الشائعة
ما هي واجهة واتساب Cloud API؟
هي واجهة تستضيفها Meta لمنصة واتساب للأعمال. يرسل البرنامج إليها الرسائل عبر HTTPS ويستقبل الردود وتحديثات الحالة عبر Webhook، من دون أن يشغّل خوادم واتساب بنفسه.
هل واجهة Cloud API مجانية؟
لا. تحاسب Meta على كل رسالة مسلَّمة حسب الفئة والدولة، ويضيف المزوّدون رسوم المنصة. ومنذ 1 أكتوبر 2026 تُحتسب ردود الخدمة أيضاً بعد شريحة مجانية قدرها 1,000 رسالة لكل رقم شهرياً.
ماذا حدث لواجهة On-Premises؟
أوقفت Meta إضافة الميزات إليها في يناير 2024، وأغلقت التسجيلات الجديدة في 1 يوليو 2024، وأنهت الدعم في 23 أكتوبر 2025. وتعمل أرقام الأعمال الآن على Cloud API.
هل يمكنني استخدام Cloud API وتطبيق واتساب للأعمال معاً على الرقم نفسه؟
فقط عبر ميزة التعايش (Coexistence) من Meta، وتُفعَّل أثناء الربط. وغير ذلك يجب حذف الرقم المستخدم على واتساب قبل تسجيله في Cloud API.
هل أحتاج إلى توثيق النشاط التجاري لاستخدام Cloud API؟
يمكنك البدء من دونه. تذكر Meta أن التوثيق إحدى طرق رفع حد المراسلة من 250 إلى 2,000 عميل خلال 24 ساعة، وأن حالة الحساب التجاري الرسمي تتطلبه.
جاهز لتشغيل واتساب في متجرك؟
ابدأ بالزر المجاني، وارتقِ إلى Pro للحصول على رسائل الطلبات والشحن واسترجاع السلات وأكواد تكرار الشراء وزر المنتج الذكي وتنبيهات عودة المخزون وصفحة «الطلب على المنتجات».