הרכיב המובנה של דוח תנועות בחשבון מאמת את רמת האימות של הלקוח ושולח את דוח התנועות בחשבון לתקופה מסוימת למשתמש מאומת. אם ללקוח יש כמה חשבונות, הרכיב מאשר את החשבון הספציפי שהמשתמש צריך לאחזר את דוח תנועות בחשבון שלו.
הרכיב הזה משתמש ברכיב המובנה Authentication כדי לאמת את הלקוחות, ובגרסה מותאמת אישית של Date of birth collection כדי לאסוף את תאריכי ההתחלה והסיום של תקופת הדוח.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.
חשבון יחיד
אם למשתמש יש חשבון אחד, הנציג אוסף את תאריכי ההתחלה והסיום של הדוח, שואל אם המשתמש רוצה להצפין את הדוח ושולח את דוח התנועות בחשבון למשתמש.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש 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 או בוואטסאפ? |
|
| רוצה להצפין את המסמך לפני שנשתף אותו איתך? | |
| כן | |
| פרטי הסיסמה ישותפו בחשבון הוואטסאפ הרשום שלך. הדוח יישלח תוך 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. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה יצירה.
- לוחצים על הרכיב המיובא בקטע Flows.
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על 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. |
מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המובנה:
- מייבאים את הרכיב המוגדר מראש.
- מגדירים את ה-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 לאימות חשבון ברכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_account_services:validate_account.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על 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 "קבלת עסקאות" לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_account_statement:get_transactions.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על 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 של בקשת ההצהרה לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_account_statement:request_statement.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הרכיב שהוגדר מראש וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.