רכיב מוכן מראש של דוח תנועות בחשבון

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

הרכיב הזה משתמש ברכיב המובנה Authentication כדי לאמת את הלקוחות, ובגרסה מותאמת אישית של Date of birth collection כדי לאסוף את תאריכי ההתחלה והסיום של תקופת הדוח.

מגבלות

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

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

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

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

חשבון יחיד

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

הטקסט של המשתמש	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication.
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו מספר חשבון שמסתיים ב-1001 ומשויך למספר שלך. צריך לציין את תאריך ההתחלה של דף החשבון, החל מהחודש, אחריו היום ואז השנה. שימו לב: תקופת דוח התנועות בחשבון תהיה רק ל-90 הימים האחרונים.
	הנציג אוסף את תאריך ההתחלה של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה.
	מעולה, קיבלנו את תאריך ההתחלה של דוח תנועות בחשבון. עכשיו צריך לציין את תאריך הסיום של דוח תנועות בחשבון, בפורמט הבא: חודש, יום ושנה. שימו לב: תקופת דוח התנועות בחשבון תסופק רק ל-90 הימים האחרונים.
	הנציג אוסף את תאריך הסיום של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה.
	תודה. רצית לקבל את דוח התנועות בחשבון לתאריכים 12.7.2023 עד 24.7.2023?
כן
	אנחנו מאחזרים את פרטי דף החשבון שלך. מצאנו עסקאות מהתאריכים 12.07.2023 עד 24.07.2023. רוצה לקבל אותו באימייל, ב-SMS או בוואטסאפ?
SMS
	רוצה להצפין את המסמך לפני שנשתף אותו איתך?
לא תודה
	הדוח יישלח תוך 15 דקות למספר הנייד הרשום.

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

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

הטקסט של המשתמש	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication.
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו שיש 2 חשבונות שמשויכים למספר שלך. מהן 4 הספרות האחרונות של החשבון הרלוונטי?
2002
	ארבע הספרות האחרונות של מספר החשבון שקיבלנו הן 2002, זה נכון?
כן
	צריך לציין את תאריך ההתחלה של דוח התנועות בחשבון, החל מהחודש, אחריו היום ואז השנה. חשוב לדעת: התקופה של דוח התנועות בחשבון תהיה רק מ-90 הימים האחרונים.
	הנציג אוסף את תאריך ההתחלה של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה.
	מעולה, קיבלנו את תאריך ההתחלה של דוח תנועות בחשבון. עכשיו צריך לציין את תאריך הסיום של דוח תנועות בחשבון, בפורמט הבא: חודש, יום ושנה. שימו לב: תקופת דוח התנועות בחשבון תסופק רק ל-90 הימים האחרונים.
	הנציג אוסף את תאריך הסיום של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה.
	תודה. רצית לקבל את דוח התנועות בחשבון לתאריכים 18.7.2023 עד 22.7.2023?
כן
	אנחנו מאחזרים את פרטי דף החשבון שלך. מצאנו עסקאות מהתאריכים 18.7.2023 עד 22.7.2023. רוצה לקבל אותו באימייל, ב-SMS או בוואטסאפ?
WhatsApp
	רוצה להצפין את המסמך לפני שנשתף אותו איתך?
כן
	פרטי הסיסמה ישותפו במספר הוואטסאפ הרשום שלך. הדוח יישלח תוך 15 דקות למספר הוואטסאפ הרשום שלך.

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

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

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

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

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

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

שם הפרמטר	תיאור	פורמט הקלט
$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	(אופציונלי) ארבע הספרות האחרונות של מספר חשבון הלקוח שעבורו צריך לספק את דף החשבון. אם ללקוח יש חשבון אחד, המידע הזה מאוחזר באופן אוטומטי אחרי האימות. אם ללקוח יש כמה חשבונות, מספר החשבון הספציפי נאסף מהלקוח.	מחרוזת
$session.params.account_statement_max_days	מציין את מספר הימים המקסימלי לפני התאריך הנוכחי שמותר לתאריך ההתחלה של הדוח. כברירת מחדל, הערך הזה הוא -90, כלומר תאריכי ההתחלה של ההצהרות יכולים להתחיל עד 90 יום לפני התאריך הנוכחי. הפרמטר הזה מוגדר במסלול true של דף הפתיחה.	מספר שלם
$flow.max_retry_count	מציין את מספר הניסיונות המותרים כשמבקשים מהמשתמש לספק תאריך סיום חוקי של דף חשבון. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_confirm_period_counter	מציין את מספר הניסיונות החוזרים המותרים כשמאשרים את תקופת הדוח עם המשתמש. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_statement_counter	מציינת את מספר הניסיונות החוזרים המותרים כשלא מתקבלות עסקאות בתקופת הדוח שצוינה. ערך ברירת המחדל הוא 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.

קבלת עסקאות

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

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

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

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המתקשר, בלי קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_account_number	ארבע הספרות האחרונות של מספר החשבון שהמשתמש בחר ואישר לקבל מידע על דוח תנועות בחשבון שלו.	מחרוזת
$flow.statement_start_date	תאריך ההתחלה של הדוח המבוקש בפורמט "YYYY-MM-DD".	מחרוזת
$flow.statement_end_date	(אופציונלי) תאריך הסיום של הדוח המבוקש בפורמט "YYYY-MM-DD". אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא התאריך הנוכחי.	מחרוזת

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

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

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

כדי להגדיר את ה-webhook "קבלת עסקאות" לרכיב הזה, צריך להרחיב את ההוראות.

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

בקשה לקבלת דוח

ה-webhook של prebuilt_components_account_statement:request_statement שולח דף חשבון לערוץ שנבחר, על סמך מספר הטלפון הרשום של המשתמש, ארבע הספרות האחרונות של מספר החשבון ותקופת הדוח.

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

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

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המתקשר, בלי קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_account_number	ארבע הספרות האחרונות של מספר החשבון שהמשתמש בחר ואישר לקבל מידע על דוח תנועות בחשבון שלו.	מחרוזת
$flow.statement_start_date	תאריך ההתחלה של הדוח המבוקש בפורמט "YYYY-MM-DD".	מחרוזת
$flow.statement_end_date	(אופציונלי) תאריך הסיום של הדוח המבוקש בפורמט "YYYY-MM-DD". אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא התאריך הנוכחי.	מחרוזת
$flow.channel_medium	הערוץ שהמשתמש בחר לקבל בו את ההודעה. הערכים התקינים מוגדרים על ידי הישויות המותאמות אישית prebuilt_components_account_statement_channelphn ו-prebuilt_components_account_statement_channelall, בהתאם לשאלה אם למשתמש יש כתובת אימייל רשומה. כברירת מחדל, יש תמיכה ב-email, ב-mobile וב-WhatsApp.	מחרוזת
$flow.encryption_status	מציין אם המשתמש רוצה שהמסמך יוצפן לפני שהוא יישלח לערוץ שצוין. אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק העדפת הצפנה, ערך ברירת המחדל הוא true.	בוליאני

כדי להגדיר את ה-webhook של בקשת ההצהרה לרכיב הזה, צריך להרחיב את ההוראות.

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

הושלמה

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