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

מריצים מודעות פייסבוק כדי להשיג לידים? האינטגרציה הזו שולחת את הלידים הללו באופן אוטומטי ל-<span data-t="appName">Your AI Connector</span>, כך שתוכלו ליצור איתם קשר ב-WhatsApp, ב-SMS או בכל ערוץ מחובר אחר — מבלי להזיז אצבע.

זה עובד על ידי חיבור מודעות לידים של פייסבוק (Facebook Lead Ads) ל-<span data-t="appName">Your AI Connector</span> דרך פלטפורמת אוטומציה (כמו Pabbly, Zapier או Make). פלטפורמות אלו משמשות כגשר בין פייסבוק ל-<span data-t="appName">Your AI Connector</span>, ומעבירות את פרטי הליד מאחת לשנייה באמצעות ה-API (דרך שבה תוכנות שונות מחליפות נתונים באופן אוטומטי).

---

## דרישות קדם

לפני שמתחילים, ודאו שיש לכם:

- **גישה ל-Facebook Ads Manager** עם הרשאה ליצירת מודעות לידים.
- **חשבון** עם מפתח API פעיל (ניתן ליצור אחד ב-**הגדרות ← אינטגרציות ← מפתח API** — ראו [גישת API](api-access.md) לצעדים המדויקים).
- **חשבון בפלטפורמת אוטומציה** — Pabbly Connect, Zapier או Make (Integromat). מדריך זה משתמש ב-Pabbly כדוגמה, אך הצעדים דומים בכל פלטפורמה.
- **רשימת אנשי קשר** ב-<span data-t="appName">Your AI Connector</span> שאליה יתווספו הלידים החדשים — ראו [ארגון רשימות ואנשי קשר](../get-started/list-and-contact-management.md).

---

## סקירה כללית

האינטגרציה פועלת בשלושה שלבים:

1. לקוח פוטנציאלי ממלא את טופס הלידים שלכם בפייסבוק.
2. פלטפורמת האוטומציה שלכם מזהה את הליד החדש ושולחת את המידע ל-<span data-t="appName">Your AI Connector</span> באופן אוטומטי (באמצעות שתי קריאות API).
3. <span data-t="appName">Your AI Connector</span> יוצר את איש הקשר ומוסיף אותו לרשימה שציינתם.

משם, שידור (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):**
  ```json
  {
    "firstName": "{{first_name}}",
    "lastName": "{{last_name}}",
    "phone": "{{phone_number}}",
    "email": "{{email}}"
  }
  ```

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

::: warning
**חשוב:** מספר הטלפון חייב לכלול את קידומת המדינה (לדוגמה, `+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):**
  ```json
  {
    "contactId": "{{contact_id_from_previous_step}}",
    "listId": "YOUR_LIST_ID"
  }
  ```

החלף את `YOUR_LIST_ID` במזהה האמיתי של רשימת אנשי הקשר שלך (ראה [מציאת מזהה הרשימה שלך](#finding-your-list-id) להלן), ומפה את `contactId` ל-`data.contactId` שהוחזר על ידי קריאת ה-API הראשונה.

---

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

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

ראו [Organizing Lists & Contacts](../get-started/list-and-contact-management.md) למדריך המלא על דף הרשימות.

---

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

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

---

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

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

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

```json
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"
}
```

### יצירת איש קשר - תגובה

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

### הוספת איש קשר לרשימה - בקשה

```json
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 נכשלת, כדי שלא תאבד לידים.

---

## צעדים הבאים

- [מעבר מקמפיינים לשידורים וסוכנים](../moving-from-campaigns.md) — הגדר משהו שישלח הודעות באופן אוטומטי ללידים חדשים.
- [גישת API](api-access.md) — תיעוד API מלא עבור אינטגרציות מתקדמות.
- [Webhooks](webhooks.md) — קבל התראות כאשר אנשי קשר נוצרים או מתויגים.