اختبار العملاء المحتملين

قبل التشغيل، لنتأكد أن كل شيء يعمل بشكل مثالي! إليك طرق متعددة للاختبار.

الطريقة 1: اختبار العميل المحتمل المدمج في الوحدة (الأسهل!)

أسرع طريقة لاختبار التدفق الكامل:

1. اذهب إلى Meta Leads → Settings
2. انقر زر "Send Test Lead"
3. سيُنشأ عميل محتمل تجريبي في Perfex CRM
4. سيُسأل: "Test lead created! Would you like to view it?"
5. انقر Yes لعرضه

ماذا يختبر هذا:

• الوحدة تعمل
• إنشاء العميل المحتمل في Perfex CRM
• التعيين الافتراضي والمصدر والحالة
• تعيين الحقول للحقول القياسية

ماذا لا يختبر هذا:

• توصيل Facebook webhook
• اتصال Facebook → خادمك
• أسماء حقول نموذج Facebook الحقيقية

تلميح

استخدمه لـ فحص سريع، ثم انتقل للطريقة 2 لاختبار كامل.

الطريقة 2: أداة اختبار Lead Ads في Facebook (موصى بها!)

هذه أفضل طريقة لاختبار التدفق الكامل - من Facebook حتى CRM، دون إنفاق أي مال على الإعلانات.

خطوة بخطوة:

1. اذهب إلى: 👉 https://developers.facebook.com/tools/lead-ads-testing/

2. اختر صفحتك من القائمة المنسدلة

   • اختر الصفحة التي اشتركت فيها في الوحدة

3. اختر نموذجًا (أو أنشئ نموذج اختبار)

   • إذا لم تنشئ Lead Form بعد، ستحتاج إنشاءه أولاً في Ads Manager
   • أو أنشئ نموذج اختبار سريع (انظر أدناه)

4. انقر "Create Lead"

5. خلال ثوانٍ، تحقق من Perfex CRM:

   • اذهب إلى Leads - يفترض أن ترى عميلًا محتملًا جديدًا!
   • اذهب إلى Meta Leads → Sync History - سترى سجل المزامنة

ماذا يختبر هذا:

• كل شيء! التدفق الكامل كما في الواقع
• Facebook يرسل بيانات webhook حقيقية
• خادمك يستقبلها ويعالجها
• يُنشأ العميل المحتمل في Perfex CRM
• تعيين الحقول يعمل مع أسماء حقول Facebook الحقيقية

معلومات

هذا الاختبار قاطع. إن نجح، تعمل Lead Ads الحقيقية أيضًا.

الطريقة 3: زر Test Connection

تختبر بيانات الاعتماد والأذونات (ولكن ليس توصيل العملاء المحتملين):

1. اذهب إلى Meta Leads → Settings
2. انقر "Test Connection"
3. يفترض أن ترى:

✅ App Credentials: Valid
   App ID is configured and accessible

✅ Access Token: Valid  
   Token is valid and has access to your pages

✅ Permissions: All required permissions granted
   pages_show_list, pages_read_engagement, leads_retrieval, 
   pages_manage_ads, ads_management

تحذير

إذا ظهر أي إذن ناقصًا، أعد ربط Facebook (زر Connect with Facebook في قسم Pages).

الطريقة 4: إنشاء نموذج اختبار سريع

إذا لم يكن لديك Lead Form بعد لأداة الاختبار:

1. اذهب إلى Ads Manager
2. انقر "+ Create" → الهدف: Leads
3. أعد ad set أساسي (ميزانية، جمهور - لا يهم للاختبار)
4. في قسم الإعلان، انقر "Create Form"
5. أضف هذه الحقول الأساسية:
   • Full Name
   • Email
   • Phone Number
6. أضف رابط سياسة الخصوصية (أي رابط يعمل للاختبار)
7. احفظ النموذج (لا تحتاج نشر الحملة!)
8. ارجع إلى Testing Tool - سيظهر نموذجك في القائمة المنسدلة

التحقق من Sync History

بعد أي اختبار، تحقق من صفحة Sync History:

1. اذهب إلى Meta Leads → Sync History
2. ستجد جدولًا بكل محاولات المزامنة:

العمود	مثال	المعنى
Date/Time	2026-02-06 10:30:15	وقت استلام العميل المحتمل
Meta Lead ID	123456789	معرف العميل المحتمل الداخلي في Facebook
Perfex Lead	#42 - John Smith	العميل المحتمل المُنشأ في Perfex (مع رابط)
Status	Success	هل نجحت المزامنة
Message	Lead created successfully	تفاصيل المزامنة

أنواع الحالة:

الحالة	المعنى	ما يجب فعله
Success	تم إنشاء العميل المحتمل في Perfex	لا شيء - نجح!
Failed	حدث خطأ	راجع رسالة الخطأ
Skipped	العميل المحتمل مكرر	متوقع إن كان اكتشاف المكرر مفعّلًا
Pending	في طابور إعادة المحاولة	ستُعاد المحاولة تلقائيًا

قائمة تحقق الاختبار

نفّذ هذه القائمة للتأكد أن كل شيء يعمل:

• Test Connection - كل علامات التحقق الخضراء
• Send Test Lead - ظهور العميل المحتمل في CRM
• Facebook Testing Tool - ظهور العميل المحتمل في CRM عبر webhook
• Check Sync History - السجل يعرض "Success"
• Check the Lead - كل الحقول معيّنة بشكل صحيح
• Check Assignment - العميل المحتمل معيّن للموظف الصحيح
• Check Source - العميل المحتمل لديه المصدر الصحيح
• Check Status - العميل المحتمل لديه الحالة الأولية الصحيحة
• Email Notification - استلام البريد (إن كان مفعّلًا)

فشل الاختبار؟

لا تقلق! راجع صفحة Troubleshooting لحلول المشاكل الشائعة.

نجحت كل الاختبارات؟

تهانينا! تكامل Meta Leads مضبوط ويعمل بالكامل!

الآن يمكنك:

1. إنشاء وتشغيل حملات Lead Ad حقيقية
2. مراقبة العملاء المحتملين في Sync History
3. متابعة العملاء المحتملين في Perfex CRM
4. الاسترخاء وترك الأتمتة تعمل!

تواجه مشاكل؟ Troubleshooting