Web2Lead — קליטת לידים מדפי נחיתה וטפסים חיצוניים

פונקציית קליטת הלידים של MyBusiness מאפשרת להזרים לידים ישירות לתוך ה-CRM מכל טופס חיצוני, דף נחיתה או אתר אינטרנט — ללא צורך בפיתוח צד-שרת מורכב. שם הפונקציה בשרת הוא getlead.

לחצו לאישור עוגיות שיווק ולהפעלת התוכן

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

שימו לב לשם הפונקציה: בחומרים ישנים הפונקציה מופיעה לעיתים בשם “web2lead” — אך השם הרשום בשרת הוא getlead. קריאה לכתובת עם השם הישן תחזיר שגיאת User function not found. ליצירת רשומות בטבלאות אחרות (מכירה, פנייה, הרשמה) קיימת פונקציה נפרדת בשם web2table.

דרישות מוקדמות והגדרת המערכת

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

1. הפעלת הפונקציה — היכנסו לטבלת Config במערכת ה-CRM וודאו שהמפתח AcceptWebLeads מוגדר כ-true. ללא הגדרה זו, המערכת תדחה כל בקשה נכנסת עם השגיאה AcceptWebLeads is Disabled.
2. הפעלת בדיקת תקינות (מומלץ) — הדליקו באותה שורת Config גם את המפתח ValidatePhoneOrEmail, כדי שטלפון או אימייל בפורמט שגוי יידחו ולא ייכנסו כלידים “זבל”.
3. בניית הטופס החיצוני — צרו טופס HTML בדף הנחיתה או באתר שלכם.
4. הגדרת כתובת השליחה — הטופס ישלח את הנתונים בבקשת POST לכתובת:

https://api.mbapps.co.il/functions/YOUR_APP_ID/getlead

החליפו את YOUR_APP_ID במזהה האפליקציה שלכם ב-MyBusiness (Application Id — מזהה ציבורי, מותר לו להופיע בקוד הדף).

פרמטרים נדרשים ואופציונליים

פרמטרים נדרשים

בקשה ללא שניהם תוחזר עם 400 והשגיאה missing "PhoneNumber" or "Email".

פרמטרים אופציונליים נפוצים

שמות השדות נשלחים ללא קידומת — בדיוק כפי שהם מופיעים בסכימת טבלת Accounts במערכת שלכם:

• Name — שם הליד המלא
• F_name / L_name — שם פרטי ושם משפחה
• City / Address — עיר וכתובת
• כל שדה מותאם אישית שקיים בטבלת Accounts שלכם — לרבות שדות מקור ליד (Pointer) עם objectId

חשוב: מפתח שאינו קיים בסכימת Accounts נזרק בשקט — הבקשה תחזיר הצלחה אך הנתון לא יישמר. ודאו את שמות השדות המדויקים מול המערכת שלכם לפני העלייה לאוויר.

דוגמת טופס HTML + JavaScript

הדרך המומלצת: טופס HTML רגיל שנשלח ב-JavaScript כ-JSON. כך שולטים בחוויית המשתמש ומטפלים בשגיאות:

<form id="lead-form">
  <label for="name">שם מלא</label>
  <input type="text" name="name" id="name" placeholder="שם מלא" required />

  <label for="phone">טלפון</label>
  <input type="tel" name="phone" id="phone" placeholder="טלפון" required />

  <label for="email">אימייל</label>
  <input type="email" name="email" id="email" placeholder="אימייל" />

  <button type="submit">שלח</button>
</form>

דוגמת שליחה ב-JavaScript (fetch)

async function submitLead(formData) {
  try {
    const response = await fetch(
      'https://api.mbapps.co.il/functions/YOUR_APP_ID/getlead',
      {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-Parse-Application-Id': 'YOUR_APP_ID'
        },
        body: JSON.stringify({
          Name: formData.fullName,
          PhoneNumber: formData.phone,
          Email: formData.email,
          City: formData.city
        })
      }
    );

    const body = await response.json();
    if (response.ok && body.result && body.result.success) {
      console.log('Lead created:', body.result.leadId);
      // הצגת הודעת הצלחה למשתמש / הפניה לדף תודה
    } else {
      console.error('Lead rejected:', body.error);
      // הצגת הודעת שגיאה למשתמש
    }
  } catch (error) {
    console.error('Error submitting lead:', error);
  }
}

// שימוש לדוגמה
submitLead({
  fullName: 'ישראל ישראלי',
  phone: '0501234567',
  email: 'lead@example.com',
  city: 'תל אביב'
});

שימו לב למבנה התשובה: תשובת ההצלחה של getlead עטופה באובייקט result — קראו את מזהה הליד מ-body.result.leadId. שגיאות (סטטוס 400) חוזרות לא עטופות, בצורה {"error":"..."}.

זיהוי כפילויות (Duplicate Detection)

המערכת בודקת אוטומטית אם הליד כבר קיים, לפי שני שדות:

1. מספר טלפון (PhoneNumber) — המספר מנורמל ונבדק מול כל פורמטי הכתיבה הנפוצים (05X, ‏972, ‏+972, עם ובלי מקפים)
2. כתובת אימייל (Email) — חיפוש התאמה ישירה

כפילות אינה חוסמת את הקליטה: תמיד נוצרת רשומת ליד חדשה. אם נמצאה התאמה — הליד החדש מקבל אוטומטית את הסטטוס “ליד כפול”, כך שצוות המכירות רואה מיד שמדובר בפנייה חוזרת; אם לא נמצאה — הליד נוצר בסטטוס “ליד חדש”. כך לא מאבדים אף פנייה, וגם לא מטפלים פעמיים באותו ליד בלי לדעת.

טיפים ושיטות עבודה מומלצות

• בדקו לפני העלייה לאוויר — שלחו כמה טפסי בדיקה וודאו שהלידים נוצרים כצפוי עם כל השדות הרלוונטיים ובסטטוס הנכון.
• הגדירו טריגר להתראות — צרו טריגר על טבלת הלידים כך שצוות המכירות יקבל התראה מיידית על כל ליד חדש. ניתן להגדיר התראת מערכת, אימייל או הודעת WhatsApp.
• עקבו אחרי מקורות — הוסיפו לטופס שדה מוסתר עם מקור הפנייה (אתר, דף נחיתה ספציפי, קמפיין) ומפו אותו לשדה מקור הליד במערכת. מידע זה קריטי למדידת ROI של ערוצי השיווק.
• שדות חובה — הגדירו ולידציה בצד הלקוח (HTML5 validation או JavaScript) כדי לוודא שנשלח לפחות טלפון או אימייל, והדליקו את ValidatePhoneOrEmail בצד השרת.
• דף תודה — לאחר שליחה מוצלחת (body.result.success), הפנו את המשתמש לדף תודה או הציגו הודעת הצלחה בדף.

סיכום

פונקציית getlead היא הדרך הפשוטה והמהירה ביותר לחבר דפי נחיתה וטפסי אתר למערכת ה-CRM של MyBusiness. עם זיהוי כפילויות אוטומטי לפי טלפון ואימייל, תמיכה בכל שדות טבלת הלידים, וקריאת HTTP אחת בלבד — אפשר להקים את כל תהליך קליטת הלידים בדקות ספורות. ליצירת רשומות מקושרות בטבלאות נוספות (מכירות, פניות, הרשמות) השתמשו בפונקציה המשלימה web2table.