חיבור Zapier לטסקי

Zapier מחבר בין אלפי אפליקציות. אין בו אפליקציה מוכנה של טסקי, ולכן מתחברים עם Webhooks by Zapier, שעובד מול ה-API של טסקי בשני הכיוונים:

• לידים לטסקי - Zap ששולח כל פנייה חדשה (טופס, רשימת תפוצה, מערכת אחרת) לכתובת הקליטה של טסקי.
• מטסקי ל-Zapier - טריגר בטסקי שמעביר ל-Zapier ליד חדש או שינוי סטטוס, ומשם לכל אפליקציה.

לפני שמתחילים Webhooks by Zapier לא זמין בחבילה החינמית של Zapier, רק בחבילות בתשלום. עובדים עם Make, או עוד לא בחרתם? ב-Make יש לטסקי אפליקציה מוכנה, בלי כתובות ובלי שמות שדות - ראו חיבור Make.com לטסקי.

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

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

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

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

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

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

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

2. בונים Zap ששולח לידים לטסקי

1. ב-Zapier לחצו Create ובחרו Zaps.
2. Trigger: בחרו את האפליקציה שממנה מגיעים הלידים ואת האירוע, למשל Typeform ו-New Entry. חברו את החשבון ובחרו את הטופס. שלחו בטופס פניית בדיקה עם הטלפון שלכם ושם כמו "בדיקה Zapier", לחצו Test trigger ובחרו אותה.
3. Action: בחרו Webhooks by Zapier, ובאירוע (Action event) בחרו POST.
4. מלאו את ההגדרות של הפעולה:

השדה ב-Zapier	מה כותבים
URL	כתובת הקליטה מסעיף 1
Payload Type	Form. גם JSON עובד: טסקי מקבל את שניהם
Data	שורה לכל שדה. בצד אחד שם השדה בטסקי, למשל name או phone, ובצד השני הערך מהטריגר. השמות בסעיף 3
Headers	ריק. רק אם מנהל הפעיל חיוב טוקן, ראו סעיף 6

את שאר השדות השאירו כמו שהם.

5. לחצו Test step. Zapier שולח לטסקי את פניית הבדיקה ומציג את התשובה. כשב-status מופיע success וב-message מופיע lead add, נפתח ליד.
6. לחצו Publish. מעכשיו כל פנייה חדשה נכנסת לטסקי לבד.

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

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

• no name, phone or mail ב-message אומר שאף שדה לא זוהה. בדקו את השמות ב-Data.
• שדה error בתשובה אומר שהפנייה נחסמה: spam או flood בסינון הספאם, blacklist ברשימת אל-תפנה. פנייה כזו לא נרשמת בלוג ה-API.

אל תשאירו את Data ריק. כש-Data ריק, Zapier שולח את כל השדות מהטריגר בשמות שלהם באפליקציה, למשל "Full Name", וטסקי בדרך כלל לא מזהה אותם.

3. שמות השדות ב-Data

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

שם השדה (Key)	מה נכנס בטסקי
name	שם הלקוח
last_name	שם משפחה
phone	טלפון
phone2	טלפון נוסף
email	אימייל
city	עיר
address	כתובת
IdNumber	ת.ז / ח.פ
description	השדה הערות בכרטיס הליד
comment	תגובה בכרטיס הליד. comment1 עד comment4 מתווספים לאותה תגובה, כל אחד בשורה חדשה
source	מקור הגעה. לא נשלח? הליד נכנס עם המקור API
campaign	קמפיין
adset	קהל
ad	מודעה
channel	ערוץ התקשרות, בלשונית מקורות בכרטיס הליד
status	הסטטוס של הליד: המספר של הסטטוס, לא השם
user_id	הנציג המשויך: מספר המשתמש שלו
Custom1, Custom2...	השדות המותאמים שלכם

• status (נקלט גם בשם status_id): את המספר של כל סטטוס רואים בעמודה # במסך עריכת סטטוסים (תפריט לידים → עריכת סטטוסים). בלי status, או עם שם במקום מספר, הליד נכנס בסטטוס של ליד חדש.
• user_id: לא בטוחים מה המספר? השאירו ריק. הליד ישויך לפי שיוך נציגים, אם הוגדר - ראו התראה לנציג על ליד שקיבל.
• שדות מותאמים: השם של כל שדה (Custom1, Custom5...) מופיע בעמוד תיעוד API → הוספת ליד, בטבלה שדות מותאמים אישית.
• שמות חלופיים: טסקי מזהה גם שמות נוספים, למשל first_name במקום name ו-mail במקום email. גם שמות UTM נקלטים: utm_source למקור ההגעה ו-utm_campaign לקמפיין. ב-Zapier אתם כותבים את השמות בעצמכם, אז פשוט השתמשו בשמות שבטבלה. מיפוי ה-UTM המלא: חיבור טופס מדף נחיתה. הרשימה הטכנית המלאה: תיעוד ה-API.

אותיות גדולות וקטנות phone נקלט רק באותיות קטנות: Phone עם P גדולה לא נקלט. שמות כמו "Full Name" או "Phone Number" לא נקלטים בכלל. העתיקו את השמות מהעמודה הראשונה בטבלה.

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

הליד מופיע בטבלת הלידים, בסטטוס ליד חדש (אלא אם שלחתם status). בעמודות מקור הגעה וקמפיין רואים מה נשלח מ-Zapier, ותגובות מציגה את מה שנשלח ב-comment.

בכרטיס הליד, בלשונית מקורות, רואים גם את ערוץ התקשרות ואת כל הערכים שהתקבלו. הסבר על הלשונית: חיבור לידים חדשים מ-Make.

הליד לא הגיע? לוג ה-API

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

בדוגמה, הבדיקה הראשונה (למטה) נשלחה עם שמות השדות מהטופס. בלוג הם מופיעים כ-Full_Name ו-Phone_Number, וטסקי לא זיהה אותם. אחרי שהשמות ב-Data תוקנו ל-name, phone ו-email, הבדיקה השנייה פתחה ליד.

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

5. מטסקי ל-Zapier: ליד חדש או שינוי סטטוס

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

1. ב-Zapier צרו Zap חדש. ב-Trigger בחרו Webhooks by Zapier, ובאירוע Catch Hook. Zapier נותן כתובת שמתחילה ב-https://hooks.zapier.com/hooks/catch. העתיקו אותה.
2. בטסקי פתחו הגדרות → טריגרים, ובחרו טריגר קיים או צרו חדש (איך בונים טריגר). לכל ליד חדש מטופס או מחיבור בחרו בסוג ההפעלה ליד מ-API (חדש או חוזר). לליד שעבר לסטטוס מסוים בחרו שינוי בשדה סטטוס.
3. בכרטיס של הטריגר לחצו +, ובשלב סוג פעולה בחרו Webhook.
4. בשלב הגדרות הפעולה הדביקו את הכתובת מ-Zapier בשדה כתובת URL. את שיטת שליחה השאירו על POST (JSON), ולחצו שמור שינויים.

5. הפעילו את הטריגר פעם אחת, לפי סוג ההפעלה שבחרתם:

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

6. ב-Zapier לחצו Test trigger, ו-Zapier יציג את הנתונים שטסקי שלח. לא הגיע כלום? פתחו את כרטיס ליד הבדיקה, ובטאב טריגרים בדקו אם הטריגר רץ: טריגר לא עבד?
7. הוסיפו ל-Zap את הפעולה שאתם צריכים, למשל הודעה בערוץ Slack או שורה בגיליון, ולחצו Publish.

רוצים ב-Zapier רק כמה שדות, בשמות ברורים? פורמט Payload בברירת המחדל שולח את כל פרטי הרשומה. בחרו תבנית מותאמת (JSON) ושלחו רק את מה שצריך, למשל {{name}}, {{phone}} ו-{{status_name}}. רשימת המשתנים: טריגרים.

6. חיוב טוקן (למנהלים)

כברירת מחדל כתובת הקליטה פתוחה, בלי מפתח. מנהל החשבון יכול לחייב מפתח: הגדרות → ליד חדש — קליטה והתראות → לשונית הגדרות קליטה → לחייב טוקן API בקליטת ליד חדש (AddLead).

אחרי שמפעילים את זה, כל Zap ששולח לידים צריך לשלוח את המפתח. בפעולת ה-POST ב-Zapier, תחת Headers, הוסיפו שורה:

בצד של השם	בצד של הערך
Authorization	Bearer ואחריו רווח וה-API Key

את ה-API Key מעתיקים מהכרטיס חיבור ומפתחות בעמוד תיעוד API (בצילום בסעיף 1). העין מציגה אותו, וכפתור ההעתקה מעתיק אותו. בלי הכותרת, הבדיקה ב-Zapier נכשלת ובתשובה מופיע TOKEN_MISSING. עם מפתח שגוי מופיע TOKEN_INVALID. בשני המקרים הליד לא נפתח, ובלוג ה-API אין שורה.

שמרו על ה-API Key כמו על סיסמה. מי שמחזיק בו יכול להוסיף ולקרוא נתונים בחשבון. הדביקו אותו רק בשדה Headers של ה-Zap.

7. Zapier או Make?

	Zapier	Make
אפליקציה של טסקי	אין. מתחברים עם Webhooks	יש: Taskey crm system, עם מודולים מוכנים
שמות השדות	כותבים בעצמכם (name, phone...)	בוחרים מרשימה. נציגים, סטטוסים ושדות מותאמים נטענים מהמערכת
מטסקי החוצה	טריגר בטסקי עם פעולת Webhook	טריגרים מוכנים באפליקציה, כמו ליד חדש ושינוי סטטוס
חבילה חינמית	Webhooks לא זמינים בה	אפשר להתחיל בה

כבר עובדים עם Zapier? החיבור עובד מצוין. מתחילים מאפס? עם Make החיבור לטסקי פשוט יותר - ראו חיבור Make.com לטסקי.

שאלות נפוצות

אפשר להשתמש ב-Zapier בחינם? לא לחיבור הזה. Webhooks by Zapier זמין רק בחבילות בתשלום של Zapier.

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

הליד נכנס עם מקור ההגעה "API". למה? ב-Data אין שורה בשם source. הוסיפו אותה, עם שם המקור, למשל Typeform.

צריך Zapier בשביל לידים מפייסבוק, או כדי לכתוב כל ליד חדש לגיליון Google Sheets? לא. לשניהם יש חיבור ישיר, בלי Zapier: חיבור לידים מפייסבוק וחיבור לידים ל-Google Sheets.