רכיב מוכן מראש למשוב

הרכיב המוגדר מראש של המשוב אוסף משוב כמותי ואיכותי מהמשתמשים.

הרכיב מבצע קודם חיפוש באמצעות ה-webhook של Check last feedback שהוגדר, כדי לבדוק אם המשתמש שלח משוב לאחרונה. אם אין משוב מהזמן האחרון, הרכיב מבקש מהמשתמש לתת ציון משוב כמותי בין 1 ל-5. אם המשוב שלילי, הרכיב יכול לאסוף משוב איכותי בטקסט חופשי מהמשתמש.

מגבלות

בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:

• הרכיב מניח שאתם שומרים את מספרי הטלפון של הלקוחות במערכת לניהול קשרי לקוחות (CRM) או בשירות אחר.
• הרכיב הזה לא מאמת לקוחות קיימים שמשתמשים במספר טלפון חלופי כדי ליצור איתכם קשר.

דוגמאות לדו-שיח

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

משוב חיובי

התגובה מ-Check last feedback webhook מציינת שהמשתמש לא שלח משוב לאחרונה. הנציג מבקש מהמשתמש לדרג את חוויית השימוש, והמשתמש נותן דירוג חיובי.

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

משוב שלילי

התגובה מ-Check last feedback webhook מציינת שהמשתמש לא שלח משוב לאחרונה. הנציג מבקש מהמשתמש לדרג את חוויית השימוש, והמשתמש נותן דירוג שמצביע על חוויה שלילית. לאחר מכן, הסוכן מבקש מהמשתמש משוב איכותי.

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

משוב מהזמן האחרון

התגובה מ-Check last feedback webhook מציינת שהמשתמש נתן משוב לאחרונה, ולכן הנציג לא מבקש מהמשתמש קלט נוסף.

הטקסט של המשתמש	התשובה של הסוכן
	תודה שפנית אלינו.

קלט לא חוקי

התגובה מ-Check last feedback webhook מציינת שהמשתמש לא שלח משוב לאחרונה. הנציג מבקש מהמשתמש את ציון המשוב, והמשתמש מספק קלט לא תקין כמה פעמים. הרכיב מסיים את התהליך עם שגיאה.

הטקסט של המשתמש	התשובה של הסוכן
	תודה שהתקשרת. המשוב שלך חשוב לנו. נשמח לקבל ממך משוב על השירות שקיבלת היום. לשם כך, עליך לענות על כמה שאלות קצרות. בסולם של 1 עד 5, כאשר 1 מייצג את מידת שביעות הרצון הנמוכה ביותר ו-5 מייצג את מידת שביעות הרצון הגבוהה ביותר, עד כמה היית מרוצה מהשירות שקיבלת היום?
-1
	סליחה, לא הבנו. מזינים ציון משוב: 1, 2, 3, 4 או 5.
100
	סליחה, לא הבנו. מזינים ציון משוב: 1, 2, 3, 4 או 5.
יפה
	אנחנו מצטערים, אבל חרגת ממספר הניסיונות המקסימלי. אפשר לנסות שוב מאוחר יותר.

מוסכמות למתן שמות

הרכיב הזה משתמש במוסכמות הבאות למתן שמות:

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	משוב
פרמטר	[param_name]	feedback_score
תגובה לפעולה מאתר אחר (webhook)	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_feedback:last_feedback_check

פרמטרים של קלט

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

הרכיב הזה מקבל את הפרמטרים הבאים:

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, שמשמש לזיהוי המשתמש בבקשות API. מספר הטלפון לא צריך לכלול את קוד המדינה.	מחרוזת
$flow.minimum_feedback_score	מציין את הסף של מה שנחשב לציון משוב שלילי או חיובי. ציון נמוך (שווה לערך של הפרמטר הזה או נמוך ממנו) מצביע על חוויה שלילית, וציון גבוה (גבוה מהערך של הפרמטר הזה) מצביע על חוויה חיובית. אם המשתמש נותן ציון נמוך, הוא מתבקש לתת משוב איכותי ולהסביר איך אפשר לשפר את החוויה. ערך ברירת המחדל של הפרמטר הזה הוא 3.	מספר שלם
$flow.feedback_max_retry_count	פרמטר שניתן להגדרה ומתעד את המספר המקסימלי של ניסיונות חוזרים שניתנים למשתמש. הערך שמוקצה לפרמטר הזה צריך להיות קטן באחד ממספר הניסיונות הזמינים. ערך ברירת המחדל הוא 2, כלומר למתקשר יש שלושה ניסיונות לספק את המידע המבוקש.	מספר שלם

כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה Build.
5. לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
6. בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
7. לוחצים על המסלול true בדף הפתיחה.
8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
9. לוחצים על Save.

פרמטרים של פלט

פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב.

הרכיב המוגדר מראש הזה מספק ערכים לפרמטרים הבאים של הפלט:

שם הפרמטר	תיאור	פורמט הפלט
feedback_score	מתעד את הציון שהמשתמש נתן במשוב. הערכים התקינים הם מספרים שלמים בין 1 ל-5, כולל.	מספר שלם
feedback_comment	מתעד את ההערות האיכותיות שסיפק המשתמש, אם יש כאלה.	מחרוזת
transfer_reason	מציין את הסיבה ליציאה מהתהליך, אם הוא לא הושלם בהצלחה. הערך שמוחזר הוא אחד מהבאים: agent: המשתמש ביקש נציג אנושי בשלב כלשהו במהלך השיחה. denial_of_information: המשתמש סירב לשתף מידע שהרכיב ביקש. max_no_input: השיחה הגיעה למספר המקסימלי של ניסיונות חוזרים לאירועים ללא קלט. אפשר לעיין באירועים מובנים ללא קלט. max_no_match: השיחה הגיעה למספר המקסימלי של ניסיונות חוזרים לאירועים ללא התאמה. אפשר לעיין באירועים מובנים ללא התאמה. webhook_error: אירעה שגיאת webhook. אפשר לעיין באירוע המובנה webhook.error. ‫ webhook_not_found: לא הייתה גישה לכתובת URL של webhook. אפשר לעיין באירוע המובנה webhook.error.not-found.	מחרוזת

הגדרה בסיסית

כדי להגדיר את הרכיב המוכן מראש:

1. מייבאים את הרכיב שהוגדר מראש.
2. מגדירים את ה-webhooks הגמישים שסופקו עם השירותים החיצוניים, כמו שמוסבר במאמר הגדרת webhook.

הגדרת תגובה לפעולה מאתר אחר (webhook)

כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.

בדיקת המשוב האחרון שנשלח

הרכיב משתמש ב-webhook של prebuilt_components_feedback:last_feedback_check כדי לבדוק אם המשתמש שלח משוב לאחרונה. השירות החיצוני שמשולב עם ה-webhook הזה מגדיר את התקופה שבה המשוב שסופק בעבר נחשב כעדכני, ובעלי השירות יכולים להגדיר את התקופה הזו.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר	תיאור	פורמט הקלט
phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת

פרמטרים של תגובה מה-API

הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר	תיאור	פורמט הפלט
last_feedback_time_elapsed	מציין אם המשתמש שלח משוב לאחרונה. true מציין שעבר מספיק זמן מאז שהמשתמש נתן משוב בפעם האחרונה, ולא נמצא משוב מהזמן האחרון. false מציין שהמשוב נשלח לאחרונה, ולא עבר מספיק זמן מאז שהמשתמש שלח משוב בפעם האחרונה.	בוליאני

כדי להגדיר את ה-webhook של בדיקת המשוב האחרון לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
6. בוחרים את ה-webhook‏ prebuilt_components_feedback:last_feedback_check.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
9. בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
11. לוחצים על Save.

עדכון המשוב

הרכיב משתמש ב-webhook‏ prebuilt_components_feedback:update_feedback כדי לשלוח את המשוב שנאסף לשירות חיצוני.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר	תיאור	פורמט הקלט
phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
feedback_score	שומר את ציון המשוב שהמשתמש נתן. הערכים הצפויים הם מספרים שלמים בין 1 ל-5, כולל.	מספר שלם
feedback_comment	שומר את הערת המשוב האיכותי שהמשתמש סיפק.	מחרוזת

כדי להגדיר את ה-webhook של עדכון המשוב לרכיב הזה, הרחיבו את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
6. בוחרים את ה-webhook‏ prebuilt_components_feedback:update_feedback.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
9. בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
11. לוחצים על Save.

הושלמה

הרכיב המוגדר מראש של המשוב וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.