واجهة WhatsApp Cloud API: دليل المبتدئين للطبقة المجانية

تبدو واجهة WhatsApp Cloud API مخيفة، لكن الفكرة الأساسية بسيطة: إنها الطريقة المجانية الاستضافة من ميتا لإرسال واستقبال رسائل واتساب من برمجيّاتك الخاصة. يشرح هذا الدليل ما هي، وما المجاني فيها حقاً، وكيف ترسل رسالتك الأولى — دون مصطلحات معقّدة.

ما هي واجهة Cloud API فعلياً

واجهة WhatsApp Cloud API جزء من منصّة واتساب للأعمال. بدلاً من كتابة الرسائل يدوياً في هاتف، ترسل أنظمتك الرسائل وتستقبلها برمجياً. تستضيفها ميتا في السحابة، فلا تشغّل أي خادم واتساب بنفسك — تغيير جوهري عن الواجهة القديمة المستضافة محلياً (on-premise).

تُشغّل الأمور التي لا يستطيع تطبيق واتساب للأعمال المجاني فعلها:

تأكيدات الطلبات الآلية، وتحديثات الشحن، والتذكيرات.
صندوق وارد مشترك يتعامل فيه عدة وكلاء مع المحادثات من رقم واحد.
روبوتات الدردشة وتكاملات إدارة علاقات العملاء/مكتب المساعدة.
التسويق على نطاق واسع للمستخدمين الموافِقين.

إذا كنت تحتاج فقط إلى محادثات واردة من رابط، فلا حاجة لهذا — يكفي رابط wa.me من مولّد روابط واتساب المجاني. واجهة Cloud API للأتمتة والتوسّع.

الاستضافة المجانية مقابل المراسلة المجانية — لا تخلط بينهما

يختلط أمران "مجانيان" مختلفان:

الاستضافة مجانية. على خلاف الواجهة القديمة المستضافة محلياً، تستضيف ميتا واجهة Cloud API دون مقابل. لا خوادم لاستئجارها.
المراسلة لها طبقة مجانية بالإضافة إلى استخدام مدفوع. يفوتِر واتساب لكل محادثة (نافذة 24 ساعة)، مع محادثات مجانية وأخرى مدفوعة حسب الفئة.

حدث تحوّل كبير في 2025: أصبحت محادثات الخدمة التي يبدأها المستخدم مجانية — عندما يراسلك عميل وترد ضمن نافذة الخدمة، لا يُفوتَر ذلك عادةً. أما الفئات التي يبدأها العمل مثل التسويق و(في كثير من الحالات) الخدمات/المصادقة فمدفوعة. تتغيّر المخصّصات والأسعار الدقيقة وتختلف حسب البلد، لذا تأكّد دائماً من الأسعار الحالية في وثائق تسعير ميتا بدلاً من الوثوق برقم ثابت.

فئات المحادثات بعبارات بسيطة

تدور الفوترة حول فئات المحادثات:

الخدمة (Service) — يبدأ العميل المحادثة؛ ترد ضمن نافذة 24 ساعة. مجانية إلى حدٍّ كبير منذ تغيير 2025.
التسويق (Marketing) — تروّج بشكل استباقي (عروض، إطلاقات). مدفوعة، وتتطلّب موافقة + قوالب معتمَدة.
الخدمات (Utility) — تحديثات معاملات مرتبطة بإجراء (تم شحن الطلب، تذكير بموعد). تستخدم قوالب؛ يختلف التسعير.
المصادقة (Authentication) — رموز المرور لمرة واحدة والتحقّق. تستخدم قوالب.

القاعدة العامة: ردود الخدمة التي يبدأها العميل هي المسار الرخيص/المجاني؛ والتسويق الذي يبدأه العمل هو المسار المدفوع.

رسائل الجلسة مقابل رسائل القوالب

ضمن نافذة الخدمة 24 ساعة (بعد أن يراسلك المستخدم)، يمكنك إرسال رسائل حرّة الصياغة.
خارج تلك النافذة، أو لبدء محادثة، يجب أن ترسل رسالة قالب معتمَدة مسبقاً. القوالب تمنع الأعمال من إرسال سبام بارد للمستخدمين.

ما تحتاجه للبدء

لإرسال رسالتك الأولى ستُعِدّ:

حساب أعمال ميتا (فيسبوك).
تطبيق منصّة واتساب للأعمال في لوحة مطوّري ميتا.
رقم هاتف مسجَّل على المنصّة (يُوفَّر رقم تجريبي للبدء).
بيانات اعتماد الواجهة — رمز مميّز ومعرّف رقم هاتفك.

توفّر ميتا رقماً تجريبياً ومخصّصاً صغيراً كي تجرّب قبل الإطلاق الفعلي.

إرسال رسالتك الأولى (شكلها العام)

بمجرد الإعداد، يكون الإرسال طلب HTTP إلى واجهة Graph API من ميتا. مفاهيمياً:

POST https://graph.facebook.com/v22.0/${PHONE_NUMBER_ID}/messages
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "972541234567",
  "type": "text",
  "text": { "body": "Hello from the Cloud API!" }
}

لمراسلة شخص لم يحادثك أولاً، استبدِل type: "text" برسالة template تشير إلى قالب معتمَد. استبدِل ${PHONE_NUMBER_ID} و${ACCESS_TOKEN} بقيمك الخاصة، وانتبه إلى أن إصدار الواجهة (v22.0 هنا) يتغيّر بمرور الوقت.

استقبال الرسائل: الـ webhooks

تصل الرسائل الواردة عبر webhook — رابط تستضيفه أنت وتستدعيه ميتا كلما راسلك مستخدم. تتحقّق من الـ webhook مرة واحدة، ثم تنشر ميتا أحداث الرسائل إليه. هكذا "تسمع" الروبوتات وصناديق الوارد المشتركة العملاء.

هل ينبغي للمبتدئ استخدامها؟

اسأل سؤالين:

هل أحتاج إلى أتمتة أو صندوق وارد لفريق؟ إن لا، فالزم تطبيق واتساب للأعمال المجاني.
هل أرسِل على نطاق واسع لمستخدمين موافِقين؟ إن نعم، فواجهة Cloud API هي المسار المتوافق.

يصل كثير من الأعمال الصغيرة إلى واجهة Cloud API عبر مزوّد حلول أعمال (Business Solution Provider) (مثل Twilio أو 360dialog أو MessageBird) أو أداة بلا برمجة (no-code)، تخفي معظم الواجهة الخام. لمسار بلا برمجة، راجع أتمتة واتساب عبر Zapier و Make، ولتخطيط التكلفة، أسعار WhatsApp Business API.

أهم النقاط

الاستضافة مجانية؛ والمراسلة لها طبقة مجانية بالإضافة إلى فئات مدفوعة.
محادثات الخدمة التي يبدأها المستخدم مجانية إلى حدٍّ كبير منذ 2025.
التسويق/الخدمات/المصادقة تستخدم قوالب معتمَدة وهي عادةً مدفوعة.
المبتدئون الذين لا حاجة لهم بالأتمتة لا يحتاجون الواجهة إطلاقاً — يغطّي رابط wa.me المحادثات الواردة.

ابدأ ببساطة برابط واتساب مجاني وترقَّ إلى واجهة Cloud API حين تفرض الأتمتة ذلك.