מתאם הסוכן יכול להשתמש ב-API של הדפדפן postMessage() כדי לשלוח אירועים ל-iFrame הראשי. אפשר להשתמש באירועים האלה ב-JavaScript ב-iFrame הראשי כדי לבצע פעולות שונות בהטמעה של ה-CRM בהתאמה אישית. כדי לעשות את זה, האפליקציה צריכה להאזין ל-MessageEvent בחלון הראשי. בהתבסס על האירועים, האפליקציה יכולה להפעיל פעולות כמו פתיחת כרטיסייה של כרטיס תמיכה למזהה סשן ספציפי. גם מתאם השיחות וגם מתאם הצ'אט כוללים אירועים ספציפיים שאפשר להשתמש בהם כדי לשפר את היכולות של מערכת ה-CRM.
פלטפורמת Contact Center AI תומכת באירועים הבאים של עוזר וירטואלי לביצוע משימות:
עוזר וירטואלי הצטרף
העוזר הווירטואלי למשימות עזב
משתני סשן מותאמים אישית שהתקבלו מעוזר וירטואלי למשימות
רשימה מלאה של אירועים שקשורים למתאמי סוכנים מופיעה במאמר בנושא מתאמי סוכנים.
עוזר וירטואלי הצטרף
האירוע הזה מועבר כשעוזר וירטואלי למשימות מצטרף לסשן.
שדות נתונים
call_id. המזהה של סשן קולי (IVR).
chat_id. המזהה של סשן צ'אט באתר או בנייד.
campaign_id: המזהה של שיחה בקמפיין.
campaign_name: שם הקמפיין.virtual_agent_id: המזהה של העוזר הווירטואלי.
virtual_agent_name: השם של העוזר הווירטואלי לביצוע משימות.
participant_id: מזהה המשתתף של העוזר הווירטואלי למשימות.
queue_id: המזהה של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_path: הנתיב של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_language_id: השפה של התור שממנו התחיל הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
session_type: סוג הסשן – לדוגמה, הודעות נכנסות דרך צ'אט באתר.
conversation_id: המזהה של סשנים של סוכנים וירטואליים שמשתמשים בפרופילים של שיחות.
session_id: המזהה של סשנים של נציג וירטואלי שלא משתמשים בפרופילים של שיחות.timestamp: התאריך והשעה של אירוע.
data_parameters: המשתנים שהוגדרו בפורטל של פלטפורמת CCAI ונשלחו לעוזר הווירטואלי.
דוגמה למטען ייעודי (payload)
{
"type": "Task_VA_Joined",
"data": {
"chat_id": 103646,
"campaign_id": 1432,// omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
}
}
}
העוזר הווירטואלי למשימות עזב
האירוע הזה מועבר כשעוזר וירטואלי למשימות יוצא מהסשן.
שדות נתונים
call_id. המזהה של סשן קולי (IVR).
chat_id. המזהה של סשן צ'אט באתר או בנייד.
campaign_id: המזהה של שיחה בקמפיין.
campaign_name: שם הקמפיין.virtual_agent_id: המזהה של העוזר הווירטואלי.
virtual_agent_name: השם של העוזר הווירטואלי לביצוע משימות.
participant_id: מזהה המשתתף של העוזר הווירטואלי למשימות.
queue_id: המזהה של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_path: הנתיב של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_language_id: השפה של התור שממנו התחיל הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
session_type: סוג הסשן – לדוגמה, הודעות נכנסות דרך צ'אט באתר.
conversation_id: המזהה של סשנים של סוכנים וירטואליים שמשתמשים בפרופילים של שיחות.
session_id: המזהה של סשנים של נציג וירטואלי שלא משתמשים בפרופילים של שיחות.timestamp: התאריך והשעה של אירוע.
finish_reason: הסיבה לסיום הסשן עם הנציג הווירטואלי.
data_parameters: המשתנים שהוגדרו בפורטל של פלטפורמת CCAI ונשלחו לעוזר הווירטואלי.
captured_variables: משתני הסשן שנתפסו על ידי העוזר הווירטואלי.
דוגמה למטען ייעודי (payload)
{
"type": "Task_VA_Left",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"finish_reason": "Task VA failed", // Finish reason passed when the VTA session ends
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
}
]
}
}
משתני סשן של עוזר וירטואלי למשימות שהתקבלו
הפרמטר הזה מועבר כשעוזר וירטואלי למשימות שולח מטען ייעודי (payload) של משתנה סשן מותאם אישית.
שדות נתונים
call_id. המזהה של סשן קולי (IVR).
chat_id. המזהה של סשן צ'אט באתר או בנייד.
campaign_id: המזהה של שיחה בקמפיין.
campaign_name: שם הקמפיין.virtual_agent_id: המזהה של העוזר הווירטואלי.
virtual_agent_name: השם של העוזר הווירטואלי לביצוע משימות.
queue_id: המזהה של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_path: הנתיב של התור שממנו הגיע הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
queue_language_id: השפה של התור שממנו התחיל הסשן. המזהה הזה נכלל רק אם הסשן מתחיל בתור.
session_type: סוג הסשן – לדוגמה, הודעות נכנסות דרך צ'אט באתר.
conversation_id: המזהה של סשנים של סוכנים וירטואליים שמשתמשים בפרופילים של שיחות.
session_id: המזהה של סשנים של נציג וירטואלי שלא משתמשים בפרופילים של שיחות.timestamp: התאריך והשעה של אירוע.
data_parameters: המשתנים שהוגדרו בפורטל של פלטפורמת CCAI ונשלחו לעוזר הווירטואלי.
captured_variables: משתני הסשן שנתפסו על ידי העוזר הווירטואלי.
דוגמה למטען ייעודי (payload)
{
"type": "Task_VA_Variables_Received",
"data": {
"chat_id": 103646,
"campaign_id": 1432, // omitted if not available
"campaign_name": "Survey Movie", // omitted if not available
"virtual_agent_id": 1,
"virtual_agent_name": "name",
"participant_id": 1,
"queue_id": 8469, // omitted if not available
"queue_path": "Developers / James", // omitted if not available
"queue_language_id": "en", // omitted if not available
"session_type": "Messaging Inbound (SMS)",
"conversation_id": "12345",
"session_id": "78534G4RT4284", // omitted if not available
"timestamp": "1727853575",
"data_parameters": {
"param1": "one",
"param2": "two"
},
"captured_variables": [
{
"intent_name": null,
"variables": {
"testkey_1": "testvalue"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp": "1727853575"
},
{
"intent_name": null,
"variables": {
"testkey_2": "testvalue2"
},
"captured_at": "2024-11-15 16:46:31 UTC",
"timestamp" : "1727853575"
}
]
}
}
מטען ייעודי (payload) של Dialogflow למשתני סשן מותאמים אישית
המטען הייעודי (payload) של משתנה מותאם אישית של סשן ב-Dialogflow תומך באירועים של סיוע וירטואלי במשימות.
המאפיינים שזמינים במטען הייעודי (payload) של משתנה הסשן של הלקוח כוללים את המאפיינים הבאים:
capture_type:event: מציין שהערכים שמוחזרים במטען הייעודי (payload) של משתנה סשן הלקוח צריכים לעבור בפוסטים של אירועים של העוזר הווירטואלי.
capture_type:agent: מציין שצריך להעביר את הערכים שמוחזרים במטען הייעודי (payload) של משתנה סשן הלקוח למתאם של הסוכן.
capture_type:comment: מציין שצריך להעביר את הערכים שמוחזרים במטען הייעודי (payload) של משתנה סשן הלקוח לרשומה ב-CRM כהערה.
invisible_to_adapter_events. הערכים של המפתחות שצוינו במאפיין הזה לא נכללים באירועים של העוזר הווירטואלי אחרי המשימות.
דוגמה למטען ייעודי (payload)
{
"ujet": {
"session_variable": {
"payload": {
"key_two": "$session.params.favfood",
"key_three": "$session.params.budget",
"key_one": "$session.params.location",
"key_four": "$session.params.startdate",
"key_five": "$session.params.enddate"
},
"capture_type": [
"comment",
"agent",
"event"
],
"capture_target": "payload",
"invisible_to_agent": [
"key_one",
"key_two"
],
"invisible_to_adapter_events": [
"key_three",
"key_two"
]
}
}
}