איך בונים דף נחיתה
שמתחבר למערכת הלידים

1 איך זה עובד

דף הנחיתה שלכם שולח בקשת POST אחת עם פרטי הליד. המערכת מאמתת אותה, שומרת אותה במסד הנתונים, מצרפת אותה לקמפיין (לפי campaign_id), ושולחת התראת טלגרם מיידית על כל ליד תקין.

2 נקודת הקצה (Endpoint)

גוף הבקשה הוא JSON עם הכותרת Content-Type: application/json. אין צורך במפתח API — הדף הציבורי שולח ישירות.

3 שדות הבקשה

4 כלל האימייל — חשוב!

המערכת דורשת כרגע אימייל תקין בכל ליד. בקשה ללא אימייל (או עם אימייל ריק) נדחית עם שגיאת 400 — והליד אובד.

אם בדף שלכם אין שדה אימייל

צרו אימייל placeholder בצד הלקוח לפני השליחה, נגזר מהטלפון, כך שהליד נשמר תקין ועדיין מזוהה ככזה ללא אימייל אמיתי:

// אם המשתמש לא מילא אימייל — צרו placeholder תקין
if (!payload.email) {
  const digits = (payload.phone || '').replace(/\D/g, '');
  payload.email = digits
    ? `${digits}@no-email.hebcal.co.il`      // דדופ לפי אדם
    : `lead-${Date.now()}@no-email.hebcal.co.il`; // גיבוי
}

5 ערכי source מותרים

השדה מקבל רק ערכים מתוך רשימה לבנה. כל ערך אחר מתאפס אוטומטית ל-"form":

form   whatsapp   phone   email

עבור דף נחיתה רגיל השתמשו תמיד ב-"form".

6 דוגמה מלאה — טופס + שליחה

קוד מוכן להעתקה. הטופס קולט שם, טלפון ואימייל (רשות), קורא את campaign_id מכתובת ה-URL, ומפעיל את ה-placeholder אם האימייל ריק.

HTML

<form id="lead-form">
  <input name="name"  placeholder="שם מלא" required />
  <input name="phone" placeholder="טלפון" type="tel" required />
  <input name="email" placeholder="אימייל (רשות)" type="email" />
  <button type="submit">שליחה</button>
</form>

JavaScript

const ENDPOINT = 'https://ads.hebcal.co.il/v1/lead';
const form = document.getElementById('lead-form');

form.addEventListener('submit', async (e) => {
  e.preventDefault();

  const payload = {
    name:    form.name.value.trim(),
    phone:   form.phone.value.trim(),
    email:   form.email.value.trim(),
    source:  'form',
    campaign_id: new URLSearchParams(location.search).get('campaign_id'),
    landing_page: location.href,
  };

  // Workaround: synthesize a placeholder email when blank
  if (!payload.email) {
    const digits = payload.phone.replace(/\D/g, '');
    payload.email = digits
      ? `${digits}@no-email.hebcal.co.il`
      : `lead-${Date.now()}@no-email.hebcal.co.il`;
  }

  try {
    const res = await fetch(ENDPOINT, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(payload),
    });
    const data = await res.json();
    if (data.success) {
      // הציגו הודעת תודה
    } else {
      // data.error מכיל את הסיבה
    }
  } catch (err) {
    // שגיאת רשת — בקשו מהמשתמש לנסות שוב
  }
});

7 מתי ליד נחשב תקין

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

• name קיים, ו-email תקין (או placeholder תקין).
• לא חרגתם ממגבלת הקצב (rate limit) לפי כתובת IP.
• אין כפילות — אותו אימייל, באותו קמפיין, ב-30 הימים האחרונים.

8 תשובות השרת

הצלחה

200 OK
{ "success": true }

שגיאה

400 { "error": "Missing name or email" }   // שדה חובה חסר
500 { "error": "..." }                       // תקלת שרת

9 צ'קליסט לפני העלאה