تهيئة Webhooks

الآن سنخبر Facebook أين يرسل بيانات العملاء المحتملين. هذا يُسمى "webhook" - إنه مثل إعطاء Facebook عنوان بريد نظام CRM الخاص بك.

ما هو Webhook؟

ببساطة:

شخص يملأ نموذج العملاء المحتملين على Facebook/Instagram
         ↓
Facebook يقول: "لدي عميل محتمل جديد!"
         ↓
Facebook يرسل بيانات العميل المحتمل إلى عنوان URL الخاص بـ webhook
         ↓
وحدتك تستلمها وتنشئ العميل المحتمل في Perfex CRM

Webhook هو ببساطة عنوان URL على خادمك يرسل Facebook البيانات إليه. الوحدة تنشئ هذا العنوان تلقائياً - تحتاج فقط لإخبار Facebook عنه.

احصل على تفاصيل Webhook من Perfex

قبل الذهاب إلى Facebook، لنحصل على التفاصيل من وحدتك:

1. سجّل الدخول إلى Perfex CRM
2. انتقل إلى Meta Leads → Settings في الشريط الجانبي
3. أولاً، أدخل App ID وApp Secret (من الخطوة 1) وانقر على Save Settings
4. انزل لأسفل إلى قسم Webhook Settings
5. سترى قيمتين:

الحقل	مثال	ما هو
Webhook Callback URL	https://yourcrm.com/facebookleadsintegration/webhook	أين يرسل Facebook البيانات
Verify Token	a1b2c3d4e5f6g7h8i9j0	رمز سري للتحقق من الاتصال

6. انقر على زر Copy بجانب كل قيمة

تحذير

عنوان Callback URL يجب أن يبدأ بـ https:// - Facebook يتطلب SSL! إذا كان عنوانك يبدأ بـ http://، تحتاج لتثبيت شهادة SSL أولاً.

إضافة Webhooks لتطبيق Meta

1. افتح لوحة تحكم تطبيق Meta

انتقل إلى تطبيقك على:

👉 https://developers.facebook.com/apps/

انقر على تطبيقك لفتحه.

2. أضف منتج Webhooks

1. في الشريط الجانبي الأيسر، ابحث عن "Add Product" أو انزل لأسفل في لوحة التحكم
2. ابحث عن "Webhooks" في قائمة المنتجات
3. انقر على "Set Up" أو "Configure"

تلميح

إذا كنت ترى بالفعل "Webhooks" في الشريط الجانبي الأيسر، انقر عليه مباشرة - لا حاجة لإضافته مرة أخرى.

3. حدد "Page" كنوع الكائن

1. في صفحة Webhooks، سترى قائمة منسدلة تقول "User" بشكل افتراضي
2. غيّر هذه القائمة المنسدلة إلى "Page"

تحذير

هذا حاسم! يجب أن تحدد "Page" - ليس "User"، ليس "Application"، ليس أي شيء آخر. بيانات العملاء المحتملين تأتي عبر اشتراكات الصفحة.

4. اشترك في Webhook

1. انقر على زر "Subscribe to this object" (أو "Edit Subscription" إذا كان مُهيّأ بالفعل)
2. سيظهر مربع حوار يطلب قيمتين:

الحقل	ما تدخله
Callback URL	الصق عنوان Webhook URL من الوحدة (مثال: https://yourcrm.com/facebookleadsintegration/webhook)
Verify Token	الصق Verify Token من الوحدة

3. انقر على "Verify and Save"

5. ماذا يحدث عند النقر على "Verify and Save"

سيرسل Facebook فوراً طلب تحقق إلى عنوان webhook URL:

Facebook: "هل هذا فعلاً خادمك؟"
وحدتك: "نعم! إليك رمز التحقق لإثبات ذلك!"
Facebook: "رائع، تم التحقق!"

إذا نجح: سترى رسالة نجاح ويُغلق مربع الحوار.

إذا فشل: انظر قسم استكشاف الأخطاء للإصلاحات الشائعة.

6. اشترك في أحداث "leadgen"

بعد التحقق، تحتاج لإخبار Facebook ما الأحداث التي يرسلها:

1. سترى قائمة بأنواع الأحداث تحت اشتراكات "Page"
2. ابحث عن "leadgen" في القائمة (قد تحتاج للتمرير)
3. انقر على زر التبديل/مربع الاختيار "Subscribe" بجانب "leadgen"

تلميح

"leadgen" هو الحدث الوحيد الذي تحتاجه. لا تحتاج للاشتراك في أي أحداث أخرى (مثل "messages" أو "feed"). فقط "leadgen".

التحقق ناجح!

يجب أن تبدو تهيئة webhook الآن هكذا:

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verified
└── Subscriptions:
    └── ✅ leadgen (subscribed)

مرة أخرى في وحدة Perfex CRM، يجب أن يعرض مؤشر حالة webhook الآن أخضر/تم التحقق!

كيفية اختبار Webhook

تريد التأكد من أن webhook يعمل؟

1. انتقل إلى Perfex CRM → Meta Leads → Settings
2. انقر على زر "Test Connection"
3. يجب أن ترى جميع علامات الصح خضراء

سنجري اختباراً أكثر شمولاً لاحقاً في قسم اختبار العملاء المحتملين.

أخطاء شائعة يجب تجنبها

الخطأ	الإصلاح
اختيار "User" بدلاً من "Page"	غيّر القائمة المنسدلة إلى "Page"
نسيان الاشتراك في "leadgen"	ابحث عن "leadgen" في القائمة واشترك
استخدام HTTP بدلاً من HTTPS	ثبّت شهادة SSL على خادمك
خطأ إملائي في Callback URL	انسخ والصق مباشرة من إعدادات الوحدة
"Callback URL couldn't be validated"	تحقق من استكشاف الأخطاء

تم تهيئة Webhook؟ ربط صفحاتك