הרכיב המובנה של דוח תנועות בחשבון בודק את רמת האימות של הלקוח, ואז שולח ללקוח מאומת את דוח תנועות בחשבון לתקופה שצוינה. אם ללקוח יש כמה חשבונות, הרכיב מאשר את החשבון הספציפי שלגביו הלקוח רוצה לאחזר דוח תנועות בחשבון. הרכיב הזה משתמש ברכיב המובנה מראש אימות כדי לאמת משתמשים, ומשתמש בגרסה מותאמת אישית של איסוף תאריך לידה כדי לאסוף תאריכי התחלה וסיום לתקופת הדוח.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, הרכיב המוכן מראש הזה כולל את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הסוכן בתחילת השיחה.
חשבון יחיד
למשתמש הקצה יש חשבון אחד. הסוכן אוסף את תאריכי ההתחלה והסיום של הדוח, בודק אם המשתמש רוצה להצפין את הדוח ושולח את דוח התנועות בחשבון למשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות | |
| תודה, האימות שלך הושלם בהצלחה. | |
| אנחנו אוספים את פרטי החשבון שלך. מצאנו מספר חשבון שמסתיים ב-1001 שמשויך למספר שלך. עליך לציין את תאריך ההתחלה של דוח תנועות בחשבון, קודם את החודש, אחר כך את היום ואז את השנה. שימו לב: תקופת דוח תנועות בחשבון תצוין רק ל-90 הימים האחרונים. |
|
| הסוכן אוסף את תאריך ההתחלה של ההצהרה באמצעות רכיב מוכן מראש של תאריך לידה | |
| מעולה, קיבלנו את תאריך ההתחלה של דוח תנועות בחשבון. עכשיו צריך לציין את תאריך הסיום של דוח תנועות בחשבון, קודם את החודש, אחר כך את היום ואז את השנה. שימו לב: תקופת דוח תנועות בחשבון תצוין רק ל-90 הימים האחרונים. |
|
| הסוכן אוסף את תאריך הסיום של הדוח באמצעות רכיב מוכן מראש של תאריך לידה | |
| תודה. האם אתה מחפש את דוח תנועות בחשבון מהתאריכים 12 ביולי 2023 עד 24 ביולי 2023? | |
| כן | |
| רק רגע, אנחנו מאחזרים את פרטי הדוח שלך. מצאנו טרנזקציות מהתאריכים 12 ביולי 2023 עד 24 ביולי 2023. האם תרצה לקבל אותו באימייל, ב-SMS או בוואטסאפ? |
|
| SMS | |
| האם תרצה להצפין את המסמך לפני שנשתף אותו איתך? | |
| לא תודה | |
| דף החשבון יישלח לנייד הרשום תוך 15 דקות. |
חשבונות מרובים
למשתמש הקצה יש כמה חשבונות. הנציג מאשר את החשבון שעבורו המשתמש מבקש דוח תנועות בחשבון. הסוכן אוסף את תאריכי ההתחלה והסיום של הדוח, בודק אם המשתמש רוצה להצפין את הדוח ושולח את דוח התנועות בחשבון למשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות | |
| תודה, האימות שלך הושלם בהצלחה. | |
| אנחנו מאחזרים את פרטי החשבון שלך. מצאנו 2 חשבונות שמקושרים למספר שלך. מהן 4 הספרות האחרונות של החשבון שאליו אתה מתייחס? |
|
| 2002 | |
| ארבע הספרות האחרונות של מספר החשבון שקיבלנו הן 2002. זה נכון? | |
| כן | |
| צריך לציין את תאריך ההתחלה של דוח תנועות בחשבון, קודם את החודש, אחר כך את היום ואז את השנה. שימו לב: תקופת דוח תנועות בחשבון תצוין רק ל-90 הימים האחרונים. | |
| הסוכן אוסף את תאריך ההתחלה של ההצהרה באמצעות רכיב מוכן מראש של תאריך לידה | |
| מעולה, קיבלנו את תאריך ההתחלה של דוח תנועות בחשבון. עכשיו צריך לציין את תאריך הסיום של דוח תנועות בחשבון, קודם את החודש, אחר כך את היום ואז את השנה. שימו לב: תקופת דוח תנועות בחשבון תצוין רק ל-90 הימים האחרונים. |
|
| הסוכן אוסף את תאריך הסיום של הדוח באמצעות רכיב מוכן מראש של תאריך לידה | |
| תודה. האם אתה מחפש את דוח תנועות בחשבון מהתאריכים 18 ביולי 2023 עד 22 ביולי 2023? | |
| כן | |
| רק רגע, אנחנו מאחזרים את פרטי הדוח שלך. מצאנו טרנזקציות מהתאריכים 18 ביולי 2023 עד 22 ביולי 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.
- בוחרים את הסוכן.
- בוחרים בכרטיסייה Build (פיתוח).
- לוחצים על הרכיב המיובא בקטע Flows (תהליכי עבודה).
- בקטע דפים, לוחצים על דף הפתיחה.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route (מסלול), עורכים את הערכים של Parameter Presets (הגדרות קבועות מראש של פרמטרים) לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרי פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המובנה הזה מספק ערכים לפרמטרים הבאים של הפלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| auth_level | מציין את רמת האימות של המתקשר. | מספר שלם |
| phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| account_count | מספר החשבונות שמשויכים למספר הטלפון הרשום. החשבונות האלה כוללים חשבונות עצמאיים וחשבונות שבהם למשתמש יש ייפוי כוח. | מספר שלם |
| last_four_digit_of_account_number | אם למשתמש יש חשבון אחד, הפונקציה מחזירה את ארבע הספרות האחרונות של מספר החשבון. אם למשתמש יש יותר מחשבון אחד, הערך של הפרמטר הזה הוא 4 הספרות האחרונות של מספר החשבון שהמשתמש בחר לקבל לגביו מידע על דוח תנועות בחשבון. | מחרוזת |
| 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
כדי להשתמש ברכיב הזה, צריך להגדיר את הוויבהוקים הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים עבור הרכיב הזה. הוראות מפורטות זמינות במאמר בנושא הגדרת 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 (כתובת ה-URL של ה-Webhook) ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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 (כתובת ה-URL של ה-Webhook) ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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 (כתובת ה-URL של ה-Webhook) ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.