חיבור טופס וורדפרס לטסקי: Elementor, Contact Form 7 ועוד

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

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

המדריך מתאים ל-Elementor Pro, ל-Contact Form 7, ל-WPForms, ל-Gravity Forms ול-Fluent Forms. טופס שכתבתם בקוד, או דף נחיתה שלא בנוי בוורדפרס? ראו חיבור טופס מדף נחיתה.

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

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

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

3. מתחת לכתובת (Endpoint) לחצו על כפתור ההעתקה שמשמאל לכתובת.

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

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

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

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

2. שמות השדות: מה טסקי מזהה

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

מה נכנס לליד	שמות שטסקי מזהה
שם הלקוח	name, שם, שם מלא, first_name
שם משפחה	last_name
טלפון	phone, טלפון, נייד
אימייל	email, mail, אימייל, מייל
עיר	city, עיר
כתובת	address, כתובת, רחוב
השדה הערות בכרטיס הליד	description, הערות
תגובה בכרטיס הליד	comment
מקור הגעה, קמפיין, קהל ומודעה	פרמטרי ה-UTM, ראו סעיף 7
שדה מותאם	השם שלו במערכת, למשל Custom1. ראו סעיף 6

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

שמות שלא נקלטים

• הודעה, השם של שדה ההודעה בטופס ש-Elementor יוצר, לא נכנס לליד. הטקסט נשאר רק בלוג ה-API. שנו את שם השדה להערות או ל-comment.
• באנגלית אות גדולה לא מפריעה: Name, Phone, Email ו-City נקלטים כמו name, phone, email ו-city.
• "מספר טלפון", "כתובת מייל" או "E-mail" לא נקלטים. השתמשו בשמות מהטבלה.

3. Elementor Pro

מוסיפים פעולת Webhook

1. פתחו ב-Elementor את הדף עם הטופס, ולחצו על הטופס.
2. בהגדרות הטופס, בחלק פעולות לאחר שליחה (באנגלית: Actions After Submit), הוסיפו Webhook.
3. בחלק Webhook שנוסף, הדביקו את כתובת הקליטה בשדה כתובת Webhook. את דטא מתקדם השאירו על לא.

4. שמרו ופרסמו את הדף.

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

נותנים לכל שדה תווית שטסקי מזהה

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

שדה בלי תווית

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

1. לחצו על השדה ועברו ללשונית מתקדם שבתוכו.
2. בשדה ID כתבו phone, name או email. ID אוטומטי כמו field_15a5157 לא ייקלט.

שם הטופס נכנס כמקור ההגעה

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

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

4. Contact Form 7

ל-Contact Form 7 אין Webhook מובנה. צריך תוסף עזר, למשל CF7 to Webhook:

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

[text* name placeholder "שם מלא"]
[tel* phone placeholder "טלפון"]
[email email placeholder "אימייל"]
[textarea comment placeholder "איך נוכל לעזור?"]

5. WPForms, Gravity Forms ו-Fluent Forms

בתוספים האלה אתם בוחרים את השם שבו כל שדה יישלח.

ה-Webhook בשלושתם דורש גרסה בתשלום. ב-WPForms זה התוסף Webhooks, ב-Fluent Forms זו גרסת ה-Pro, ו-Gravity Forms כולו בתשלום.

תוסף	איפה מגדירים את ה-Webhook
WPForms	תוסף Webhooks. בעריכת הטופס: Settings → Webhooks
Gravity Forms	Webhooks Add-On. בהגדרות הטופס: Settings → Webhooks → Add New
Fluent Forms	בעריכת הטופס: Settings & Integrations, ושם Webhook

בכל אחד מהם:

1. הדביקו את כתובת הקליטה ב-Request URL, ובחרו בשיטה POST.
2. בגוף הבקשה (Request Body) בחרו לשלוח שדות נבחרים, ותנו לכל שדה מפתח באנגלית מהטבלה: name, phone, email.
3. שמרו, ושלחו טופס בדיקה (סעיף 8).

Form או JSON? לא משנה. טסקי מקבל את שני הפורמטים, אז אפשר להשאיר את ברירת המחדל של התוסף.

6. שדות מותאמים: שאלות נוספות בטופס

שאלה כמו "כמה עובדים יש לכם?" נשמרת בשדה מותאם של הליד:

1. צרו שדה מותאם בטסקי: תפריט לידים → עריכת שדות. ראו שדות מותאמים.
2. לכל שדה יש שם קבוע במערכת, כמו Custom1 או Custom2. את השמות של השדות שלכם רואים גם בעמוד תיעוד API → הוספת ליד, בטבלה שדות מותאמים אישית.
3. תנו לשדה בטופס את השם הזה: ב-Elementor כתווית (או כ-ID, בשדה בלי תווית), ובתוספים האחרים כמפתח.

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

UTM הם פרמטרים שמוסיפים לקישור של המודעה, למשל:

https://example.co.il/?utm_source=facebook&utm_campaign=webinar

טסקי שומר אותם בשדות השיווק של הליד:

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

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

מה גובר על מה

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

שדה נסתר ב-Elementor

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

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

5. חזרו על זה עבור utm_source, utm_medium ו-utm_content, ושמרו את הדף.

בתוספים האחרים

מוסיפים שדה נסתר (Hidden) לכל פרמטר. כך קוראים את utm_campaign מהכתובת: ב-Contact Form 7 זו שורה בתוך הטופס, וב-WPForms וב-Fluent Forms זה הערך שכותבים ב-Default Value של השדה:

Contact Form 7:                [hidden utm_campaign default:get]
WPForms (Default Value):       {query_var key="utm_campaign"}
Fluent Forms (Default Value):  {get.utm_campaign}

ב-Gravity Forms: בשדה ה-Hidden עברו ללשונית Advanced, סמנו Allow field to be populated dynamically, ובשם הפרמטר כתבו utm_campaign.

שם המפתח שנשלח לטסקי צריך להיות שם הפרמטר, למשל utm_campaign.

8. בודקים שהליד הגיע

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

https://example.co.il/landing?utm_source=test&utm_campaign=bdika

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

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

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

מה רואים בעמודה ליד שנוצר	מה זה אומר
ליד נוצר, ומתחת lead add	נפתח ליד חדש. לחיצה על השם פותחת אותו
ליד נוצר, ומתחת lead duplicate	הליד כבר קיים (אותו טלפון או אימייל), והפנייה נרשמה אצלו
ללא ליד, ומתחת no name, phone or mail	לא נמצאו שם, טלפון או אימייל. בדקו את שמות השדות (סעיף 2) ואת דטא מתקדם
ללא ליד, ומתחת same lead create 1 minute ago	אותה פנייה נשלחה פעמיים בתוך דקה. השנייה לא נקלטה
אין שורה בכלל	הבקשה לא הגיעה לטסקי. בדקו את הכתובת, ושפעולת ה-Webhook נשמרה בטופס

9. חיבור דרך Make

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

1. ב-Make צרו תרחיש שמתחיל במודול Webhooks → Custom webhook, והעתיקו את הכתובת שלו.
2. הדביקו אותה בטופס, במקום כתובת הקליטה של טסקי.
3. הוסיפו לתרחיש את המודול הוספת ליד של אפליקציית טסקי, ומפו אליו את השדות. החיבור מבקש את הסאבדומיין ואת ה-API Key. שניהם בעמוד תיעוד API, בתפריט הצד: מפתח API וחיבור.

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

שאלות נפוצות

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

הליד הגיע, אבל בלי הטלפון או בלי ההודעה. התווית של השדה לא מוכרת לטסקי, למשל "מספר טלפון", "E-mail" או "הודעה". בלוג ה-API רואים באיזה שם השדה הגיע. שנו את התווית לשם מהטבלה בסעיף 2.

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

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

אפשר לשלוח לליד הודעת וואטסאפ אוטומטית? כן, בטריגר מסוג ליד מ-API (חדש או חוזר). ההוראות: הודעת וואטסאפ אוטומטית לכל ליד חדש.

---

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