إنتقل إلى المحتوى الرئيسي

مصادر العملاء المحتملين — دليل الإعداد

يمكن لـ LeadHub استقبال العملاء المحتملين من 19 مصدرًا مختلفًا. تعمل معظم المصادر عبر webhook — تلصق رابطًا تولّده LeadHub في المنصة الخارجية ويتدفق العملاء المحتملون تلقائيًا.

كيف تعمل كل مصادر Webhook​

  1. انتقل إلى التكاملات ← مصادر العملاء المحتملين وأنشئ اتصالًا جديدًا.
  2. اختر نوع المصدر وهيّئ تعيين الحقول.
  3. انسخ رابط Webhook الوارد المولَّد.
  4. الصق الرابط في المنصة الخارجية.
  5. اختبر بإرسال عميل محتمل تجريبي — سيظهر في مساحة عملك خلال ثوانٍ.

إعلانات Facebook للعملاء المحتملين (Meta)​

تتيح إعلانات Facebook للعملاء المحتملين إرسال نموذج داخل Facebook/Instagram دون مغادرة التطبيق.

أزالت Meta خيار "Other" لتكامل CRM

لم تعد Meta توفر خيار Other ضمن CRM Integration في نماذج العملاء المحتملين، لذا لم يعد بالإمكان لصق رابط webhook على مستوى النموذج. اربط بدلًا من ذلك عبر OAuth وwebhook على مستوى التطبيق، كما هو موضح أدناه.

الخطوة 1 — تهيئة تطبيق Meta الخاص بك​

أنشئ (أو افتح) تطبيقًا من نوع Business على developers.facebook.com:

  1. أضف منتج Facebook Login.

  2. App Settings ← Basic ← App Domains: أضف نطاق LeadHub الخاص بك (مثل crm.example.com).

  3. Facebook Login ← Settings ← Valid OAuth Redirect URIs: أضف

    https://YOUR-DOMAIN/oauth/meta/callback

    يجب أن يطابق هذا الرابط قيمة APP_URL في تثبيتك تمامًا، بما في ذلك https.

تلميح

إضافة النطاق ورابط إعادة التوجيه تُصلح أيضًا الخطأ "Can't load URL. The domain of this URL isn't included in the app's domains."

الخطوة 2 — الربط في LeadHub​

  1. انتقل إلى اتصالات مصادر العملاء المحتملين وأضف اتصال Meta.
  2. أدخل App ID وApp Secret.
  3. انقر Connect via OAuth، ووافق على الأذونات المطلوبة، واختر صفحتك.
  4. يخزّن LeadHub رمز وصول الصفحة (Page access token) في الاتصال تلقائيًا.

الخطوة 3 — إعداد Webhook الخاص بـ leadgen (على مستوى تطبيق Meta)​

يحل هذا محل خيار "Other" الذي أُزيل من مستوى النموذج:

  1. في App Dashboard ← Webhooks، اختر كائن Page.
  2. اشترك في حقل leadgen.
  3. Callback URL وVerify Token: انسخهما من شاشة اتصال Meta في LeadHub.
  4. اشترك بصفحتك.

يتدفق العملاء المحتملون الجدد الآن تلقائيًا — تُرسل Meta كل عميل محتمل إلى webhook، ويجلب LeadHub تفاصيل العميل الكاملة من Graph API باستخدام رمز وصول الصفحة الخاص بك.

الأذونات ومراجعة التطبيق (App Review)​

يطلب اتصال OAuth النطاقات التالية: leads_retrieval، pages_show_list، pages_read_engagement، pages_manage_ads.

تتطلب هذه الأذونات اجتياز Meta App Review + Business Verification قبل أن تعمل مع حسابات غير مسؤولي التطبيق (Admins) أو مطوريه (Developers) أو مختبريه (Testers).

للاختبار قبل الموافقة، اختر أحد الخيارين:

  • أضف نفسك بصفة Admin / Developer / Tester في تطبيق Meta، أو
  • الصق Page Access Token (مولَّدًا من Graph API Explorer الخاص بـ Meta مع صلاحية leads_retrieval) في حقل Page Access Token في الاتصال — يقرأ LeadHub العملاء المحتملين به مباشرةً.

مثال على تعيين الحقول​

حقل Facebookحقل LeadHub
full_namefirst_name
emailemail
phone_numberphone

بدلًا من ذلك، استخدم Zapier أو n8n كجسر إذا كنت بحاجة إلى مزيد من التحكم في الحمولة.

Instagram​

تشترك إعلانات Instagram للعملاء المحتملين في بنية Meta Ads نفسها. اتبع الخطوات الواردة في قسم Facebook أعلاه.

TikTok Lead Generation​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← TikTok Lead Generation.
  2. انسخ Webhook URL.
  3. في TikTok Ads Manager ← Assets ← Lead Generation ← Webhook: الصق الرابط.
  4. أرسل عميلًا محتملًا تجريبيًا للتحقق.

LinkedIn Lead Gen Forms​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← LinkedIn Lead Gen Forms.
  2. انسخ Webhook URL.
  3. في LinkedIn Campaign Manager ← Account Assets ← Lead Gen Forms ← Integrations: الصق الرابط.

WhatsApp Business​

الإعداد عبر WhatsApp Business API​

  1. أنشئ اتصالًا بـ النوع ← WhatsApp Business.
  2. انسخ Webhook URL.
  3. في Meta Business ← WhatsApp ← Configuration ← Webhooks: اضبط Callback URL وVerify Token.

Telegram​

خطوات الإعداد​

  1. أنشئ بوتًا عبر @BotFather وانسخ Bot Token.
  2. في LeadHub، أنشئ اتصالًا بـ النوع ← Telegram.
  3. أدخل Bot Token — يُسجّل LeadHub webhook تلقائيًا.

Viber​

خطوات الإعداد​

  1. أنشئ حسابًا تجاريًا Viber واحصل على Bot Token.
  2. في LeadHub، أنشئ اتصالًا بـ النوع ← Viber وأدخل الرمز.

Twitter / X​

الإعداد عبر Zapier (موصى به)​

  1. في Zapier، أنشئ Zap: Trigger ← Twitter ← New Direct Message.
  2. Action ← Webhooks by Zapier ← POST إلى LeadHub Webhook URL.

Snapchat Lead Ads​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← Snapchat Lead Ads وانسخ Webhook URL.
  2. في Snapchat Ads Manager: الصق الرابط.

Pinterest Lead Ads​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← Pinterest Lead Ads وانسخ Webhook URL.
  2. في Pinterest Ads Manager: الصق الرابط أو استخدم Zapier.

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← Google Ads Lead Forms وانسخ Webhook URL.
  2. في Google Ads ← Lead Form Extension ← Edit ← Webhook integration: الصق الرابط.

YouTube Lead Forms​

تعمل YouTube Lead Forms بنفس طريقة Google Ads Lead Form Extensions. اتبع الخطوات أعلاه.

Microsoft Advertising (Bing Ads)​

الإعداد عبر Zapier​

  1. في Zapier، أنشئ Zap: Trigger ← Microsoft Advertising ← New Lead.
  2. Action ← Webhooks by Zapier ← POST إلى LeadHub Webhook URL.

Typeform​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← Typeform وانسخ Webhook URL.
  2. في Typeform ← Your Form ← Connect ← Webhooks: الصق الرابط وفعّله.

JotForm​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← JotForm وانسخ Webhook URL.
  2. في JotForm ← Settings ← Integrations ← Webhooks: الصق الرابط.

Calendly​

خطوات الإعداد​

  1. أنشئ اتصالًا بـ النوع ← Calendly وانسخ Webhook URL.
  2. في Calendly ← Integrations ← Webhooks: الصق الرابط واختر حدث invitee.created.

نموذج LeadHub Web​

عند إرسال نموذج أنشأته باستخدام Form Builder في LeadHub، يُنشأ العميل المحتمل تلقائيًا — لا يلزم إعداد webhook.

البريد الإلكتروني (IMAP)​

خطوات الإعداد​

  1. أنشئ عنوان بريد إلكتروني مخصصًا لالتقاط العملاء المحتملين.
  2. انتقل إلى التكاملات ← مصادر العملاء المحتملين وأنشئ اتصالًا بـ النوع ← Email (IMAP).
  3. أدخل IMAP Host والمنفذ واسم المستخدم وكلمة المرور والمجلد.
  4. يستطلع LeadHub صندوق البريد كل 5 دقائق.

الإدخال اليدوي​

أنشئ العملاء المحتملين مباشرةً في LeadHub من العملاء المحتملون ← جميع العملاء ← عميل جديد.

Generic Webhook (أي منصة)​

لأي منصة غير مدرجة أعلاه، استخدم نوع اتصال Generic Webhook. احصل على رابط يقبل أي حمولة JSON وهيّئ تعيين الحقول لاستخراج بيانات العميل المحتمل.

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'