مقالات

شرح WhatsApp Business API: الوصول، والقوالب، والتكاليف، والربط بـCRM

WhatsApp Business API هو الطريقة الرسمية التي توفّرها Meta لربط رقم ببرنامج بدلًا من هاتف. إليك ما تحتاج إليه، وكم يكلّف، وما الذي يتغير في العمل اليومي.

باختصار: WhatsApp Business API، الذي يُقدَّم اليوم في صورة Cloud API، هو الواجهة الرسمية من Meta التي تتيح للبرامج إرسال رسائل WhatsApp واستقبالها لرقم تجاري. تحتاج إلى حافظة أعمال (business portfolio) في Meta، وتطبيق، ورقم هاتف باسم معروض، وقوالب معتمدة لكل ما تُرسله خارج نافذة الـ24 ساعة التي تلي آخر رسالة من العميل. وتحاسب Meta على كل رسالة مسلَّمة بحسب الفئة والبلد؛ أما رسائل العملاء إليك فمجانية. ويربط NeuroCRM واجهة Cloud API يدويًا برموزك الخاصة، وتتوفر فيه أيضًا بوابة GREEN-API.

ما WhatsApp Business API؟

هو واجهة برمجية، لا تطبيق. فلا تنزّله على جهازك، ولا توجد شاشة تسجّل الدخول إليها. برنامجك (نظام CRM، أو نظام دعم فني، أو سكربت كتبته بنفسك) يتواصل مع WhatsApp من خلالها: الرسائل الواردة تصل إلى عنوان webhook، والردود تخرج كاستدعاءات API.

والواجهة التي توثّقها Meta اليوم هي Cloud API، وتستضيفها Meta بنفسها. وحين يبحث الناس عن «whatsapp api» أو «api of whatsapp» أو «whatsapp cloud api»، أو بالعربية «واتساب API»، فهذا ما يقصدونه. أما «WhatsApp Business Platform» فهو الاسم الأوسع الذي تطلقه Meta على خدماتها لمراسلة الأعمال، وCloud API هي الواجهة داخل هذه المنصة.

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

ما الفرق بين تطبيق WhatsApp Business وWhatsApp Business Web وAPI؟

  • تطبيق WhatsApp Business. تطبيق للهاتف يقول WhatsApp إنه صُمّم مع مراعاة احتياجات أصحاب الأعمال الصغيرة. نشاط تجاري واحد، وفي العادة شخص واحد يكتب الردود.
  • WhatsApp Business Web. عبارة البحث التي يستخدمها الناس حين يريدون فتح الحساب التجاري نفسه في المتصفح. وهي تبقى نافذة الدردشة الخاصة بالتطبيق، لا تكاملًا: لا شيء فيها مرتبط بالصفقات أو المهام أو التقارير.
  • WhatsApp Business API (Cloud API). واجهة برمجية. يُسجَّل الرقم على المنصة، ويتولى المحادثات برنامج لا هاتف.

إن كان كل ما تحتاجه الرد على عدد قليل من الناس من حاسوبك المحمول، فقد يكفيك التطبيق ونسخته للمتصفح. وانتقل إلى API حين يتقاسم عدة موظفين الرقم، أو حين يجب أن تُرسَل الرسائل تلقائيًا، أو حين يجب أن تنتقل المحادثات إلى CRM.

من يستطيع الحصول على الوصول، وماذا تحتاج؟

يطلب دليل البدء من Meta حسابًا على Facebook أو حساب Meta مُدارًا (managed Meta account)، والتسجيل كمطوّر، وجهازًا عليه WhatsApp لرسائل الاختبار. وفي الخطوات نفسها تختار حافظة أعمال في Meta (business portfolio) أو تنشئها، وتنشئ تطبيقًا بحالة الاستخدام WhatsApp، وتضيف رقم هاتف.

وللرقم قواعد، بحسب وثائق Meta الخاصة بأرقام الهواتف:

  • لا يمكن تسجيل رقم مستخدم بالفعل مع WhatsApp إلا بعد حذفه من WhatsApp أولًا.
  • يجب أن يكون الرقم ملكك، وأن يتضمن رمز البلد ورمز المنطقة، وأن يستقبل رسالة SMS أو مكالمة صوتية للتحقق.
  • الاسم المعروض (display name) مطلوب عند التسجيل، ويظهر في ملف الرقم على WhatsApp.

لا تحتاج إلى قوالب لبدء الاختبار: فدليل البدء السريع من Meta نفسها يرسل قالبًا جاهزًا اسمه hello_world. أما قوالبك المعتمدة فتحتاج إليها حين تبدأ أنت بالكتابة، أو حين ترد بعد أن تُغلق النافذة.

كيف تعمل نافذة الـ24 ساعة؟

حين يراسلك العميل أو يتصل بك، تُفتح نافذة مدتها 24 ساعة، وكل رسالة جديدة منه تعيد عدّها من البداية. وما دامت مفتوحة يمكنك إرسال رسائل حرة. وبعد أن تُغلق، لا يُسمح إلا برسائل القوالب (كما تنص صفحة الأسعار لدى Meta).

وتنقسم القوالب إلى ثلاث فئات: التسويق (marketing)، والإشعارات الخدمية (utility)، والمصادقة (authentication). تنشئها في WhatsApp Manager، وتراجعها Meta؛ فاحسب حساب فترة انتظار قبل أن يعمل أي قالب جديد.

كيف تحاسب Meta على WhatsApp Business API؟

بحسب صفحة الأسعار لدى Meta، كما راجعناها في 18 نوفمبر 2026:

  • تحاسب Meta على كل رسالة مسلَّمة، لا على كل محادثة، منذ 1 يوليو 2025. ويتوقف السعر على فئة الرسالة ورمز الاتصال الدولي لبلد المستلم.
  • لا تُحتسب رسوم على الرسائل التي يرسلها إليك العملاء.
  • القوالب إما تسويقية أو إشعارات خدمية أو مصادقة؛ أما الردود الحرة داخل النافذة فهي رسائل خدمة (service). وتذكر Meta أيضًا فئة Meta Business Agent.
  • يحصل كل رقم هاتف تجاري على 1,000 رسالة خدمة مجانية شهريًا، تتجدد كل شهر. وابتداءً من 1 أكتوبر 2026 تُحتسب رسوم على رسائل الخدمة بدءًا من الرسالة رقم 1,001.
  • إن لم تكن في حساب المراسلة وسيلة دفع، فلا توصل Meta رسائل الخدمة إلا ضمن الشريحة المجانية.
  • قوالب الإشعارات الخدمية المرسلة داخل نافذة مفتوحة كانت مجانية حتى 30 سبتمبر 2026، وتُحتسب رسومها ابتداءً من 1 أكتوبر 2026.
  • إن راسلك عميل من إعلان Click to WhatsApp في تطبيق الجوال ورددت عليه داخل النافذة، تُفتح نافذة دخول مجانية لمدة تصل إلى 7 أيام لرسائل التسويق والإشعارات الخدمية والمصادقة والخدمة.

أما الأسعار بالدولار فموجودة في ملفات جداول الأسعار (rate cards) التي تربطها Meta من تلك الصفحة، وتختلف بحسب البلد والفئة. راجع الملف الخاص ببلدانك قبل أن تضع ميزانيتك؛ فنحن لا نذكر هنا أي سعر.

وتُقيَّد رسوم Meta على حساب WhatsApp الذي تربطه. أما مزوّد CRM أو أي برنامج آخر فيتقاضى رسومه الخاصة فوق ذلك.

هل أستطيع إرسال رسائل تسويقية وتشغيل روبوتات عبره؟

نعم، ضمن قواعد Meta: فالقوالب التسويقية فئة من الرسائل لها سعرها الخاص، والروبوت برنامج يستخدم الواجهة نفسها وتسري عليه قواعد النافذة والقوالب نفسها.

وعبارة «WhatsApp API send message» (إرسال رسالة عبر WhatsApp API) تعني عمليًا نوعين من الاستدعاء: رسالة حرة داخل النافذة، أو رسالة من قالب خارجها. ووقت آخر رسالة من العميل هو الذي يحدد أيهما متاح.

كيف يتصل NeuroCRM بـWhatsApp Business API؟

يدعم NeuroCRM طريقتين لربط WhatsApp. ولمقارنة أوسع بينهما، راجع WhatsApp CRM: الواجهة الرسمية أم بوابات QR. أما هذه الصفحة فتشرح جانب API بالتفصيل.

ربط Cloud API يدويًا

من الإعدادات ← عمليات التكامل تختار WhatsApp Business Cloud API وتملأ أربعة حقول:

  1. معرف رقم الهاتف (Phone Number ID) من شاشة API Setup في Meta.
  2. رمز الوصول الدائم (مستخدم النظام) (Permanent Access Token)، الذي تُنشئه في Business Settings ← System Users.
  3. سر التطبيق (App Secret)، ويُستخدم للتحقق من توقيع الـwebhooks الواردة.
  4. معرف حساب واتساب للأعمال (WABA ID).

ثم اضغط «التحقق والاتصال». يعرض لك NeuroCRM عنوان URL للرد (Callback URL) ورمز التحقق (Verify Token)؛ فتلصقهما في تطبيقك على Meta ضمن WhatsApp ← Configuration ← Webhooks، وتشترك في الحقل messages. ويمكنك إضافة عدة أرقام.

لا يوجد زر واحد يتولى ذلك كله. أنت من ينشئ تطبيق Meta ومستخدم النظام والرمز، فتوقّع أن يستغرق الربط الأول بعض الوقت، وجهّز جانب Meta قبل أن تبدأ.

ما الذي يراه الموظفون

تصل كل محادثة WhatsApp إلى صندوق الوارد نفسه الذي يضم قنواتك الأخرى، مع بطاقة جهة الاتصال. ويحسب NeuroCRM الـ24 ساعة من أحدث رسالة WhatsApp حقيقية أرسلها العميل، ويعدّ النافذة مغلقة قبل موعدها بخمس دقائق.

وحين تكون النافذة مغلقة، يرسل NeuroCRM قالبًا معتمدًا بدلًا من نصك: القالب الذي اخترته، أو القالب الافتراضي لمساحة العمل، أو قالبًا معتمدًا بلا متغيرات ولا وسائط. وتبقى مسودتك في حقل الكتابة في انتظار رد العميل. وإن لم يوجد قالب معتمد، يُرفض الإرسال، ولا يُرسَل قالب ثانٍ قبل أن يرد العميل إلا إذا اخترته من القائمة من جديد.

القواعد والأتمتة والذكاء الاصطناعي

  • الأتمتة. خارج النافذة لا ترسل الأتمتة شيئًا، ولا تختار قالبًا: تُعلَّم الخطوة بأنها لم تُرسَل. وفي أحداث الصفقات تذهب الرسالة إلى أقدم محادثة لجهة الاتصال، أيًا كانت قناتها.
  • تسلسلات المبيعات. خطوة WhatsApp فيها ترسل القالب المعتمد الذي تحدد اسمه في تلك الخطوة.
  • ردود الذكاء الاصطناعي. مركز الاتصال العصبي إضافة مدفوعة: $200 شهريًا إضافةً إلى $0.50 لكل حوار ناجح، بمفتاح الذكاء الاصطناعي الخاص بك بهامش 0% أو عبر NeuroCRM بزيادة +20%. وخارج نافذة الـ24 ساعة لا يرد ولا يرسل قالبًا. ولا يحجز المواعيد بنفسه.

البديل: GREEN-API

GREEN-API بوابة غير رسمية. تربط رقمًا شخصيًا برمز QR في لوحة تحكم GREEN-API، ثم تُدخل idInstance وapiTokenInstance في NeuroCRM. ويقول تلميح التكامل نفسه إنها «تناسب الحالات التي لا يتوفر فيها WhatsApp Business API الرسمي». وهي ليست منصة Meta، فقواعد القوالب والنافذة المشروحة أعلاه لا تصف طريقة عملها.

ما الذي لا يفعله NeuroCRM مع WhatsApp Business API؟

  • لا ربط بنقرة واحدة. تُدخَل بيانات اعتماد Meta يدويًا؛ ولا يُقدَّم مسار Embedded Signup من Meta في صورة زر.
  • لا استخدام مشترك للرقم (coexistence). الرقم المستخدم في الوقت نفسه في تطبيق WhatsApp Business وفي API لا يعمل عبر NeuroCRM.
  • رسوم Meta على الرسائل ليست جزءًا من سعر المقعد، ولا يحددها NeuroCRM؛ فـMeta تحاسب الحساب الذي تربطه.
  • لا اختيار تلقائي للقالب من الأتمتة أو من الذكاء الاصطناعي خارج نافذة الـ24 ساعة.

كم يكلّف تشغيل WhatsApp في NeuroCRM؟

تكلّف المقاعد $13 لكل مستخدم شهريًا، أو $10.40 حين تدفع عن سنة كاملة، ولا توجد خطة مجانية. والفترة التجريبية البالغة 14 يومًا تشمل كل شيء لعدد غير محدود من المستخدمين، ثم تصبح مساحة العمل للقراءة فقط. راجع الأسعار. ومركز الاتصال العصبي هو الإضافة المنفصلة المذكورة أعلاه. أما رسوم Meta على كل رسالة فبند ثالث تحاسبك عليه Meta.

وللمقارنة بين الأنظمة، راجع مقارنات NeuroCRM ودليل بدائل Kommo. ولترى WhatsApp إلى جانب قنواتك الأخرى، راجع صندوق الوارد الموحد.

قائمة تحقق: قبل أن تربط الرقم

  1. اختر رقمًا تملكه وتستطيع أن تستقبل عليه رسالة SMS أو مكالمة للتحقق. وإن كان مستخدمًا في WhatsApp، فخطّط لحذفه من هناك أولًا.
  2. أنشئ حافظة الأعمال في Meta، والتطبيق بحالة الاستخدام WhatsApp، ومستخدم نظام برمز دائم.
  3. اختر الاسم المعروض.
  4. أضف وسيلة دفع في جانب Meta، وإلا فلن تصل رسائل الخدمة التي تتجاوز الشريحة المجانية.
  5. قدّم قالبًا واحدًا على الأقل من فئة الإشعارات الخدمية (utility) في WhatsApp Manager، وانتظر موافقة Meta قبل الإطلاق.
  6. دوّن معرف رقم الهاتف (Phone Number ID) ومعرف الحساب (WABA ID) من شاشة API Setup.
  7. اربط الرقم في NeuroCRM، وانسخ عنوان URL للرد ورمز التحقق إلى Meta، واشترك في messages.
  8. أرسل رسالة إلى نفسك ورد عليها، ثم انتظر حتى تُغلق النافذة واختبر قالبًا.

الأسئلة الشائعة

هل WhatsApp Business API مجاني؟

ليس بالكامل. تحاسب Meta على كل رسالة مسلَّمة، باستثناء رسائل العملاء، وأول 1,000 رسالة خدمة لكل رقم شهريًا، والرسائل داخل نافذة الدخول المجانية.

ما الفرق بين WhatsApp API وCloud API؟

في الإعداد الجديد هما عمليًا الشيء نفسه: Cloud API هي النسخة التي تستضيفها Meta وتوثّقها، وهي ما يستخدمه تكامل WhatsApp Business Cloud API في NeuroCRM.

هل أستطيع استخدام رقم تطبيق WhatsApp Business مع API؟

تقول Meta إن الرقم المستخدم بالفعل مع WhatsApp يجب حذفه من WhatsApp قبل التسجيل. وعبر NeuroCRM لا يعمل استخدام رقم واحد في التطبيق وفي API معًا (coexistence).

لماذا لم تصل رسالتي إلى العميل؟

هناك سببان شائعان: كانت نافذة الـ24 ساعة قد أُغلقت ولم تكن الرسالة قالبًا، أو لم تكن في حساب Meta وسيلة دفع بعد نفاد رسائل الخدمة المجانية. وفي النافذة المغلقة لا يرسل NeuroCRM نصك العادي؛ بل يرسل أولًا قالبًا معتمدًا ويحتفظ بنصك في حقل الكتابة.

هل يستطيع عدة أشخاص الرد من رقم API واحد؟

نعم. المحادثات الواردة إلى رقم واحد تذهب إلى صندوق وارد مشترك في NeuroCRM، ويمكنك ربط عدة أرقام.

المصادر

  • Meta، أسعار WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (تاريخ المراجعة: 18 نوفمبر 2026)
  • Meta، البدء مع Cloud API — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (تاريخ المراجعة: 18 نوفمبر 2026)
  • Meta، أرقام الهواتف — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (تاريخ المراجعة: 18 نوفمبر 2026)
  • تطبيق WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (تاريخ المراجعة: 18 نوفمبر 2026)

كيف أُعدّت هذه المقالة: كتبها فريق NeuroCRM بمساعدة الذكاء الاصطناعي، وطابقنا ما ورد فيها عن المنتج مع شيفرة NeuroCRM ووثائق المساعدة، وأخذنا الأسعار من قائمة الأسعار المنشورة في تاريخ التحديث.