משתני הודעה

אפשר להתאים אישית כל הודעת מסע (אימייל, SMS, פוש, וואטסאפ, webhook) באמצעות מצייני מקום של Liquid. משתנה ללא ערך מוצג כטקסט ריק - זו אף פעם לא שגיאה.

שני מרחבי השמות של אירועים

במסעות יש שני מרחבי שמות של אירועים, וההבדל חשוב:

• trigger - איך הם נכנסו. אירוע הכניסה, קבוע לאורך כל הריצה.
• event - הדבר האחרון שהם עשו. האירוע האחרון שקידם את המסע, למשל התשובה שפתרה פיצול לפי התנהגות (Behavior Split). הוא מתחיל שווה ל-trigger, ואז מתעדכן בכל פעם ששלב המתנה מסתיים.

לכן עבור "מה הלקוח השיב כרגע" השתמשו ב-event (או בקיצורי reply שלמטה) - לא ב-trigger.

משתמש - מאפייני ברירת מחדל מול מותאמים

מאפייני ברירת מחדל - שדות סטנדרטיים, נכתבים כ-{{ user.firstName }}:

משתנה	ערך
user.firstName, user.lastName	מאפייני שם
user.email, user.phone	שדות יצירת קשר
user.id	המזהה הפנימי של Joryio לאיש הקשר
user.externalId	המזהה החיצוני שלכם
user.whatsappName	שם הפרופיל בוואטסאפ המסונכרן לאיש הקשר

מאפיינים מותאמים - כל שאר המאפיינים של איש הקשר, תחת מרחב השם custom, למשל {{ user.custom.plan }}:

משתנה	ערך
user.custom.<attribute>	כל מאפיין מותאם (למשל user.custom.plan)

הערה

הצורה השטוחה הישנה {{ user.<attribute> }} עדיין עובדת (תאימות לאחור), אך {{ user.custom.<attribute> }} היא הדרך המומלצת להפניה למאפיינים מותאמים - כך קל להבחין ביניהם ובין שדות ברירת המחדל.

הערה

שמות מאפייני ברירת המחדל שמורים - אי אפשר ליצור מאפיין מותאם באותו שם כמו שדה ברירת מחדל (למשל email, country, firstName), כך שהשניים לעולם לא מתנגשים והבורר אף פעם לא מציג שם פעמיים.

הוספת משתנים

בעורכי הוואטסאפ, ה-SMS, הפוש וה-webhook יש כפתור + Personalize שפותח את חלון Add Personalization. בחרו סוג, בחרו את המאפיין, הוסיפו ערך ברירת מחדל לפי הצורך, ואז לחצו Insert כדי להוסיף את הקטע שנוצר:

• Latest event - האירוע האחרון שקידם את המסע. בחרו source: Reply (WhatsApp) (הקיצורים הנוחים reply.*) או Custom event (event.*).
• Trigger (entry) - איך הם נכנסו. בחרו source: WhatsApp message או Custom event.
• Default attributes - {{ user.firstName }}, {{ user.email }} ושאר שדות ברירת המחדל (אותה רשימה כמו בבורר "default attribute" של הסגמנט).
• Custom attributes - רק המאפיינים המותאמים של הארגון (שדות ברירת המחדל מופיעים תחת הסוג שלהם ואינם מופיעים בשתי הקבוצות), מוכנסים כ-{{ user.custom.<attribute> }}.
• Product catalog - רשומות מקטלוג החנות המסונכרן באמצעות סינון מוצרים, מוכנסות כתג assign כמו {% assign products = 'featured' | products %}; לאחר מכן עוברים על הרשומות בלולאה עם {% for item in products %} … {% endfor %}.
• Custom entity - רשומות מישות מותאמת באמצעות סינון שמור, מוכנסות כ-{% assign items = 'tv_series' | entity: 'latest' %} ועוברים עליהן בלולאה באותו אופן.

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

אימייל והודעות באפליקציה (in-app)

לעורכים הוויזואליים של האימייל והin-app יש כפתור Personalization שפותח את אותו בורר במצב העתקה: בנו את הקטע, העתיקו אותו, והדביקו אותו בכל מקום שתרצו בעיצוב. (Reply / Latest event / Trigger לא מוצעים שם - הם מקבלים ערך רק בתוך מסע.)

טריגר (אירוע הכניסה)

משתנה	ערך
trigger.properties.<field>	כל מאפיין שנכלל באירוע הכניסה
trigger.properties.content.text	טקסט נכנס, אם הכניסה הייתה הודעת וואטסאפ

אירוע (האירוע האחרון שקידם) וקיצורי reply

אחרי פיצול לפי התנהגות שממתין לתשובה, event הוא אותה תשובה. המשתנים המקוצרים reply נוחים להודעות נכנסות - הם עובדים באותו אופן גם לתשובת וואטסאפ וגם לתשובת SMS. אחרי פיצול לפי התנהגות מסוג SMS Inbound Message, reply.text הוא טקסט ה-SMS הנכנס האחרון של איש הקשר.

משתנה	קיצור	ערך
event.properties.content.text	reply.text	טקסט התשובה
event.properties.type	reply.type	סוג ההודעה הנכנסת (טקסט, תמונה, כפתור…)
event.properties.profile.name	reply.profile.name	שם הפרופיל בוואטסאפ
event.name	-	שם האירוע
event.properties.<field>	-	כל מאפיין אחר שנלכד

דוגמה - תשובת וואטסאפ אחרי פיצול לפי התנהגות

Thanks {{ reply.profile.name | default: "there" }} - you said
"{{ reply.text }}". We'll follow up shortly.

טיפ

השתמשו ב-trigger.* עבור איך הם נכנסו וב-event.* / reply.* עבור מה הם עשו זה עתה. במסע עם כניסה מתוזמנת אין ל-trigger תוכן נכנס - התשובה אחרי הפיצול נמצאת ב-event / reply.