מאפייני איש קשר

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

סקירה כללית#

מאפייני אנשי קשר מאפשרים לכם לצרף לשיחות נתונים מובְנים מעבר לשדות המובנים (email, name, userId). בשונה מ- metadata החופשי, למאפיינים יש סכימה מוגדרת עם טיפוסים, תוויות ותיקוף — בדומה לשדות מותאמים אישית ב-HubSpot או Salesforce.

הגדרת סכימה

צרו הגדרות מאפיינים בהגדרות הסוכן עם טיפוסים כמו string, number, enum, boolean, date, url

העברה מהווידג׳ט

שלחו ערכי מאפיינים דרך Respondo.identify() — הם נשמרים ומוצגים אוטומטית

סינון ועריכה

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

הגדרת מאפיינים#

המאפיינים מוגדרים לכל סוכן ב-הגדרות הסוכן → מאפייני אנשי קשר. לכל מאפיין יש:

שדה	תיאור
key	מזהה ייחודי שמשמש בקוד. נוצר אוטומטית מהתווית (ניתן לעריכה). אותיות קטנות, ספרות וקווים תחתונים; חייב להתחיל באות; 2–63 תווים. מפתחות מערכת (`user_id`, `visitor_id`, `timezone`, `page_url`, …) שמורים. דוגמה: `account_type`
label	שם קריא לבני אדם המוצג בלוח הבקרה. דוגמה: "Account Type"
type	טיפוס הערך: `string`, `number`, `boolean`, `enum`, `date`, `url`
enum_values	עבור טיפוס `enum` — רשימת הערכים המותרים. דוגמה: `["starter", "pro", "enterprise"]`
is_filterable	שמור לשליטת סינון עתידית; נשמר עם ההגדרה, אך בורר המסננים בתיבת הפניות מציג כיום את כל המאפיינים המוגדרים (ברירת מחדל: true)
is_visible	שמור לשליטת תצוגה עתידית; נשמר עם ההגדרה אך אינו נאכף עדיין בממשק (ברירת מחדל: true)

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

העבירו ערכי מאפיינים בשדה properties של Respondo.identify(). המפתחות חייבים להתאים להגדרות המאפיינים מהגדרות הסוכן.

שילוב הווידג׳טjavascript

Respondo.identify({
  email: 'user@example.com',
  name: 'Jane Smith',
  userId: 'usr_456',
  properties: {
    account_type: 'enterprise',   // enum
    region: 'eu-west',            // string
    monthly_spend: '15000',       // число (מועבר כמחרוזת)
    is_partner: 'true',           // boolean (מועבר כמחרוזת)
    contract_end: '2026-12-31',   // תאריך
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

כל ערכי המאפיינים מועברים כמחרוזות. לוח הבקרה מטפל בתצוגה לפי הטיפוס (למשל, boolean → כן/לא, url → קישור לחיץ, enum → תג).

קטע קוד לשילוב#

קטע הקוד לשילוב מופיע אוטומטית תחת הגדרות הסוכן → מאפייני אנשי קשר ברגע שהגדרתם לפחות מאפיין אחד, עם כל מפתחות המאפיינים שלכם ממולאים מראש. לחצו על העתק כדי לקחת אותו ולהדביקו ביישום שלכם. הקטע שנוצר כולל גם placeholder של userHash לאימות זהות (HMAC-SHA256).

כיצד נשמרים הערכים#

ערכי המאפיינים נשמרים בשדה metadata מסוג JSONB של השיחה עם קידומת cp_. למשל, מאפיין עם המפתח account_type נשמר בתור cp_account_type.

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

סינון בתיבת הפניות#

סננו שיחות לפי ערכי מאפיינים באמצעות סרגל המסננים של תיבת הפניות או תצוגה שמורה. הוסיפו תנאי Property, בחרו את המאפיין לפי שמו — הבורר מציג כל הגדרה מכל הסוכנים שלכם ומקבל גם מפתח גולמי ללא הגדרה — ואז בחרו ערך. שדה הערך מציע ערכים שנצפו וכל ערכי ה-enum תוך כדי הקלדה.

דרך ה-API, נקודות הקצה של רשימת השיחות מקבלות פרמטר שאילתה cp.<key>=<value> (כינוי מדויק ל- attr.<key>). אין תחביר שאילתות בטקסט חופשי:

GET /api/v1/conversations?cp.account_type=enterprise

עריכת ערכים#

ערכי המאפיינים נקבעים על ידי היישום שלכם — דרך שילוב הווידג׳ט או ה-API — והם לקריאה בלבד בפאנל פרטי השיחה. הפאנל מקשר לפרופיל איש הקשר, שבו המפעילים יכולים לצפות ולערוך את מאפייני איש הקשר (אנשי קשר → איש קשר → Attributes).

מאפיינים לעומת metadata

תכונה	properties	metadata
סכימה	מוגדרת בהגדרות הסוכן עם טיפוסים	זוגות מפתח-ערך חופשיים
ניתן לסינון	כן, דרך סרגל המסננים / תצוגות שמורות (API: פרמטר `cp.<key>`)	לא
ניתן לעריכה בידי מפעילים	לא — הערכים מגיעים מהיישום שלכם; מאפייני איש קשר נערכים בפרופיל איש הקשר	לא
תצוגה מוטיפסת	כן (תגים, קישורים, תאריכים, ערכים בוליאניים)	טקסט פשוט בלבד
השלמה אוטומטית	כן, הצעות ערכים בשדה ערך המסנן	לא

השתמשו ב-metadata לשדות אד-הוק שאינם זקוקים לסינון או לתצוגה מוטיפסת. השתמשו ב-properties לנתונים מובְנים שהצוות שלכם ישתמש בהם באופן פעיל לפילוח ולתהליכי עבודה.