פורמט נתוני השיחות

ב-Customer Experience Insights נעשה שימוש בנתוני שיחות שאתם מעלים לקטגוריה של Cloud Storage. אפשר לספק את נתוני השיחות ל-API כקובצי אודיו או טקסט.

נתוני תמליל השיחה

קבצי הטקסט כוללים את הפרטים הבאים.

שיחה

האובייקט ברמה העליונה של נתוני השיחה.

שדה	סוג	תיאור
conversation_info	ConversationInfo { }	זה שינוי אופציונלי. מטא-נתונים של השיחה.
entries	ערך [ ]	חובה. ההודעות בשיחה, בסדר כרונולוגי.

ConversationInfo

המטא-נתונים של השיחה.

שדה	סוג	תיאור
קטגוריות	קטגוריה [ ]	זה שינוי אופציונלי. קטגוריות מותאמות אישית לנתוני השיחה.

קטגוריה

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

שדה	סוג	תיאור
display_name	מחרוזת	חובה. השם המוצג של הקטגוריה.

הערך

נתונים של הודעה אחת בשיחה.

שדה	סוג	תיאור
טקסט	מחרוזת	חובה. הטקסט של הודעת השיחה.
user_id	מספר שלם	חובה. מספר שמזהה את המשתתף בשיחה. לכל משתתף צריך להיות מזהה user_id יחיד, שבו הוא משתמש שוב ושוב אם הוא משתתף בכמה שיחות.
תפקיד	מחרוזת	חובה. התפקיד של המשתתף בשיחה. אחת מהאפשרויות הבאות: AGENT,‏ AUTOMATED_AGENT,‏ CUSTOMER,‏ END_USER.
start_timestamp_usec	מספר שלם	חובה. חותמת הזמן של תחילת תור השיחה במיקרו-שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch).

דוגמה

בהמשך מוצגת דוגמה לקובץ נתוני שיחה.

{
  "conversation_info":{
    "categories":[
      {
        "display_name":"Category 1"
      }
    ]
  },
  "entries": [
    {
      "start_timestamp_usec": 1000000,
      "text": "Hello, I'm calling in regards to ...",
      "role": "CUSTOMER",
      "user_id": 1
    },
    {
      "start_timestamp_usec": 5000000,
      "text": "Yes, I can answer your question ...",
      "role": "AGENT",
      "user_id": 2
    }
  ]
}