חיבור רב מסר לטסקי דרך Make, כולל UTM

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

מה צריך:

• פרטי API מרב מסר (סעיף 1).
• חשבון ב-Make. עוד אין לכם? ראו חיבור Make.com לטסקי.
• הסאבדומיין של המערכת שלכם בטסקי (סעיף 2).

1. מבקשים מרב מסר פרטי API

פנו לתמיכה של רב מסר ובקשו פרטי API לחיבור ל-Make:

• User Key
• User Secret

איתם מחברים את חשבון רב מסר בתוך Make (סעיף 3).

2. מעתיקים מטסקי את הסאבדומיין

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

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

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

3. יוצרים תרחיש ב-Make ומחברים את רב מסר

1. ב-Make לחצו Create a new scenario, ובמסך העריכה לחצו על + כדי להוסיף מודול.
2. חפשו Rav Messer / Responder ובחרו את הטריגר New Subscriber Added (נמען חדש נוסף לרשימה).
3. בשדה Connection לחצו Create a connection.

4. תנו שם לחיבור, הזינו את User Key ואת User Secret שקיבלתם מרב מסר, ולחצו Save.

5. בשדה List Name בחרו את הרשימה שממנה הנמענים יעברו לטסקי, ולחצו Save.

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

4. מוסיפים את המודול של טסקי וממפים את השדות

1. לחצו על + מימין למודול של רב מסר, חפשו Taskey ובחרו אחד משני המודולים:

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

2. הזינו את הסאבדומיין מסעיף 2, בלי https:// ובלי .taskey.co.il.
3. מפו את השדות מתוך הנתונים של רב מסר: שם, טלפון ואימייל. כדי שייפתח ליד צריך לפחות אחד מהם.
4. מקור הגעה, קמפיין, קהל ומודעה ממלאים מפרמטרי ה-UTM (סעיף 6). אין לכם UTM? כתבו במקור הגעה ערך קבוע, למשל "רב מסר". שדה ריק = הליד ייכנס עם מקור ההגעה API.

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

5. שומרים ומריצים בדיקה

1. לחצו Save, ואז Run once.
2. הוסיפו לרשימה ברב מסר נמען לבדיקה, למשל הירשמו בעצמכם.
3. הכל תקין? ליד המודולים מופיע סימן ✔ ירוק, ומעליהם מספר הפעולות שבוצעו.

4. בדקו שהליד הגיע לטסקי (סעיף 7), והפעילו את התרחיש כדי שירוץ לבד.

6. מעבירים גם את ה-UTM: מקור, קמפיין, קהל ומודעה

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

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

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

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

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

שלב א: ה-UTM צריך להישמר ברב מסר

Make מעביר לטסקי רק מה שרב מסר שומר על הנמען.

1. ודאו שערכי ה-UTM נשמרים ברב מסר בשדות של הנמען, למשל שדות נוספים ברשימה בשם utm_source, utm_medium, utm_campaign ו-utm_content. איך טופס ההרשמה שומר UTM מגדירים ברב מסר. לא בטוחים? שאלו את התמיכה של רב מסר, כמו שביקשתם את פרטי ה-API.
2. בדקו: הירשמו לרשימה דרך קישור עם UTM. במקום example.com/signup שימו את כתובת דף ההרשמה שלכם, ואפשר להוסיף באותה צורה גם utm_medium ו-utm_content:

https://example.com/signup?utm_source=facebook&utm_campaign=workshop_october

3. אחרי Run once, לחצו על הבועה שמעל המודול של רב מסר. ערכי ה-UTM צריכים להופיע בנתוני הנמען. לא מופיעים? רב מסר לא שמר אותם, ואת זה מתקנים בצד של רב מסר.

שלב ב: ממפים את ה-UTM במודול של טסקי

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

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

ל-utm_term אין שדה במודול. צריכים אותו? שלחו ב-HTTP (שלב ג).

נמען שנרשם בלי UTM ייכנס עם מקור ההגעה API. כדי שיופיע אצלו "רב מסר", השתמשו בשדה מקור הגעה בפונקציה ifempty של Make: הערך הראשון הוא utm_source, והשני "רב מסר".

שלב ג (אפשרות נוספת): שליחה ישירה עם שמות ה-UTM

במקום המודול של טסקי אפשר להוסיף אחרי רב מסר מודול HTTP (Make a request), או לשלוח מכל מערכת שתומכת ב-Webhook. כך שולחים את שמות ה-UTM כמו שהם:

• כתובת: https://YOUR-SUBDOMAIN.taskey.co.il/webapi/AddLead.php (במקום YOUR-SUBDOMAIN - הסאבדומיין מסעיף 2)
• שיטה: POST
• גוף הבקשה: JSON או טופס (form-urlencoded). למשל:

{
  "name": "נגה",
  "last_name": "ברק",
  "phone": "0500001700",
  "email": "noga.barak@example.com",
  "utm_source": "facebook",
  "utm_medium": "paid_social",
  "utm_campaign": "workshop_october",
  "utm_content": "video_a"
}

• מנהל הפעיל לחייב טוקן API בקליטת ליד חדש (AddLead)? הוסיפו לבקשה את הכותרת הבאה, עם ה-API Key מסעיף 2:

Authorization: Bearer YOUR_API_KEY

שלחו כל ערך בשם אחד בלבד. אם באותה בקשה יש גם campaign או adset או ad, הם גוברים על שם ה-UTM, גם כשהם ריקים. source גובר על utm_source רק כשיש בו ערך.

7. בודקים שהליד הגיע עם ה-UTM

1. פתחו את הליד מטבלת הלידים ועברו ללשונית מקורות. בטבלה מקור הגעה אחרון מופיעים הערכים: facebook במקור הגעה, workshop_october בקמפיין, paid_social בקהל ו-video_a במודעה.

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

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

מה רואים	מה לבדוק
מקור הגעה הוא API	השדה מקור הגעה לא מופה, או שהנמען נרשם בלי utm_source.
קמפיין, קהל או מודעה ריקים, אבל בערכים שהתקבלו יש להם ערך בשם utm	באותה בקשה נשלח גם campaign או adset או ad ריק. הסירו אותו.
ערכי ה-UTM לא מופיעים בערכים שהתקבלו	הם לא יצאו מרב מסר או לא מופו. בדקו בבועה של המודול של רב מסר (שלב א) ואת המיפוי (שלב ב).
הליד לא הגיע בכלל	בדקו בלוג ה-API.

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