WhatsApp API: الأساسيات

ما هي WhatsApp Business API؟

الخلاصة: تتيح WhatsApp Business API (المعروفة رسميًا باسم "WhatsApp Business Platform") للشركات المتوسطة والكبيرة إرسال رسائل WhatsApp واستقبالها آليًا — عبر CRM أو مكتب مساعدة أو لوحة تحكم — بدلًا من تطبيق الهاتف. وعلى عكس WhatsApp Business App المجاني، لا تتضمن واجهة مدمجة، وتدعم عدة وكلاء والأتمتة، وتُحتسب تكلفتها لكل رسالة بدلًا من كل تنزيل. واعتبارًا من 2025، تعمل حصريًا عبر Cloud API من Meta؛ إذ أُوقِف العمل بواجهة On-Premises API الأقدم.

WhatsApp Business App مقارنةً بـ WhatsApp Business API

تبدأ معظم الشركات باستخدام WhatsApp Business App المجاني، ثم تتجاوز إمكاناته. إليك الفرق الفعلي:

إذا كنت تفوّت الرسائل بانتظام لأن أكثر من شخص يحتاج إلى الرد، أو إذا أردت تشغيل إرسال الرسائل تلقائيًا من نظام للطلبات أو الحجوزات، فقد حان وقت الانتقال إلى API. تعرّف على كيفية إدارة صندوق الوارد المشترك في Chakra لهذه الرسائل.

كيف تعمل WhatsApp Business API فعليًا

لا يوجد تطبيق لتنزيله. وبدلًا من ذلك، تسير العملية على النحو التالي:

1. تنشئ أنت (أو مزوّد الخدمة) تطبيقًا على Meta وتربطه بحساب WhatsApp Business (WABA) عبر لوحة تطبيقات Meta.
2. تتحقق من نشاطك التجاري عبر Meta Business Manager وتسجّل رقم هاتف — ولا يعود بإمكان هذا الرقم تشغيل WhatsApp Business App المخصّص للمستهلكين أيضًا، إلا إذا استخدمت WhatsApp Coexistence.
3. ترسل الرسائل عبر Cloud API من Meta، إما بكتابة استدعاءات API مباشرة أو، وهو الخيار الأكثر شيوعًا بكثير، عبر لوحة تحكم لمزوّد حلول الأعمال (BSP) مثل Chakra، الذي يتولى الجانب التقني نيابةً عنك.
4. هناك نوعان من الرسائل يحددان ما يمكنك إرساله: إذا راسلك العميل أولًا، فستتاح لك مهلة 24 ساعة للرد بأي محتوى. أما إذا أردت بدء المحادثة، فيجب استخدام قالب رسالة.

للاطلاع على خطوات الإعداد الدقيقة للمطورين (إنشاء التطبيق، ورموز الوصول، وخطافات الويب)، يشرح دليل البدء من Meta كيفية التسجيل كمطوّر، وإنشاء تطبيق على Meta، وإرسال رسالتك الأولى. احفظ هذا الدليل إذا كان فريقك سينفذ التكامل بنفسه بدلًا من الاستعانة بمزوّد BSP.

يختلف مسار الإعداد مع Chakra — فلا حاجة إلى كتابة أي رمز. اتبع دليل الإعداد المكوّن من 3 خطوات لربط رقمك وإرسال أول رسالة جماعية.

Cloud API مقارنةً بـ On-Premises API — لقد تغيّر هذا الأمر

تصف الأدلة القديمة (بما فيها النسخة السابقة من هذه الصفحة) الاختيار بين Cloud API من Meta وواجهة On-Premises API تستضيفها بنفسك. لم يعد هذا الاختيار متاحًا. أوقفت Meta واجهة On-Premises API في أكتوبر 2023، وأُوقِف العمل بها نهائيًا في 23 أكتوبر 2025 — ولم يعد بإمكانها إرسال الرسائل أو استقبالها. وتعمل جميع عمليات تكامل WhatsApp Business API اليوم، سواء طُوّرت داخليًا أو عبر مزوّد BSP، باستخدام Cloud API.

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

الأسعار: ما الذي تغيّر في 2025

كانت الأسعار تُحتسب وفق فترات «المحادثة» التي تبلغ مدتها 24 ساعة. وقد أُلغي هذا النموذج. فمنذ 1 يوليو 2025، تحتسب WhatsApp الرسوم مقابل كل قالب رسالة مُرسل، وليس مقابل كل محادثة، وذلك ضمن ثلاث فئات:

• التسويق — العروض الترويجية، والخصومات، وإعادة التفاعل. أعلى تكلفة لكل رسالة.
• المرافق — تحديثات الطلبات، وإشعارات التوصيل، وتنبيهات الحساب.
• المصادقة — رموز OTP والتحقق من تسجيل الدخول.

هناك تغييران آخران يجدر معرفتهما: رسائل الخدمة (الردود ضمن نافذة الـ24 ساعة التي يبدأها العميل) مجانية منذ نوفمبر 2024، كما أصبحت قوالب المرافق المُرسلة خلال نافذة خدمة مفتوحة مجانية منذ أبريل 2025. تختلف الأسعار الدقيقة لكل رسالة بحسب بلد المستلِم وتتغير دوريًا — راجع بطاقة الأسعار الحالية لدى Meta بدلًا من الاعتماد على رقم ثابت في أي منشور مدونة، بما في ذلك هذا المنشور. للاطلاع على تفصيل كامل بحسب الفئة والمنطقة، راجع دليلنا المخصص للأسعار والرسوم.

لا تضيف Chakra أي هامش ربح على رسوم الرسائل القالبية — فأنت تدفع سعر Meta كما هو، دون أي إضافات.

ما الذي يمكنك فعله بها فعليًا؟

• تحديثات الطلبات والتوصيل تُرسل تلقائيًا من متجرك أو نظام CRM
• دعم متعدد الوكلاء حيث يتشارك فريق كامل رقمًا واحدًا دون فقدان سياق المحادثات — تعرّف على صندوق الوارد المشترك للفريق من Chakra
• روبوتات الدردشة والتدفقات الآلية للأسئلة الشائعة وتأهيل العملاء المحتملين وتغطية أوقات ما بعد الدوام — تعرّف على منشئ روبوتات الدردشة من Chakra
• حملات البث للعملاء الذين وافقوا على تلقي الرسائل، من أجل العروض والتذكيرات وإعادة التفاعل
• رسائل الكتالوج والتجارة ليتمكن العملاء من التصفح والشراء داخل المحادثة — تعرّف على كتالوج WhatsApp والتجارة
• المصادقة — رموز OTP وتأكيد تسجيل الدخول، وغالبًا ما تكون أقل تكلفة وأسرع في الوصول من الرسائل النصية القصيرة SMS

مفاهيم خاطئة شائعة

«تحتاج إلى مطوّر لاستخدامها.» ليس عند استخدام BSP. تتطلب API الخام كتابة التعليمات البرمجية؛ أما لوحة تحكم مثل Chakra فتتولى الجوانب التقنية، بحيث يرسل فريقك الرسائل بالطريقة نفسها التي يستخدم بها أي أداة دعم.

«تحل محل رقم WhatsApp الحالي لديك.» ليس بالضرورة — تتيح لك ميزة التعايش في WhatsApp تسجيل رقمك الحالي لاستخدام API مع مواصلة استخدام تطبيق المستهلك إلى جانبه.

«إنها مخصصة للمؤسسات الكبيرة فقط.» لا تفرض API نفسها حدًا أدنى لحجم النشاط التجاري. ما يحدد حاجتك إليها هو حجم الرسائل وحجم الفريق، لا حجم الشركة — ففريق دعم من شخصين يتعامل مع أكثر من 60 محادثة يوميًا يتجاوز قدرات التطبيق بالسرعة نفسها التي تتجاوز بها المؤسسة الكبيرة قدراته.

«يستغرق الإعداد أسابيع.» عادةً ما يكون التحقق من النشاط التجاري عبر Meta أطول خطوة، وحتى هذه الخطوة أصبحت أسرع. وباستخدام التسجيل المضمّن عبر BSP، يستغرق ربط الرقم دقائق لا أسابيع.

البدء

1. اربط رقمك عبر التسجيل المضمّن
2. أنشئ أول قالب رسالة لك
3. أعدّ صندوق الوارد المشترك للفريق أو روبوت دردشة

للمزيد من القراءة: شرح حسابات WhatsApp Business (WABA) · الامتثال والسياسات والموافقة · مسرد مصطلحات WhatsApp API

المصادر: Meta for Developers — دليل البدء, إشعار إيقاف API المحلية, وثائق الأسعار. آخر تحقق من الصفحة: أغسطس 2026.