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

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

מגבלות

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

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

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

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

חשבון יחיד

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

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

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

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

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

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

אימות

אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים עבור הרכיב הזה. הוראות מפורטות זמינות במאמר בנושא הגדרת 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.

הושלמה

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