חיבור לידים חדשים מ-Make לטסקי

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

מה צריך:

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

1. יוצרים בטסקי מפתח API ל-Make

Make צריך שני פרטים מטסקי: מפתח API וסאבדומיין. מתחילים במפתח.

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

2. לחצו מפתח חדש.

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

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

5. לחצו שמירה. המפתח המלא (מתחיל ב-tk_) מוצג פעם אחת בלבד. העתקו אותו בכפתור ההעתקה, שמרו אותו עד שתדביקו אותו ב-Make, ולחצו העתקתי, סיימנו.

6. עכשיו הסאבדומיין: חזרו להגדרות ולחצו API (מעל מפתחות API). בעמוד תיעוד API, בראש תפריט הצד, לחצו מפתח API וחיבור. תחת סאבדומיין (MAKE) מופיע שם המערכת שלכם, עם כפתור העתקה. זה החלק הראשון בכתובת שלה (למשל demo בכתובת demo.taskey.co.il).

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

כבר יש לכם חיבור פעיל ב-Make? הוא ממשיך לעבוד גם בלי מפתח חדש. בטבלת המפתחות הוא מופיע כמפתח החשבון (ישן), שאי אפשר להציג אותו יותר. מומלץ ליצור מפתח חדש עם ההרשאות שלמעלה, לעדכן אותו בחיבור ב-Make, ורק אז לבטל את הישן.

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

2. מתקינים את אפליקציית טסקי ב-Make

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

3. בונים את התרחיש ב-Make

1. צרו תרחיש חדש. המודול הראשון הוא המקום שממנו מגיע הליד, למשל טופס לידים בפייסבוק, Webhook שמקבל את הטופס מהאתר, או שורה חדשה בגוגל שיטס.
2. הוסיפו אחריו מודול, חפשו Taskey ובחרו הוספת ליד (בקבוצה לידים).
3. בשדה החיבור (Connection) לחצו Add (בגרסאות חדשות של Make: Create a connection) ומלאו:

• subdomain - הסאבדומיין שהעתקתם, בלי https:// ובלי סיומת הדומיין (.taskey.co.il).
• API Key - המפתח שיצרתם בסעיף 1 (מתחיל ב-tk_).
• דומיין המערכת (בהגדרות המתקדמות) - השאירו taskey.co.il. המערכת שלכם נמצאת בכתובת אחרת, למשל tooki.co.il? בחרו אותה מהרשימה.

Make בודק את החיבור מול טסקי ושומר אותו. מעכשיו אפשר לבחור את אותו חיבור בכל מודול של טסקי.

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

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

4. מה ממלאים במודול "הוספת ליד"

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

השדה ב-Make	איפה זה מופיע בטסקי	כדאי לדעת
שם, שם משפחה	שם הלקוח, שם משפחה	השם המלא כבר בשדה שם? השאירו את שם משפחה ריק.
טלפון	טלפון	לפי הטלפון, או לפי האימייל, המערכת מזהה ליד שכבר קיים (ראו סעיף 7).
אימייל, טלפון נוסף, עיר, כתובת	בשדות באותו שם
תעודת זהות	ת.ז / ח.פ
הוספת תגובה	תגובה בכרטיס הליד, מאת מערכת	מתאים לתשובות מהטופס או משאלון.
מקור הגעה	מקור הגעה	שם הפלטפורמה: פייסבוק, גוגל, אתר. ריק? הליד ייכנס עם מקור ההגעה API.
קמפיין	קמפיין	מטופס פייסבוק: Campaign name. מהאתר: למשל שם העמוד.
קהל	קהל	מטופס פייסבוק: Adset name.
מודעה	מודעה	מטופס פייסבוק: Ad name.
ערוץ התקשרות	ערוץ התקשרות (בלשונית מקורות)	למשל אתר או וואטסאפ.
פייסבוק Lead ID	הכפתור צפייה במודעה בלשונית מקורות	מזהה הליד בטופס הלידים של פייסבוק. הכפתור מציג את המודעה עצמה, אם המערכת מחוברת לפייסבוק.
שיוך למשתמש	נציג משוייך	בוחרים נציג מהרשימה. אפשר להשאיר ריק ולתת לטסקי לשייך לפי הגדרות השיוך.
סטטוס	סטטוס	בוחרים מהרשימה. ריק = סטטוס ברירת המחדל לליד חדש.
שדות מותאמים אישית	השדות המותאמים שלכם	לכל שורה בוחרים את שם השדה וממלאים ערך.

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

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

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

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

3. בלשונית מקורות רואים את כל התמונה:

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

6. הליד לא הגיע? בודקים בלוג ה-API

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

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

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

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

תקלות נפוצות ב-Make:

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

7. ליד שכבר קיים, וחיוב טוקן (למנהלים)

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

אפשר לשנות את ההתנהגות הזו: הגדרות → ליד חדש — קליטה והתראות → לשונית הגדרות קליטה.

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

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