ربط واتساب Cloud API خطوة بخطوة، وكم يكلّف فعلاً في السعودية والخليج
شرح عملي لربط واتساب الرسمي (Cloud API) من Meta، مع طريقة حساب التكلفة بعد تغييرات أكتوبر 2026: رسوم كل رسالة، أول 1000 رسالة خدمة مجانية، والفوترة بالريال.
أكثر سؤالين يصلانني من أصحاب المتاجر والعيادات والشركات في السعودية والخليج: كيف أربط واتساب بنظامي بطريقة رسمية؟ وكم سأدفع شهرياً؟ الإجابة تغيّرت أكثر من مرة خلال السنتين الأخيرتين، وآخر تغيير مهم بدأ في 1 أكتوبر 2026. هذا المقال يشرح نموذج التسعير الحالي كما تنشره Meta، ثم خطوات الربط من الصفر.
أولاً: ما الذي تدفع مقابله بالضبط؟
منذ 1 يوليو 2025 تحاسب Meta على كل رسالة يتم توصيلها، وليس على "المحادثة" كما كان سابقاً. السعر يعتمد على أمرين: فئة الرسالة ودولة المستلم (رقم سعودي، إماراتي، وهكذا).
الفئات الأربع:
- تسويق (Marketing): عروض، تذكير بسلة متروكة، إعلان منتج جديد. هذه الأغلى عادة.
- خدمات (Utility): تأكيد طلب، إشعار شحن، تذكير موعد. رسائل مرتبطة بعملية قام بها العميل.
- مصادقة (Authentication): رموز التحقق لمرة واحدة (OTP).
- خدمة العملاء (Service): ردودك الحرة (بدون قالب) على عميل راسلك.
الفئات الثلاث الأولى تُرسل عبر قوالب يجب أن تعتمدها Meta مسبقاً، ويمكن إرسالها في أي وقت. أما رسائل الخدمة فهي ردود عادية لا تحتاج قالباً.
نافذة الـ24 ساعة
عندما يراسلك العميل (أو يتصل بك) تُفتح "نافذة خدمة العملاء" لمدة 24 ساعة. داخل هذه النافذة فقط يمكنك الرد برسائل حرة. بعد انتهائها لا يمكنك مراسلة العميل إلا بقالب معتمد.
ما الذي تغيّر في 1 أكتوبر 2026؟
بحسب صفحة التسعير الرسمية لدى Meta:
- رسائل الخدمة لم تعد مجانية بالكامل. كل رقم واتساب تابع لنشاطك يحصل على 1000 رسالة خدمة مجانية شهرياً، لا تُرحّل للشهر التالي، ويبدأ الحساب من الرسالة رقم 1001.
- رسائل الخدمات (Utility) داخل النافذة المفتوحة أصبحت مدفوعة. كانت مجانية منذ يوليو 2025، والآن تُحتسب بالسعر العادي.
- رُفعت أسعار رسائل التسويق للسعودية والإمارات و"باقي الشرق الأوسط". وكانت Meta قد رفعت سعر التسويق في السعودية أيضاً في أبريل 2026.
- الجهات الحكومية وغير الربحية المؤهلة تبقى رسائل الخدمة لها مجانية حتى 31 ديسمبر 2027.
الفوترة بالريال السعودي
منذ 1 أبريل 2026 أضافت Meta الريال (SAR) كعملة فوترة. انتبه: العملة تُحدد عند إنشاء الحساب ولا يمكن تغييرها لاحقاً إلا عبر واجهات ترحيل العملة. إذا كانت شركتك سعودية وتريد فواتير بالريال، اختر ذلك من البداية.
استثناءان يخفضان التكلفة
- إعلانات "انقر لمراسلة واتساب": إذا راسلك العميل من إعلان Click to WhatsApp تُفتح نافذة مجانية قد تصل إلى 7 أيام، لا تحاسبك فيها Meta على رسائل التسويق أو الخدمات أو المصادقة أو الخدمة.
- شرائح الحجم: رسائل الخدمات والمصادقة يقل سعرها كلما زاد عدد ما ترسله شهرياً في نفس الدولة، والحساب على مستوى محفظة الأعمال كاملة ويبدأ من جديد كل شهر.
كيف تحسب فاتورتك الشهرية؟
المعادلة بسيطة:
التكلفة = (رسائل التسويق × سعر التسويق)
+ (رسائل الخدمات × سعر الخدمات)
+ (رسائل المصادقة × سعر المصادقة)
+ (max(0, رسائل الخدمة − 1000) × سعر الخدمة)لاحظ أن الرسائل المرسلة فقط هي التي تُحسب. ما يرسله العميل لك لا تدفع عليه.
مثال توضيحي: موقع ChatMaxima (مزوّد خدمة، وليس Meta) ينشر لأرقام السعودية بدءاً من 1 أكتوبر 2026 هذه الأسعار: تسويق 0.2159 ريال، خدمات 0.0401 ريال، مصادقة 0.0401 ريال، خدمة 0.0401 ريال. لم أستطع مطابقتها مع ملف Meta مباشرة، لذلك استخدمها للتقدير فقط. متجر يرسل شهرياً 3000 تأكيد طلب و2000 رسالة عروض، ويرد على 1500 رسالة عملاء:
| البند | الحساب | التقدير |
|---|---|---|
| خدمات (تأكيد الطلبات) | 3000 × 0.0401 | ≈ 120 ريال |
| تسويق (العروض) | 2000 × 0.2159 | ≈ 432 ريال |
| خدمة (الردود) | (1500 − 1000) × 0.0401 | ≈ 20 ريال |
| المجموع | ≈ 572 ريال |
واضح من المثال أن رسائل التسويق هي ما يحدد الفاتورة. إذا أردت تخفيضها، ركّز على استهداف من يتفاعل فعلاً بدلاً من الإرسال للجميع.
رسوم المزوّد منفصلة
إذا اشتركت عبر مزوّد (BSP) أو منصة دردشة، فغالباً تدفع اشتراكاً شهرياً لهم فوق رسوم Meta، وأحياناً رسوم تفعيل أو هامشاً على سعر الرسالة. أما إذا ربطت Cloud API مباشرة من Meta، فأنت تدفع رسوم الرسائل لـ Meta فقط، وتتحمل أنت (أو مطوّرك) استضافة الـ Webhook.
خطوات الربط الرسمي من الصفر
1. محفظة أعمال Meta باسم شركتك
أنشئ Meta Business Portfolio (Business Manager سابقاً) باسم شركتك أنت، وبحساب مسؤول تملكه أنت. أكبر مشكلة أراها في الحسابات الجاهزة: الحساب والرقم مسجّلان باسم الوكالة أو المبرمج، وعند الخلاف يخسر صاحب العمل رقمه وسجل قوالبه.
2. تطبيق مطوّر وإضافة منتج WhatsApp
من developers.facebook.com أنشئ تطبيقاً من نوع Business، واربطه بالمحفظة، ثم أضف منتج WhatsApp. ستحصل على رقم تجريبي يمكنه مراسلة حتى 5 أرقام تضيفها يدوياً، مع رمز وصول مؤقت صالح لـ 24 ساعة. هذا كافٍ لتجربة كل شيء قبل الدفع.
3. رقمك الحقيقي
أضف رقم شركتك وتحقق منه برسالة أو اتصال. الرقم يجب ألا يكون مسجلاً على تطبيق واتساب العادي، إلا إذا استخدمت ميزة "التعايش" (Coexistence) الرسمية التي تسمح بربط رقم تطبيق WhatsApp Business بالـ API مع بقاء التطبيق يعمل. اختر اسم العرض بعناية لأنه يخضع لمراجعة Meta.
4. رمز وصول دائم
الرمز المؤقت ينتهي خلال 24 ساعة، لذلك أنشئ مستخدم نظام (System User) في المحفظة، وأعطه صلاحية على حساب واتساب، وأنشئ له رمزاً بصلاحيتي whatsapp_business_messaging وwhatsapp_business_management. احفظ الرمز في مدير أسرار، لا داخل الكود.
5. الـ Webhook
هذا هو العنوان الذي ترسل إليه Meta الرسائل الواردة وحالات التسليم:
- عند التسجيل ترسل Meta طلب GET فيه
hub.modeوhub.verify_tokenوhub.challenge. تحقق أن الرمز يطابق ما أدخلته، ثم أعد قيمةhub.challengeكما هي. - كل طلب POST بعدها يحمل ترويسة
X-Hub-Signature-256، وهي توقيع SHA256 للمحتوى بمفتاح App Secret. تحقق منها دائماً، وإلا يستطيع أي أحد إرسال رسائل مزيفة لنظامك. - احفظ معرّف كل رسالة وتجاهل المكرر، لأن Meta تعيد الإرسال إذا لم يصلها رد سريع.
6. القوالب ووسيلة الدفع
أنشئ قوالبك (تأكيد طلب، تذكير موعد) واختر الفئة الصحيحة. Meta قد تعيد تصنيف القالب إذا رأت أن محتواه تسويقي. ثم أضف وسيلة دفع، فبدونها قد تتوقف رسائل الخدمة بعد أول 1000 رسالة مجانية.
7. حدود الإرسال
المحافظ الجديدة تبدأ بحد 250 مستخدماً فريداً خلال 24 ساعة للرسائل التي تبدأها أنت خارج نافذة الخدمة، ويرتفع الحد تلقائياً مع الاستخدام الجيد. الحد مشترك بين كل أرقام المحفظة، والردود داخل نافذة الخدمة لا تُحتسب منه.
أخطاء شائعة تكلّف أكثر من الرسائل نفسها
- إرسال عروض تسويقية بقالب مصنّف "خدمات" لتوفير المال. Meta تراجع التصنيف وقد تعيد تصنيف القالب، والأهم أن الشكاوى تخفض تقييم جودة رقمك.
- ترك الرمز المؤقت في الإنتاج، فيتوقف كل شيء بعد يوم.
- عدم التحقق من التوقيع، وهي ثغرة أمنية حقيقية.
- اختيار عملة الفوترة الخطأ عند إنشاء الحساب.
الخلاصة
واتساب Cloud API ليس مجانياً، لكنه متوقع التكلفة إذا فهمت الفئات: الخدمات والمصادقة رخيصة نسبياً، والتسويق هو البند الأكبر، وأول 1000 رد خدمة شهرياً مجانية لكل رقم. ابدأ بالرقم التجريبي، واحسب تكلفتك بالمعادلة أعلاه من جدول Meta الرسمي، واحرص أن يكون كل شيء باسم شركتك.
المصادر
- Meta: Pricing on the WhatsApp Business Platform (نموذج التسعير، تغييرات أكتوبر 2026، عملة SAR، شرائح الحجم، نافذة FEP)
- WhatsApp Business: جدول الأسعار حسب الدولة
- Meta: Messaging limits
- Meta: WhatsApp Cloud API Get Started
- Meta: Getting started with Webhooks (التحقق و X-Hub-Signature-256)
- ChatMaxima: أسعار واتساب API في السعودية (مصدر غير رسمي، استُخدم للمثال فقط)
تحتاج من ينفّذ هذا عنك؟
خدمة
أربط واتساب الرسمي (Cloud API) بموقعك أو نظامك
مراجعة ملكية الحساب والفوترة لتكون باسمك، Webhook آمن مع التحقق من التوقيع ومنع التكرار، ورسائل قوالب معتمدة. خدمة بسعر ثابت على خمسات، التسليم خلال 3 أيام.
حزمة جاهزة
حزمة Webhook لواتساب Cloud API مع قائمة تدقيق الملكية
Webhook بـ TypeScript بدون اعتماديات مع 13 اختباراً، ومرسل قوالب، وسكربت تدقيق للقراءة فقط، وقائمة تدقيق من 60 بنداً بالعربية والإنجليزية.