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

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

מגבלות

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

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

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

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

חשבון יחיד

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

קלט של משתמשים	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו מספר חשבון שמסתיים ב-1001 ומשויך למספר שלך. צריך לציין את תאריך ההתחלה של דוח תנועות בחשבון, החל מהחודש, לאחר מכן היום ואז השנה. חשוב לדעת: התקופה של דוח התנועות בחשבון תהיה רק מ-90 הימים האחרונים.
	הנציג אוסף את תאריך ההתחלה של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	מעולה, קיבלנו את תאריך ההתחלה של דוח תנועות בחשבון. עכשיו צריך לציין את תאריך הסיום של דוח תנועות בחשבון, בפורמט הבא: חודש, יום ושנה. חשוב לדעת: התקופה של דוח התנועות בחשבון תהיה רק מ-90 הימים האחרונים.
	הנציג אוסף את תאריך הסיום של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	תודה. רציתי לוודא שחיפשת את דוח התנועות בחשבון לתאריכים 12.7.2023 עד 24.7.2023.
כן
	אנחנו מאחזרים את פרטי הדוח, צריך להמתין. מצאנו עסקאות מהתאריכים 12.7.2023 עד 24.7.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‏ 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. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
11. לוחצים על Save.

הושלמה

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