betool betool

الوثائق

Meta Lead Ads

استقبال فوري لعملاء Facebook / Instagram المحتملين في pipeline betool.

Meta Lead Ads

تربط قناة Meta Lead Ads تطبيق Facebook Business الخاص بك بـbetool، بما يتيح المعالجة الفورية للعملاء المحتملين المُقدَّمين عبر نماذج Lead Ads لديك (Facebook، Instagram).

لماذا هذه القناة

تُعالَج عملاء Meta المحتملون تقليديًا على دفعات — تُصدَّر إلى CSV، وتُستورَد إلى CRM، ثم تُؤهَّل يدويًا. والنتيجة: تأخير من 30 دقيقة إلى عدّة ساعات بين تقديم النموذج وأوّل تواصل.

وبربط Meta Lead Ads مباشرةً بـpipeline في betool، تُقلّص ذلك التأخير إلى بضع ثوانٍ — ويمكن أتمتة أوّل تواصل (بريد إلكتروني، WhatsApp، مكالمة هاتفية) بالكامل.

المتطلبات المسبقة

  • تطبيق Meta (Facebook for Developers) بصلاحية leads_retrieval.
  • صفحة Facebook معتمَدة لـLead Ads.
  • نموذج Lead Ad واحد نشط على الأقل.

الإعداد

  1. الإدارة ← Meta ← التطبيقات — اربط تطبيق Meta الخاص بك بـApp ID وApp Secret.
  2. على جانب Meta Developers، أضِف الـwebhook الذي يوفّره betool على كائن page مع الحقل leadgen.
  3. اختر الصفحة (الصفحات) المعنيّة وامنح التطبيق التصريح.
  4. على جانب betool، اربط كل نموذج بـpipeline مستهدَف.

ما يستقبله الـpipeline

لكل عميل محتمل مُقدَّم، يُنشأ exchange يحتوي على:

  • lead.full_name، lead.email، lead.phone — حقول قياسية (مُطبَّعة)
  • lead.form_fields — كل أسئلة النموذج مع إجاباتها
  • lead.form_id، lead.ad_id، lead.campaign_id — للإسناد
  • lead.created_time — الطابع الزمني من Meta (UTC)

حالة استخدام نموذجية

[facebook_leads]──▶[agent: enrich]──▶[condition: quality]
                                        ├─▶[operator: create CRM]
                                        └─▶[agent: immediate follow-up]

يستدعي وكيل الإثراء أداة التحقق من البريد الإلكتروني + operator HTTP للاستعلام من قاعدة بيانات السجلّ لديك. ويوجّه الشرط العملاء المحتملين المؤهَّلين إلى CRM، والعملاء المحتملين الساخنين إلى ردّ فوري عبر WhatsApp / البريد الإلكتروني.

القيود

  • حدود معدّل Meta — للـAPI حدود معدّل. وللأحجام الكبيرة، خطّط لوجود مخزن مؤقت.
  • الصلاحيات — يمكن لـMeta إلغاء صلاحية leads_retrieval إذا لم يكن تطبيقك مُصادَقًا عليه. اتّبع عملية App Review من Meta.
  • لا جلب رجعي — لا يسترجع betool العملاء المحتملين المُقدَّمين قبل إعداد الـwebhook. ولذلك، صدّرهم وحمّلهم عبر سكربت لمرّة واحدة.