🚀 دليل تكامل QUALI-D مع WhatsApp API

انتقل إلى Meta للمطورين وسجل الدخول.

1. انقر "تطبيقاتي" (My Apps)
2. انقر "إنشاء تطبيق" (Create App)
3. اختر "الأعمال" (Business)
4. انقر "التالي" (Next)

املأ معلومات التطبيق:

• اسم التطبيق: استخدم اسم عملك
• البريد الإلكتروني: بريدك الإلكتروني للأعمال
• انقر "التالي" (Next) للمتابعة

اختر كيف تخطط لاستخدام تطبيق Meta:

1. اختر "التواصل مع العملاء عبر واتساب"
2. انقر "التالي" (Next)

اختر أو أنشئ محفظة أعمال:

• اختر محفظة أعمال موجودة إذا كان لديك واحدة
• أو انقر "إنشاء محفظة أعمال جديدة" (تعلم كيفية إنشاء واحدة)
• انقر "التالي" (Next)

راجع إعدادك في صفحة النظرة العامة:

1. راجع جميع المعلومات التي أدخلتها
2. تأكد من صحة كل شيء
3. انقر "الذهاب إلى لوحة التحكم" (Go To Dashboard) لإكمال الإعداد

من لوحة تحكم تطبيقك:

1. ابحث عن قسم "App customization and requirements"
2. انقر "تخصيص حالة الاستخدام للتواصل مع العملاء عبر واتساب"
3. سيتم نقلك إلى صفحة تخصيص حالة الاستخدام

تكوين إعدادات WhatsApp Business Platform:

1. اقرأ وانقر "قبول شروط الخدمة" (Accept Terms of Service) لـ WhatsApp Business Platform
2. تحت "WhatsApp Business Platform"، يجب أن تكون محفظة أعمالك محددة مسبقاً
3. راجع الملاحظة حول الحصول على رقم اختبار (بحد أقصى 5 أرقام)
4. انقر "متابعة" (Continue) في الأسفل

مرحباً بك في إعداد WhatsApp Business Platform:

1. سترى "مرحباً بك في WhatsApp Business Platform"
2. اقرأ عن إرسال واستقبال الرسائل باستخدام Cloud API
3. تحت "API Setup"، انقر "بدء استخدام الـ API" (Start using the API)
4. سينقلك هذا إلى صفحة تكوين الـ API

في صفحة API Setup، سترى تكوين الاختبار الخاص بك. ستحتاج إلى إدخال معرف رقم الهاتف هذا في لوحة تحكم QUALI-D:

1. انتقل إلى "Step 1: Select phone numbers"
2. تحت قسم "From"، سترى رقم هاتف اختبار
3. ابحث عن "Phone number ID:" مع معرف رقمي أسفله
4. انقر زر النسخ بجوار معرف رقم الهاتف
5. احفظ هذا المعرف - ستقوم بإدخاله في لوحة تحكم QUALI-D ضمن إعدادات WhatsApp
6. لاحظ أيضاً "WhatsApp Business Account ID" - ستحتاجه لإنشاء الرمز

أنشئ مستخدم نظام للحصول على رمز دائم:

1. اذهب إلى "إعدادات الأعمال" (Business Settings)
2. اختر "مستخدمو النظام" (System Users)
3. انقر "إضافة" (Add)
4. أعطه اسماً (مثال: "WhatsApp Integration")
5. اضبط الدور "Admin"
6. انقر "إنشاء" (Create)

1. انقر مستخدم النظام الجديد
2. انقر "Add Assets"
3. اختر "Apps"
4. اختر تطبيقك
5. فعّل "Manage App"
6. انقر "حفظ" (Save)

1. انقر "Generate New Token"
2. اختر تطبيقك
3. اختر الأذونات: whatsapp_business_management, whatsapp_business_messaging, whatsapp_business_templates, business_management
4. اضبط انتهاء الصلاحية "Never"
5. انقر "Generate"
6. انسخ فوراً! لن تراه مرة أخرى
7. أدخل هذا الرمز في لوحة تحكم QUALI-D ضمن إعدادات WhatsApp مع معرف رقم الهاتف

قبل تكوين webhooks في Meta، تحتاج للحصول على رابط الـ webhook ورمز التحقق من لوحة تحكم QUALI-D الخاصة بك:

1. اذهب إلى لوحة تحكم QUALI-D الخاصة بك
2. انتقل إلى إعدادات WhatsApp
3. أدخل رمز الوصول ومعرف رقم الهاتف اللذين نسختهما سابقاً
4. النظام سيقوم تلقائياً بإنشاء رابط Webhook فريد ورمز التحقق من أجلك
5. انسخ كلاً من رابط الـ Webhook ورمز التحقق - ستحتاجهما للخطوة التالية

الآن قم بتكوين الـ webhook في تطبيق Meta WhatsApp الخاص بك:

1. عد إلى لوحة تحكم تطبيق Meta على developers.facebook.com
2. اختر تطبيقك واذهب إلى WhatsApp > Configuration
3. في قسم Webhook، انقر "تعديل" (Edit)
4. الصق رابط الـ Webhook من لوحة تحكم QUALI-D
5. الصق رمز التحقق من لوحة تحكم QUALI-D
6. انقر "التحقق والحفظ" (Verify and Save)
7. اشترك في حقول webhook: messages، message_status