לידים ומשימות דרך ה-API: ליד מהאתר, שלבים ומשימות

כל מה שקראתם כאן, המערכת עושה בשבילכם בקליק

45 יום לנסות את ביג בוס בחינם. בלי כרטיס אשראי, בלי התקנה: מייל וסיסמה וזהו.

מדריך למשתמש ללידים ולמשימות דרך ממשק ה-API של ביג בוס

פנייה מהאתר שנכנסת לביג בוס כליד

מי שממלא טופס באתר, משאיר פרטים בדף נחיתה או פונה דרך מערכת אחרת, צריך להגיע לביג בוס כליד, עם הפנייה שלו ועם משימה למי שיחזור אליו. דרך ה-API המערכת שלכם פותחת את הליד, מצרפת אליו פנייה חוזרת, מעדכנת את השלב שלו ומנהלת את המשימות.

המדריך מסביר את פעולות הלידים והמשימות ואת ההודעות שחוזרות בכל צעד. מבנה הבקשה הכללי: הקריאה הראשונה ל-API: מבנה הבקשה, התשובה וקודי התשובה.

שימו לב: לידים ומשימות דרך ה-API דורשים גם את תוסף ניהול לידים ומשימות (CRM). בלעדיו הבקשות נדחות ב-403 "תוסף CRM אינו פעיל עבור המנוי". את החיבור בין טופס משלכם לבין ה-API בונה מפתח/ת. מי שאין לו טופס, יכול להשתמש ב"טופס לידים לאתר" של תוסף ניהול לידים ומשימות, ב"הגדרות CRM": טופס קצר שביג בוס מארחת, עם קוד להדבקה באתר או קישור ישיר.

ליד חדש: lead_new

שולחים שם, ב-contact_name או ב-company_name, ודרך ליצור קשר, למשל נייד ב-cel. לצדם אפשר לשלוח:

message: מה הפונה כתב.
source: מאיפה הגיעה הפנייה, למשל website.
utm_source ושדות ה-UTM האחרים: פרטי הקמפיין שממנו הגיע הפונה.
marketing_consent: ההסכמה שהפונה סימן בטופס.

{
  "api_token": "<המפתח שלכם>",
  "contact_name": "ישראל ישראלי",
  "cel": "<הנייד שהפונה השאיר>",
  "message": "מבקש הצעת מחיר",
  "source": "website",
  "utm_source": "google",
  "marketing_consent": true
}

ההודעה היא "הליד נוסף". בתשובה חוזרים result "created", מספר הליד ב-lead_id, ו-task_id: כשנשלחה message, ביג בוס פותחת לפנייה משימת "מעקב", כדי שמישהו יחזור לפונה. בלי message לא נפתחת משימה, ו-task_id חוזר ריק (null). בליד עצמו השלב הוא new, "חדש", ו-inquiry_count הוא 1.

פנייה חוזרת מאותו מספר

כשאותו אדם פונה שוב מאותו מספר נייד, גם כשהמספר נשלח בכתיב 972+, לא נפתח ליד שני. ההודעה היא "הליד כבר קיים – הפנייה נוספה אליו", ובתשובה:

result הוא "merged", ו-lead_id הוא של הליד הקיים.
matched_by הוא "phone", כלומר הליד נמצא לפי הטלפון.
inquiry_count עולה ל-2, ונפתחת משימת "מעקב" נוספת לפנייה החדשה.

כך בכרטיס הליד רואים את כל הפניות שלו, זו אחר זו, ולא שני לידים של אותו אדם.

פנייה עם שם של ליד קיים, אבל מנייד אחר, נפתחת כליד נוסף, והנייד שנשלח מתווסף לשם הליד בסוגריים. ההודעה במקרה הזה היא "הליד נוסף – כבר קיים ליד באותו שם, לכן נוסף לשם מספר הטלפון".

כרטיס הליד, לשונית CRM: משימת "מעקב" לכל פנייה שהגיעה דרך ה-API, ומשימת שיחה שנוספה דרך ה-API. שלושתן סומנו כבוצעו.

מקור הפנייה ו-UTM

המקור, שדות ה-UTM וההסכמה נשמרים בליד, וחוזרים כששולפים אותו ב-lead_get לפי lead_id. בכרטיס הליד במסך המקור וההסכמה מוצגים מתחת לשלב, בשורה כמו "מקור: website • מסכים לדיוור • פניות: 2 (אחרונה 28/10/2026)", וברשימת הלידים אפשר לסנן לפי "מקור / קמפיין". המקור מופיע גם בתיאור של משימת המעקב, למשל "פנייה (website): …".

את כל שדות ה-UTM שנשלחו, למשל הקמפיין, מקבלים בשליפה ב-lead_get, או שומרים גם בצד של המערכת שלכם.

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

שינוי שלב: lead_update

lead_update מעדכנת ליד לפי lead_id, וב-stage משנים את השלב שלו. אחרי "stage": "contacted" ההודעה היא "הליד עודכן", ובמסך הליד מופיע "שלב: נוצר קשר".

{
  "api_token": "<המפתח שלכם>",
  "lead_id": 7720,
  "stage": "contacted"
}

ליד שלא התקדם מסמנים ב-"stage": "lost", ואת הסיבה שולחים ב-lost_reason. בליד שכבר בשלב lost אפשר לעדכן את הסיבה גם בלי לשלוח שוב את השלב, ובמסך הליד השלב מופיע כ"לא רלוונטי". סיבה לליד שאינו בשלב lost נדחית ב-400 "הסיבה (lost_reason) נשמרת רק לליד בשלב lost – יש לשלוח גם stage: lost".

ליד שהפך ללקוח לא מסמנים בשלב. ערך שאינו ברשימה נדחה ב-400, וההודעה מסבירה גם את זה:

"שדה stage יכול להכיל new, contacted, quoted, negotiation או lost (ליד שהפך ללקוח: lead_convert)"

כלומר הפיכת ליד ללקוח היא פעולה נפרדת, lead_convert.

הרשימות: crm_lists

crm_lists מקבלת רק את המפתח ומחזירה את רשימות העזר: השלבים של ליד, סוגי המשימות (שיחה, פגישה, מעקב, מייל, משימה, גבייה), הסטטוסים של משימה (פתוחה, בטיפול, ממתינה ללקוח, בוצעה) ואת העובדים. לכל ערך יש קוד, ואת הקוד שולחים בבקשות.

משימות: הוספה, עדכון וסימון כבוצעה

crm_task_new: משימה לכרטיס, עם contact_id (בבדיקה שלנו, הליד), תיאור ב-description וסוג ב-type, למשל call. ההודעה: "המשימה נוספה".
crm_task_update: שינוי של משימה, למשל "status": "in_progress". ההודעה: "המשימה עודכנה".
crm_task_complete: סימון כבוצעה. ההודעה: "המשימה בוצעה". סימון חוזר של אותה משימה מחזיר 409 "המשימה כבר בוצעה".
crm_task_list: המשימות של כרטיס, בעמודים, עם status "open" לפתוחות או "all" לכולן. כשאין: 204 "לא נמצאו משימות".

{
  "api_token": "<המפתח שלכם>",
  "contact_id": 7720,
  "type": "call",
  "description": "לחזור לפונה עם הצעת מחיר"
}

המשימות מופיעות בכרטיס הליד בביג בוס, בלשונית CRM, כמו משימה שנפתחה במסך.

איך ביג בוס עוזרת לקלוט לידים מהמערכת שלכם, ומה היא לא עושה

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

מה היא לא עושה: ממשק ה-API לא בונה טופס באתר: דרך ה-API הלידים נכנסים מהחיבור שבונה מפתח/ת. טופס לידים מוכן וייבוא לידים מקובץ אקסל הם חלק מתוסף ניהול לידים ומשימות עצמו, ולא מממשק ה-API. הפיכה של ליד ללקוח היא פעולה נפרדת, ולא שינוי שלב.

למה עסקים שמקבלים פניות מהאתר מכניסים אותן לביג בוס דרך ה-API: פנייה שנשארת בתיבת המייל של האתר נשכחת. כשהיא נכנסת כליד עם משימת מעקב, מישהו אחראי לחזור אליה, ופנייה שנייה מאותו אדם מצטרפת לאותו ליד. אפשר לנסות את הכול 45 יום בחינם, בלי התחייבות.

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

יש שאלה לפני שמתחילים? דברו איתנו