دليل المبتدئين الكامل لواتساب Business API

ما هو WhatsApp Business API؟

WhatsApp Business API (الآن جزء من Meta Business Platform) يسمح للشركات بالتواصل مع العملاء على نطاق واسع. يوفر ميزات قوية للتواصل التجاري الحديث.

• إرسال الرسائل للعملاء على نطاق واسع
• استقبال والرد على الرسائل
• أتمتة المحادثات باستخدام chatbots
• إرسال الإشعارات (OTP، تحديثات الطلبات، إلخ)
• تشغيل إعلانات Click-to-WhatsApp

المتطلبات قبل البدء

تحتاج إلى ما يلي للبدء مع WhatsApp Business API:

1. حساب فيسبوك (Meta) Business
2. عمل موثق (موصى به)
3. رقم هاتف (لم يُستخدم على واتساب من قبل)
4. موقع إلكتروني (موصى به للموافقة)
5. معرفة برمجية أساسية (PHP، Node.js، أو Python)

اختر طريقة الإعداد

هناك طريقتان لاستخدام API:

إعداد WhatsApp Cloud API (خطوة بخطوة)

الخطوة 1: إنشاء التطبيق

1. انتقل إلى Meta Developers
2. انقر على "إنشاء تطبيق"
3. اختر "Business"
4. أضف منتج "WhatsApp"

الخطوة 2: الحصول على بيانات اعتماد API

• رمز الوصول (Access Token)
• معرف رقم الهاتف (Phone Number ID)
• معرف حساب WhatsApp Business

الخطوة 3: إضافة رقم الهاتف

قم بالتحقق من رقمك عبر SMS أو مكالمة. تأكد من أن الرقم لم يُستخدم على واتساب من قبل.

الخطوة 4: إعداد Webhook (مهم)

قم بتكوين عنوان URL للـ webhook ورمز التحقق:

سيتلقى نقطة نهاية الخادم الخاص بك الرسائل الواردة وتحديثات الحالة.

إرسال رسالتك الأولى (API)

استخدم نقطة النهاية التالية لإرسال الرسائل:

POST https://graph.facebook.com/v18.0/PHONE_NUMBER_ID/messages

يمكنك إرسال رسائل نصية وصور وفيديوهات ومستندات ورسائل تفاعلية باستخدام نقطة النهاية هذه.

استقبال الرسائل (Webhook)

عندما يرسل المستخدم رسالة، يرسل واتساب طلب POST إلى عنوان URL الخاص بك مع بيانات الرسالة.

حلل JSON الوارد لاستخراج محتوى الرسالة ومعلومات المرسل.

أنواع الرسائل التي يمكنك إرسالها

• رسائل نصية
• صور
• فيديوهات
• مستندات
• موقع
• أزرار (تفاعلية)
• رسائل قائمة

قوالب رسائل واتساب

القوالب مطلوبة لإرسال الرسائل خارج نافذة الـ 24 ساعة. انتقل إلى Meta Business Manager، أنشئ قالبًا، وأرسله للموافقة.

مثال: "مرحبًا {{1}}، طلبك جاهز" - يمكن للقوالب تضمين متغيرات للتخصيص.

إعلانات واتساب (Click-to-WhatsApp)

إعلانات Click-to-WhatsApp على فيسبوك وإنستغرام تفتح محادثات واتساب مباشرة. هذه طريقة قوية لتوليد العملاء المحتملين وبدء المحادثات.

أنشئ حملات في Ads Manager بهدف "الرسائل" واختر واتساب كوجهة.

الأتمتة (Chatbots)

ابنِ chatbots ذكية باستخدام PHP أو Node.js أو Python. أتمتة الردود على الأسئلة الشائعة وأنشئ تدفقات محادثة.

مثال: إذا كانت الرسالة تحتوي على "سعر"، أرسل معلومات التسعير تلقائيًا.

التسعير

• الفئة المجانية (محادثات محدودة)
• الدفع لكل محادثة بعد الحد
• الفئات: التسويق، الخدمات، المصادقة

أفضل الممارسات

• احصل دائمًا على موافقة المستخدم قبل المراسلة
• تجنب البريد العشوائي واحترم تفضيلات المستخدم
• استخدم القوالب بشكل صحيح واحصل على الموافقة عليها
• استجب بسرعة للحفاظ على التفاعل
• خصص الرسائل للحصول على نتائج أفضل

أخطاء شائعة

• رمز غير صالح - تحقق من رمز الوصول الخاص بك
• الهاتف غير مُحقق - أكمل التحقق
• القالب غير مُعتمد - انتظر موافقة Meta
• المستخدم لم يُنشئ اشتراكًا - احصل على الموافقة أولاً

أدوات مفيدة

• Postman (اختبار API)
• ngrok (اختبار webhook محلي)

مثال على البنية التحتية

الواجهة الأمامية (الموقع) → الخلفية (PHP API) → WhatsApp Cloud API → جهاز المستخدم

الخطوات التالية

• ابنِ chatbot
• تكامل مع CRM الخاص بك
• استخدم AI (ChatGPT) للردود الذكية
• أضف التحليلات والتتبع

الخلاصة

WhatsApp Business API قوي للتواصل مع العملاء والأتمتة والتسويق. ابدأ بـ Cloud API، اختبر الرسائل، ثم توسع مع الأتمتة والإعلانات.