רכיב מוכן מראש של יתרה בחשבון

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

מגבלות

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

• הרכיב הזה לא מצפין נתונים.

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

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

חשבון יחיד

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

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

חשבונות מרובים

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

הטקסט של המשתמש	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication.
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו שיש 2 חשבונות שמשויכים למספר שלך. מהן 4 הספרות האחרונות של החשבון הרלוונטי?
2002
	ארבע הספרות האחרונות של מספר החשבון שקיבלנו הן 2002, זה נכון?
כן
	היתרה שמשויכת לחשבון שמסתיים בספרות 2002 היא 5,000$.

כמה חשבונות עם הקשר

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

הטקסט של המשתמש	התשובה של הסוכן
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו שיש 3 חשבונות שמשויכים למספר שלך. האם חיפשת את מספר החשבון שמסתיים ב-4567?
כן
	היתרה בחשבון שמסתיים בספרות 4567 היא 50$.

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

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

תכונה	פורמט	דוגמה
Flow	שם הרכיב	יתרה בחשבון
כוונה ספציפית לרכיב	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_account_number_collection_four_digit_account_number
תגובה לפעולה מאתר אחר (webhook)	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_account_balance:get_account_balance

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

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

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

שם הפרמטר	תיאור	פורמט הקלט
$session.params.auth_level	(אופציונלי) מציין את רמת האימות של המתקשר.	מספר שלם
$session.params.auth_level_req	מציין את רמת האימות שנדרשת כדי שמשתמש יוכל לגשת ליתרה בחשבון שלו. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. ערך ברירת המחדל הוא 1.	מספר שלם
$session.params.account_auth_enabled	מציין אם המשתמש צריך לעבור אימות כבעל חשבון, כמו שמתואר בקטע סוגי אימות. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. ערך ברירת המחדל הוא true.	בוליאני
$session.params.card_auth_enabled	מציין אם המשתמש צריך לעבור אימות כבעל הכרטיס, כפי שמתואר בקטע סוגי אימות. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. ערך ברירת המחדל הוא false.	בוליאני
‎$session.params.phone_number	(אופציונלי) מספר הטלפון הרשום של הלקוח שמשמש לאימות.	מחרוזת
$session.params.account_count	(אופציונלי) מספר החשבונות שמשויכים למשתמש המאומת.	מספר שלם
$session.params.last_four_digit_of_account_number	(אופציונלי) ארבע הספרות האחרונות של מספר חשבון הלקוח שצריך לספק את היתרה שלו. אם ללקוח יש חשבון אחד, המידע הזה מאוחזר באופן אוטומטי אחרי האימות. אם ללקוח יש כמה חשבונות, מספר החשבון הספציפי נאסף מהלקוח.	מחרוזת
$flow.max_retry_acc_number	מציין את מספר הניסיונות החוזרים המותרים כשמבקשים מהמשתמש להזין את ארבע הספרות האחרונות של מספר החשבון שלו. ערך ברירת המחדל הוא 3.	מספר שלם

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

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

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

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

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

שם הפרמטר	תיאור	פורמט הפלט
auth_level	מציין את רמת האימות של המתקשר.	מספר שלם
phone_number	מספר הטלפון המקומי של המתקשר, בלי קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
account_count	מספר החשבונות שמשויכים למספר הטלפון הרשום. החשבונות האלה כוללים חשבונות עצמיים וחשבונות שלמשתמש יש ייפוי כוח לגביהם.	מספר שלם
last_four_digit_of_account_number	אם למשתמש יש חשבון אחד, יוחזרו ארבע הספרות האחרונות של מספר החשבון. אם למשתמש יש יותר מחשבון אחד, הערך של הפרמטר הזה הוא ארבע הספרות האחרונות של מספר החשבון שהמשתמש בחר לקבל מידע על היתרה שלו.	מחרוזת
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 זמין במאמר הגדרת webhook לאימות.

אימות החשבון

הרכיב משתמש ב-webhook‏ prebuilt_components_account_services:validate_account כדי לאמת שקיים חשבון על סמך מספר הטלפון הרשום של המשתמש וארבע הספרות האחרונות של מספר החשבון שסופק. ה-webhook גם מחזיר את היתרה בחשבון, אם קיים חשבון.

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

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

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המתקשר, בלי קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_account_number	ארבע הספרות האחרונות של מספר החשבון שהמשתמש בחר ואישר לקבל מידע על היתרה בחשבון.	מחרוזת

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

הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:

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

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

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

הושלמה

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