التعريف
WhatsApp Business API هي الواجهة البرمجية من Meta التي تتيح للشركات المتوسطة والكبيرة إرسال رسائل WhatsApp واستقبالها من برمجياتها الخاصة، وعلى نطاق واسع، عبر رقم هاتف أعمال موثّق. وتُقدَّم اليوم في صورة Cloud API من Meta.
تمثّل WhatsApp Business API الجزء الموجّه للمطورين في WhatsApp Business Platform. فبدلاً من الكتابة في تطبيق على الهاتف، ترسل الشركة الرسائل عبر طلبات HTTP تحمل بيانات بصيغة JSON، وتتلقى ردود العملاء وحالات التسليم عبر Webhook. وتستضيف Meta البنية التحتية في صورة Cloud API المبنية على Graph API.
تحكم قاعدتان كل تطبيق تقريباً. الأولى: لا يجوز للشركة إرسال رسائل حرة إلا داخل نافذة خدمة العملاء البالغة 24 ساعة، والتي يفتحها العميل عندما يراسل الشركة. والثانية: خارج تلك النافذة، لا يمكنها إرسال سوى قوالب رسائل معتمدة مسبقاً، تُصنَّف إلى تسويقية أو تحديثات المعاملات أو مصادقة، وتُحتسب تكلفتها عن كل رسالة مسلَّمة.
تصل الشركات عادةً إلى API عبر شريك مثل مزوّد حلول الأعمال (BSP)، الذي يتولى التسجيل (غالباً عبر Embedded Signup)، والفوترة، ودعم الامتثال، والأدوات مثل صندوق الوارد الموحّد أو مدير الحملات. وتظل الشركة مالكة لحساب WhatsApp Business ورقم الهاتف.
في دول الخليج ومنطقة الشرق الأوسط وشمال أفريقيا عموماً، يُعدّ WhatsApp قناة رئيسية للتواصل مع العملاء لدى البنوك وتجار التجزئة وشركات الطيران والخدمات الحكومية، لذا تُستخدم API على نطاق واسع لتحديثات الطلبات والتوصيل، وتذكيرات المواعيد، ورموز OTP، ودعم العملاء بالعربية والإنجليزية.
من الأخطاء الشائعة التعامل مع API كأنها رسائل SMS جماعية. فالرسائل تحتاج إلى موافقة مسبقة (opt-in)، ويجب أن تتوافق القوالب مع فئاتها، ويؤدي ضعف التفاعل إلى انخفاض تقييمات الجودة، ما قد يوقف القوالب مؤقتاً ويُبطئ رفع حدود المراسلة.
مثال
POST https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages with {"messaging_product":"whatsapp","to":"971501234567","type":"template","template":{"name":"order_shipped","language":{"code":"en"}}}