חיבור טופס מדף נחיתה: לידים, UTM והודעת ברוכים הבאים

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

1. מבקר ממלא את הטופס בדף הנחיתה.
2. הטופס שולח את הפרטים לכתובת הקליטה של טסקי.
3. הליד מופיע בטבלת הלידים, עם מקור ההגעה, הקמפיין, הקהל והמודעה.
4. טריגר שולח לו הודעת וואטסאפ בשמכם.

מגדירים פעם אחת, ומשם זה רץ לבד.

1. מעתיקים את כתובת הקליטה

1. בסרגל העליון פתחו הגדרות, ובקבוצה API ולוגים לחצו API.
2. בעמוד תיעוד API, בתפריט הצד תחת לידים, לחצו הוספת ליד.
3. העתיקו את הכתובת מתחת לכתובת (Endpoint). כפתור ההעתקה נמצא בתחילת השורה.

הכתובת בנויה כך, כש-YOUR-SUBDOMAIN הוא השם שלכם, החלק שלפני .taskey.co.il:

https://YOUR-SUBDOMAIN.taskey.co.il/webapi/AddLead.php

הכתובת פתוחה לקליטת לידים, בלי מפתח. לכן כל טופס יכול להתחבר אליה. מנהל יכול לחייב מפתח: הגדרות → ליד חדש — קליטה והתראות → לשונית הגדרות קליטה → לחייב טוקן API בקליטת ליד חדש (AddLead). אחרי שמפעילים, טופס HTML ו-Webhook של בונה אתרים לא שולחים מפתח, והלידים שלהם יידחו. המודול הוספת ליד של Make ממשיך לעבוד, כי הוא שולח את המפתח מהחיבור.

2. מחברים את הטופס

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

בונה אתרים: Elementor, וורדפרס, Wix וכו'

רוב בוני האתרים יודעים לשלוח טופס ל-Webhook:

1. ערכו את הטופס.
2. חפשו את ההגדרה Actions After Submit / "פעולות אחרי שליחה" / "אינטגרציות".
3. הוסיפו פעולת Webhook והדביקו את כתובת הקליטה.
4. שמרו ופרסמו.

הוראות לכל תוסף וורדפרס (Elementor, Contact Form 7, WPForms, Gravity, Fluent): חיבור טופס וורדפרס.

טופס בקוד (HTML)

הפנו את ה-action של הטופס לכתובת הקליטה:

<form action="https://YOUR-SUBDOMAIN.taskey.co.il/webapi/AddLead.php" method="POST">
  <input type="text"  name="name"  placeholder="שם מלא" required>
  <input type="tel"   name="phone" placeholder="טלפון" required>
  <input type="email" name="email" placeholder="אימייל">
  <input type="hidden" name="source" value="דף נחיתה">
  <button type="submit">שליחה</button>
</form>

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

• הכי פשוט: הוסיפו ?body=taskey לסוף הכתובת ב-action. הלקוח יראה הודעת הצלחה קצרה של טסקי במקום ה-JSON.

<form action="https://YOUR-SUBDOMAIN.taskey.co.il/webapi/AddLead.php?body=taskey" method="POST">

• דף תודה משלכם: שלחו את הטופס ב-JavaScript והעבירו את הלקוח לדף התודה באתר שלכם:

<script>
document.querySelector('form').addEventListener('submit', function (e) {
  e.preventDefault();
  fetch('https://YOUR-SUBDOMAIN.taskey.co.il/webapi/AddLead.php', {
    method: 'POST',
    mode: 'no-cors',
    body: new FormData(this)
  }).finally(function () {
    window.location.href = 'https://yoursite.com/thank-you';
  });
});
</script>

דרך Make או Zapier

הטופס שולח את הפרטים לתרחיש, והתרחיש מעביר אותם לטסקי:

• Make: מודול הוספת ליד של אפליקציית טסקי. ראו חיבור לידים חדשים מ-Make.
• Zapier: פעולת Webhook מסוג POST לכתובת הקליטה. ראו חיבור Zapier.

3. שמות השדות

טסקי מזהה כל שדה לפי השם שלו (name= בקוד, או שם השדה בבונה האתרים). כדי שייפתח ליד צריך לפחות שם, טלפון או אימייל.

מה אוספים	שם השדה	הערות
שם מלא	name	מומלץ
טלפון	phone	הכי חשוב: בלעדיו אין לאן לשלוח וואטסאפ
אימייל	email
עיר	city
מקור הגעה	source	שדה נסתר עם ערך קבוע, למשל "דף נחיתה". כשלא נשלח שום מקור, הליד נכנס עם מקור ההגעה API
ערוץ התקשרות	channel	שדה נסתר, למשל שם הדף. מופיע בלשונית מקורות בכרטיס הליד
שאלה פתוחה	comment	נכנס כתגובה בכרטיס הליד

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

4. UTM: מאיזה קמפיין ומאיזו מודעה הגיע כל ליד

UTM הם פרמטרים שמוסיפים לקישור של המודעה, למשל ?utm_source=facebook&utm_campaign=webinar. טסקי שומר אותם בשדות השיווק של הליד. כך רואים בכרטיס הליד ובדוחות איזה קמפיין, קהל ומודעה הביאו כל ליד.

לאיזה שדה נכנס כל פרמטר

פרמטר	השדה בטסקי
utm_source	מקור הגעה
utm_campaign	קמפיין
utm_medium	קהל
utm_content (או utm_ad)	מודעה
utm_term (או utm_placement)	מיקום מודעה

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

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

בטופס בקוד (HTML)

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

<input type="hidden" name="utm_source">
<input type="hidden" name="utm_medium">
<input type="hidden" name="utm_campaign">
<input type="hidden" name="utm_content">
<input type="hidden" name="utm_term">
<input type="hidden" name="form_name" value="דף נחיתה">

<script>
var params = new URLSearchParams(location.search);
['utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term'].forEach(function (key) {
  var field = document.querySelector('input[name="' + key + '"]');
  if (field) field.value = params.get(key) || '';
});
</script>

מה גובר על מה

• שדה source עם ערך גובר על utm_source. בטופס עם UTM הורידו את השדה הנסתר source, ושימו במקומו form_name, כמו בדוגמה: הוא נכנס כמקור הגעה רק כשאין utm_source, למשל כשמגיעים לדף מחיפוש בגוגל.
• גם campaign, adset ו-ad גוברים על ה-UTM המקביל, אפילו כשהם ריקים. אל תשאירו אותם בטופס לצד שדות ה-UTM.

בוורדפרס (Elementor ובוני טפסים אחרים)

1. הוסיפו לטופס שדה נסתר (Hidden) לכל פרמטר: utm_source, utm_medium, utm_campaign, utm_content.
2. תנו לכל שדה בדיוק את שם הפרמטר.
3. בערך ברירת המחדל של השדה בחרו לקרוא אותו מהכתובת. ב-Elementor: לשונית מתקדם, תג דינמי פרמטר בקשה (Request Parameter), והזינו את שם הפרמטר.
4. שמרו, ושלחו טופס בדיקה דרך קישור עם UTM.

צילומי מסך מ-Elementor נמצאים בסעיף ה-UTM במדריך חיבור טופס וורדפרס.

בחיבור דרך Make

למודול הוספת ליד אין שדות בשם utm. ממפים את ערכי ה-UTM שהמודול הראשון קיבל לשדות השיווק של המודול:

הערך מהמודול הראשון	השדה במודול הוספת ליד
utm_source	מקור הגעה
utm_campaign	קמפיין
utm_medium	קהל
utm_content	מודעה

• המודול הראשון הוא Webhook שמקבל את הטופס מהאתר? הטופס צריך לשלוח את ה-UTM בשדות נסתרים, כמו בוורדפרס או בקוד. אחרת אין ל-Make מה למפות.
• אחרי שהוספתם שדות לטופס, שלחו טופס אחד ולחצו ב-Webhook של Make על Redetermine data structure, כדי שהשדות החדשים יופיעו ברשימת המיפוי.
• מודול הוספת ליד לא מעביר מיקום מודעה.

המדריך המלא: חיבור לידים חדשים מ-Make.

בקישור של המודעה

בפייסבוק אפשר לתת לכל מודעה למלא את ה-UTM לבד. ברמת המודעה, תחת Tracking, בשדה URL parameters, הדביקו:

utm_source=facebook&utm_medium={{adset.name}}&utm_campaign={{campaign.name}}&utm_content={{ad.name}}&utm_term={{placement}}

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

הערכים נשמרים בדיוק כפי שהגיעו. "facebook" ו"פייסבוק" הם שני מקורות שונים בדוחות. בחרו כתיב אחד והשתמשו בו בכל הקישורים. משתמשים גם ב-Google Analytics? שם הקהל יופיע שם בעמודת Medium.

איפה רואים את זה על הליד

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

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

אין שם שדות utm? הטופס לא שולח אותם, וצריך לתקן את החיבור. יש, אבל בשם קצת אחר (למשל UTM_Source או utm-source)? תקנו את שם השדה בטופס כך שיהיה בדיוק utm_source.

לידים שנכנסו לפני התיקון

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

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

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

5. שולחים ליד בדיקה

1. פתחו את דף הנחיתה, רצוי דרך קישור עם UTM, למשל ?utm_source=test&utm_campaign=bdika.
2. מלאו פרטי בדיקה ושלחו.
3. בטסקי, בטבלת הלידים, הליד מופיע תוך שניות. בעמודות מקור הגעה וקמפיין רואים את מה שהגיע.
4. לא הופיע? פתחו הגדרות → API לוג. כל בקשה שהגיעה לטסקי רשומה שם, עם הערכים שהתקבלו:

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

הליד הופיע עם מקור וקמפיין? החיבור מוכן. עכשיו נדאג שכל ליד כזה יקבל מכם הודעה.

6. הודעת וואטסאפ אוטומטית לכל ליד חדש

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

1. הכינו תבנית: הגדרות → תבנית הודעות. למשל: "שלום [[lead.name]], קיבלנו את הפנייה שלך מהאתר ונחזור אליך בהקדם." הפרמטר [[lead.name]] מתחלף בשם הליד ברגע השליחה. ראו תבניות הודעות.

2. פתחו הגדרות → טריגרים ולחצו הוספת טריגר חדש.
3. בשלב סוג ההפעלה בחרו ליד מ-API (חדש או חוזר) ולחצו המשך.

4. בשלב הגדרות בחרו לידים, בשלב שם וסיכום תנו שם, למשל "ברוכים הבאים - ליד מהאתר", ולחצו שמור טריגר.
5. בכרטיס של הטריגר לחצו + ובחרו שליחת וואטסאפ.
6. בחרו סוג נמען: ליד, ואת התבנית בתבנית הודעה. רוצים שזה ייראה אנושי יותר? סמנו תזמון עתידי וכתבו 2 דקות.
7. לחצו שמור שינויים.

לא "הוספה". סוג ההפעלה הוספה בטבלת הלידים לא רץ על לידים מטפסים ומחיבורים. לליד מדף נחיתה בחרו תמיד ליד מ-API (חדש או חוזר).

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

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

שאלות נפוצות

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

הליד הגיע, אבל בלי קמפיין ובלי מודעה. בכרטיס הליד, בלשונית מקורות, בדקו בערכים שהתקבלו אם שדות ה-utm הגיעו (סעיף 4). הסיבות הנפוצות:

• אין בטופס שדות נסתרים ל-UTM, או שב-Make הם לא מופו במודול הוספת ליד.
• הקישור של המודעה בלי UTM.
• המבקר עבר לעמוד אחר באתר לפני שמילא את הטופס, והפרמטרים כבר לא היו בכתובת.
• בטופס יש גם שדה source או campaign, שגובר על ה-UTM.

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

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

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

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

איך יודעים מאיזה דף נחיתה הגיע כל ליד? בכל דף שימו ערך אחר בשדה הנסתר channel (ערוץ התקשרות), למשל "דף נחיתה קיץ". הערך מופיע בלשונית מקורות של הליד, והוא לא מתנגש עם ה-UTM.

---

מדריכים קשורים: חיבור טופס וורדפרס · חיבור לידים חדשים מ-Make · לידים מפייסבוק · טריגרים ואוטומציות · תבניות הודעות · תיעוד API