Your AI Connector Docs

טפסי לידים של פייסבוק

מריצים מודעות פייסבוק כדי להשיג לידים? האינטגרציה הזו שולחת את הלידים הללו באופן אוטומטי ל-Your AI Connector, כך שתוכלו ליצור איתם קשר ב-WhatsApp, ב-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 יוצר את איש הקשר ומוסיף אותו לרשימה שציינתם.

משם, שידור (broadcast), קמפיין או סוכן AI שהקציתם יטפלו בשאר — בין אם מדובר בהודעת קבלת פנים מבוססת AI, רצף הודעות (drip sequence) או מעקב ידני.

שלב 1: צרו את טופס הלידים שלכם בפייסבוק

  1. פתחו את Facebook Ads Manager.
  2. צרו קמפיין חדש עם היעד Leads (לידים).
  3. ברמת המודעה, בחרו ב-Instant Form כשיטת איסוף הלידים.
  4. בנו את הטופס עם השדות הדרושים לכם. לכל הפחות, כללו:
    • שם פרטי
    • מספר טלפון (עם קידומת מדינה)
    • אופציונלי: שם משפחה, אימייל
  5. פרסמו את המודעה או שמרו את הטופס כטיוטה לצורך בדיקה.

שלב 2: בדקו את טופס הלידים

לפני חיבור האוטומציה, שלחו ליד בדיקה:

  1. ב-Ads Manager, עברו לטופס הלידים שלכם.
  2. לחצו על Preview ומלאו את הטופס עם נתוני בדיקה.
  3. ודאו שליד הבדיקה מופיע ב-Facebook Lead Center שלכם (תחת כלי פרסום בדף הפייסבוק שלכם, או ב-Ads Manager תחת “Leads”).

ערך בדיקה זה ישמש להגדרת מיפוי השדות בפלטפורמת האוטומציה שלכם.

שלב 3: הגדירו את האוטומציה

הגדרת Facebook Lead Ads כטריגר

  1. התחבר לפלטפורמת האוטומציה שלך (Pabbly, Zapier או Make).
  2. צור תהליך עבודה / תרחיש / zap חדש.
  3. הגדר את ה-trigger (טריגר) ל-“Facebook Lead Ads - New Lead”.
  4. חבר את חשבון הפייסבוק שלך ובחר את הדף ואת טופס הלידים.
  5. משוך ליד בדיקה כדי לוודא שהחיבור עובד וכדי למפות את השדות.

הגדרת קריאת API 1: יצירת איש קשר

הוסיפו שלב פעולה (action step) עם בקשת HTTP / Webhook / API:

  • Method: POST
  • URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • Headers:
    Content-Type: application/json
  • Body (JSON):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

החלף את {{placeholders}} במיפויי השדות בפועל משלב הטריגר שלך.

חשוב: מספר הטלפון חייב לכלול את קידומת המדינה (לדוגמה, +1 עבור ארה"ב או +31 עבור הולנד). אם טופס הלידים שלך אוסף את מספר הטלפון ללא קידומת מדינה, הוסף שלב עיצוב באוטומציה שלך כדי להוסיף אותה בתחילת המספר.

תגובת ה-API מחזירה את המזהה (ID) של איש הקשר החדש ב-data.contactId. שמור ערך זה — תזדקק לו עבור השלב הבא.

ניתן לדלג על הקריאה השנייה. POST /v1/contacts מקבל גם את listId (רשימה אחת) או listIds (מספר רשימות) בגוף הבקשה ליצירה, מה שמוסיף את איש הקשר החדש לרשימות אלו באותה בקשה. השתמש בגרסה הדו-שלבית להלן רק אם פלטפורמת האוטומציה שלך דורשת שאיש הקשר יהיה קיים לפני שהיא מחליטה באיזו רשימה להשתמש.

הגדרת קריאת API 2: הוספת איש קשר לרשימה

הוסף שלב פעולה שני:

  • שיטה: POST
  • URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • כותרות (Headers):
    Content-Type: application/json
  • Body (JSON):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

החלף את YOUR_LIST_ID במזהה האמיתי של רשימת אנשי הקשר שלך (ראה מציאת מזהה הרשימה שלך להלן), ומפה את contactId ל-data.contactId שהוחזר על ידי קריאת ה-API הראשונה.

מציאת ה-ID של הרשימה שלך

  1. ב-Your AI Connector, לחצו על אנשי קשר (Contacts), ולאחר מכן על הלשונית רשימות (Lists).
  2. פתחו את תפריט השורה (“⋯”) לצד הרשימה הרצויה ולחצו על העתק מזהה רשימה (Copy list ID).

ראו Organizing Lists & Contacts למדריך המלא על דף הרשימות.

שלב 4: בדיקת זרימת העבודה המלאה

  1. שלחו ליד בדיקה נוסף דרך טופס הפייסבוק שלכם (או הריצו שוב את ליד הבדיקה הקיים בפלטפורמת האוטומציה שלכם).
  2. בדקו ב-Your AI Connector כדי לוודא:
    • איש הקשר נוצר עם השם, מספר הטלפון וכתובת האימייל הנכונים.
    • איש הקשר התווסף לרשימה הנכונה.
  3. אם יש לכם שידור (broadcast), קמפיין או סוכן AI שמוגדרים לשלוח הודעה לרשימה זו באופן אוטומטי, ודאו שהם מופעלים כמצופה.

הפניה לנתונים

להלן דוגמאות לנתונים שנשלחו והתקבלו במהלך האינטגרציה.

יצירת איש קשר - בקשה 

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} ואינה מחזירה את איש הקשר הקיים. בצע פיצול (Branch) על error_code (סטטוס ה-HTTP הוא 200) וחפש את איש הקשר באמצעות GET /v1/contacts?phoneNumber=... לפני הקריאה להוספה לרשימה.
  • טפסים מרובים: צור תהליכי אוטומציה נפרדים עבור טפסי לידים שונים, כאשר כל אחד מהם מכוון לרשימה אחרת ולשידור, קמפיין או סוכן AI שונה.
  • התראות שגיאה: הגדר את פלטפורמת האוטומציה שלך כך שתשלח לך התראה אם קריאת API נכשלת, כדי שלא תאבד לידים.

צעדים הבאים