نماذج عملاء Facebook المحتملين #

هل تشغل إعلانات فيسبوك لجذب العملاء المحتملين؟ يقوم هذا التكامل بإرسال هؤلاء العملاء تلقائياً إلى Your AI Connector حتى تتمكن من متابعتهم عبر واتساب، أو الرسائل القصيرة (SMS)، أو أي قناة أخرى متصلة — دون الحاجة إلى القيام بأي مجهود.

يعمل هذا التكامل عن طريق ربط إعلانات فيسبوك للعملاء المحتملين (Facebook Lead Ads) بـ Your AI Connector من خلال منصة أتمتة (مثل Pabbly أو Zapier أو Make). تعمل هذه المنصات كجسر بين فيسبوك وYour AI Connector، حيث تنقل معلومات العميل المحتمل من أحدهما إلى الآخر باستخدام واجهة برمجة التطبيقات API (وهي وسيلة لتبادل البيانات تلقائياً بين البرامج المختلفة).

المتطلبات الأساسية #

قبل البدء، تأكد من توفر ما يلي:

• إمكانية الوصول إلى مدير إعلانات فيسبوك (Facebook Ads Manager) مع صلاحية إنشاء إعلانات العملاء المحتملين.
• حساب مع مفتاح API نشط (يمكنك إنشاؤه من الإعدادات ← التكاملات ← مفتاح API — راجع الوصول إلى API لمعرفة الخطوات الدقيقة).
• حساب على منصة أتمتة — مثل Pabbly Connect أو Zapier أو Make (Integromat). يستخدم هذا الدليل Pabbly كمثال، ولكن الخطوات متشابهة في أي منصة أخرى.
• قائمة جهات اتصال في Your AI Connector حيث ستتم إضافة العملاء المحتملين الجدد — راجع تنظيم القوائم وجهات الاتصال.

نظرة عامة #

يعمل التكامل على ثلاث مراحل:

1. يقوم العميل المحتمل بملء نموذج فيسبوك للعملاء المحتملين.
2. تكتشف منصة الأتمتة الخاصة بك العميل الجديد وترسل المعلومات إلى Your AI Connector تلقائياً (باستخدام استدعاءين لواجهة برمجة التطبيقات API).
3. يقوم Your AI Connector بإنشاء جهة الاتصال وإضافتها إلى القائمة التي تحددها.

من هناك، يتولى البث، أو الحملة، أو وكيل الذكاء الاصطناعي (AI Agent) الذي قمت بتعيينه بقية المهمة — سواء كان ذلك رسالة ترحيب مدعومة بالذكاء الاصطناعي، أو سلسلة رسائل متتابعة، أو متابعة يدوية.

الخطوة 1: إنشاء نموذج Facebook للعملاء المحتملين #

1. افتح مدير إعلانات Facebook.
2. أنشئ حملة جديدة بهدف العملاء المحتملين (Leads).
3. على مستوى الإعلان، اختر نموذج فوري (Instant Form) كطريقة لجذب العملاء المحتملين.
4. قم ببناء نموذجك بالحقول التي تحتاجها. كحد أدنى، قم بتضمين:
   • الاسم الأول
   • رقم الهاتف (مع رمز الدولة)
   • اختياري: اسم العائلة، البريد الإلكتروني
5. انشر الإعلان أو احفظ النموذج كمسودة للاختبار.

الخطوة 2: اختبار نموذج العملاء المحتملين #

قبل ربط الأتمتة، أرسل عميلاً محتملاً تجريبيًا:

1. في مدير الإعلانات، انتقل إلى نموذج العملاء المحتملين الخاص بك.
2. انقر على معاينة (Preview) واملأ النموذج ببيانات تجريبية.
3. تأكد من ظهور العميل المحتمل التجريبي في مركز العملاء المحتملين على Facebook (ضمن أدوات النشر على صفحتك على Facebook، أو في مدير الإعلانات تحت قسم “العملاء المحتملون”).

سيتم استخدام إدخال الاختبار هذا لإعداد تعيين الحقول في منصة الأتمتة الخاصة بك.

الخطوة 3: إعداد الأتمتة #

ربط إعلانات فيسبوك للعملاء المحتملين (Facebook Lead Ads) كمشغل (Trigger) #

1. سجل الدخول إلى منصة الأتمتة الخاصة بك (Pabbly أو Zapier أو Make).
2. أنشئ سير عمل / سيناريو / zap جديداً.
3. اضبط المشغل (trigger) على “Facebook Lead Ads - New Lead”.
4. اربط حسابك على فيسبوك وحدد الصفحة ونموذج العملاء المحتملين.
5. اجلب عميلاً محتملاً تجريبياً للتأكد من عمل الربط وتعيين الحقول.

تهيئة استدعاء واجهة برمجة التطبيقات (API Call) 1: إنشاء جهة اتصال #

أضف خطوة إجراء باستخدام طلب HTTP / Webhook / API:

• الطريقة (Method): POST
• رابط URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
• الترويسات (Headers):

  Content-Type: application/json
  

• النص (JSON):

  {
    "firstName": "{{first_name}}",
    "lastName": "{{last_name}}",
    "phone": "{{phone_number}}",
    "email": "{{email}}"
  }
  

استبدل {{placeholders}} بتعيينات الحقول الفعلية من خطوة المشغل الخاصة بك.

تُرجع استجابة واجهة برمجة التطبيقات (API) مُعرّف جهة الاتصال الجديدة في data.contactId. احفظ هذه القيمة — ستحتاج إليها في الخطوة التالية.

يمكنك تخطي الاستدعاء الثاني. تقبل POST /v1/contacts أيضاً listId (قائمة واحدة) أو listIds (عدة قوائم) في نص الإنشاء، مما يضيف جهة الاتصال الجديدة إلى تلك القوائم في نفس الطلب. استخدم إصدار الخطوتين أدناه فقط إذا كانت منصة الأتمتة الخاصة بك تتطلب وجود جهة الاتصال قبل أن تقرر القائمة التي يجب استخدامها.

تهيئة استدعاء واجهة برمجة التطبيقات (API Call) 2: إضافة جهة اتصال إلى قائمة #

أضف خطوة إجراء ثانية:

• الطريقة: POST
• URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
• الترويسات:

  Content-Type: application/json
  

• النص (JSON):

  {
    "contactId": "{{contact_id_from_previous_step}}",
    "listId": "YOUR_LIST_ID"
  }
  

استبدل YOUR_LIST_ID بالمُعرّف الفعلي لقائمة جهات الاتصال الخاصة بك (انظر العثور على مُعرّف قائمتك أدناه)، وقم بتعيين contactId إلى data.contactId الذي تم إرجاعه بواسطة استدعاء API الأول.

العثور على معرف القائمة (List ID) الخاص بك #

1. في Your AI Connector، انقر على جهات الاتصال (Contacts)، ثم علامة التبويب القوائم (Lists).
2. افتح قائمة الصف (“⋯”) بجوار القائمة التي تريدها وانقر على نسخ معرف القائمة (Copy list ID).

راجع تنظيم القوائم وجهات الاتصال للحصول على شرح كامل لصفحة القوائم.

الخطوة 4: اختبار سير العمل بالكامل #

1. أرسل عميلاً محتملاً تجريبياً آخر من خلال نموذج فيسبوك الخاص بك (أو أعد تشغيل العميل المحتمل التجريبي الموجود في منصة الأتمتة الخاصة بك).
2. تحقق من Your AI Connector للتأكد مما يلي:
   • تم إنشاء جهة الاتصال بالاسم ورقم الهاتف والبريد الإلكتروني الصحيحين.
   • تمت إضافة جهة الاتصال إلى القائمة الصحيحة.
3. إذا كان لديك بث، أو حملة، أو وكيل ذكاء اصطناعي (AI Agent) مضبوطاً لمراسلة تلك القائمة تلقائياً، فتأكد من أنه يعمل كما هو متوقع.

مرجع البيانات #

فيما يلي أمثلة على البيانات المرسلة والمستلمة أثناء التكامل.

إنشاء جهة اتصال - طلب #

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}

إنشاء جهة اتصال - استجابة #

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}

إضافة جهة اتصال إلى قائمة - طلب #

POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts/lists?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz",
  "listId": "LIST_ID"
}

نصائح #

• معالجة التكرار: إذا كانت جهة الاتصال التي تحمل نفس رقم الهاتف موجودة بالفعل، فإن استدعاء الإنشاء يُرجع {"success": false, "error_code": 409} ولا يُرجع جهة الاتصال الموجودة. قم بالتفرع بناءً على error_code (حالة HTTP هي 200) وابحث عن جهة الاتصال باستخدام GET /v1/contacts?phoneNumber=... قبل استدعاء الإضافة إلى القائمة.
• نماذج متعددة: أنشئ مسارات عمل أتمتة منفصلة لنماذج العملاء المحتملين المختلفة، بحيث يستهدف كل منها قائمة مختلفة وبثاً أو حملة أو وكيلاً ذكياً مختلفاً.
• إشعارات الخطأ: قم بتهيئة منصة الأتمتة الخاصة بك لإخطارك في حال فشل استدعاء API، حتى لا تفقد العملاء المحتملين.

الخطوات التالية #

• الانتقال من الحملات إلى البث والوكلاء — قم بإعداد شيء ما لإرسال رسائل تلقائية إلى العملاء المحتملين الجدد.
• الوصول إلى واجهة برمجة التطبيقات (API) — وثائق API الكاملة لعمليات التكامل المتقدمة.
• خطافات الويب (Webhooks) — احصل على إشعارات عند إنشاء جهات اتصال أو إضافة وسوم إليها.