הרכיב המוגדר מראש של היסטוריית העסקאות בודק את רמת האימות של הלקוח, ואז אוסף את תקופת העסקאות ומסננים אחרים שמוחלים כשמאחזרים את היסטוריית העסקאות. הרכיב הזה תומך במסננים הבאים:
- סוג העסקה
- שם המוֹכר
- סכום העסקה
אם ללקוח יש כמה חשבונות, הרכיב מאשר את החשבון הספציפי שהלקוח רוצה לאחזר את היסטוריית העסקאות שלו. הרכיב הזה משתמש ברכיב המובנה Authentication כדי לאמת משתמשים, ובגרסה מותאמת אישית של Date of birth collection כדי לאסוף את תאריכי ההתחלה והסיום של היסטוריית העסקאות.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
חשבונות מרובים
למשתמש הקצה יש כמה חשבונות. הנציג מוודא לאיזה חשבון המשתמש מבקש את היסטוריית העסקאות. הנציג אוסף את תאריכי ההתחלה והסיום של העסקאות, את המסננים שהמשתמש רוצה להחיל על העסקאות ואת ההעדפה של המשתמש לגבי הצפנת היסטוריית העסקאות. הנציג שולח למשתמש את היסטוריית העסקאות.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication | |
| תודה, האימות בוצע בהצלחה. | |
| אנחנו מאחזרים את פרטי החשבון שלך. מצאנו שיש 2 חשבונות שמשויכים למספר שלך. אפשר לקבל את 4 הספרות האחרונות של החשבון הרלוונטי? |
|
| 1001 | |
| ארבע הספרות האחרונות של מספר החשבון שקיבלנו הן 1001, זה נכון? | |
| כן | |
| צריך לציין את תאריך ההתחלה של העסקאות, בפורמט הבא: חודש, יום, שנה. חשוב לדעת: היסטוריית העסקאות תכלול רק את 90 הימים האחרונים. | |
| הנציג אוסף את תאריך ההתחלה של העסקאות באמצעות הרכיב המוגדר מראש תאריך לידה | |
| מעולה, קיבלנו את תאריך ההתחלה של העסקאות. עכשיו צריך לציין את תאריך הסיום של העסקאות, בפורמט הבא: חודש, יום ושנה. חשוב לדעת שהיסטוריית העסקאות תכלול רק את 90 הימים האחרונים. |
|
| הנציג אוסף את תאריך ההתחלה של העסקאות באמצעות הרכיב המוגדר מראש תאריך לידה | |
| תודה. רציתי לוודא שחיפשת את העסקאות שבוצעו בין 25 ביוני 2023 ל-21 ביולי 2023. | |
| כן | |
| צריך לציין את שם המוכר שרוצים לקבל את העסקאות שלו. | |
| שם המוכר שתיעדנו הוא "Google". אפשר לבקש ממך לאשר את זה בתשובה של כן או לא? | |
| כן | |
| רוצים לראות את היסטוריית העסקאות של כרטיסי החיוב המיידי או כרטיסי האשראי שלכם? | |
| Credit | |
| צריך לציין סכום כדי לאחזר עסקאות בסכום הזה או בסכום גבוה יותר. לדוגמה, אם רוצים למצוא עסקאות בסכום של יותר מ-100.30$, אומרים "100". | |
| 500 | |
| אנחנו מאחזרים את פרטי העסקאות שלך. מצאנו עסקאות מהתאריכים 2 ביוני 2023 עד 21 ביולי 2023. רוצה לקבל אותו ב-SMS או בוואטסאפ? |
|
| SMS | |
| רוצה שנצפין את המסמך לפני שנשתף אותו איתך? | |
| כן, בבקשה | |
| פרטי הסיסמה יישלחו למספר הנייד הרשום. הדוח יישלח תוך 15 דקות למספר הנייד הרשום. |
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | היסטוריית עסקאות |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_transaction_history_transaction_collection |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_transaction_history_det_cred |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_transaction_history:get_transactions |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע איך הרכיב צריך להתנהג. צריך להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.
הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $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.transaction_history_max_days | מציין את מספר הימים המקסימלי לפני התאריך הנוכחי שמותר להגדיר כתאריך ההתחלה של העסקאות. כברירת מחדל, הערך הזה הוא -90, מה שאומר שתאריכי ההתחלה של העסקאות יכולים להיות עד 90 יום לפני התאריך הנוכחי. הפרמטר הזה מוגדר בנתיב true של דף ההתחלה. |
מספר שלם |
| $flow.max_retry_count | מציין את מספר הניסיונות החוזרים המותרים כשמבקשים ממשתמש הקצה לספק תאריכי התחלה וסיום חוקיים של עסקאות. ערך ברירת המחדל הוא 3. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע 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 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_transaction_history: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. אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא התאריך הנוכחי. | מחרוזת |
| $flow.transaction_credit_debit | סוג העסקה שהמשתמש ביקש. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_transaction_history_det_cred. כברירת מחדל, יש תמיכה ב-"credit" וב-"debit". אם המשתמש לא בוחר סוג, הערך הזה הוא מחרוזת ריקה "" וצריך לספור עסקאות מכל סוג. |
מחרוזת |
| $flow.merchant_name | שם המוכר שהמשתמש ביקש. אם המשתמש לא מספק שם מוכר, הערך הזה הוא מחרוזת ריקה "" וצריך לספור עסקאות מכל המוכרים. |
מחרוזת |
| $flow.high_amount_value | סכום העסקה המינימלי שהמשתמש ביקש. אם המשתמש מסרב לספק סכום, ערך ברירת המחדל של הפרמטר הזה הוא 0. |
מספר שלם |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| transactions_count | מספר העסקאות שנמצאו בחשבון שצוין בתקופת הדוח הנתונה, עם המסננים שנבחרו. | מספר שלם |
כדי להגדיר את ה-webhook "קבלת עסקאות" לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_transaction_historyt:get_transactions.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת מידע
ה-webhook prebuilt_components_transaction_history:send_info משמש את הרכיב כדי לשלוח היסטוריית עסקאות לערוץ שנבחר, בהתאם למספר הטלפון הרשום של המשתמש, ארבע הספרות האחרונות של מספר החשבון, התקופה של היסטוריית העסקאות וכל המסננים שהמשתמש בחר.
פרמטרים של בקשות 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.transaction_credit_debit | סוג העסקה שהמשתמש ביקש. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_transaction_history_det_cred. כברירת מחדל, יש תמיכה ב-"credit" וב-"debit". אם המשתמש לא בוחר סוג, הערך הזה הוא מחרוזת ריקה "" וצריך לשלוח עסקאות מכל סוג. |
מחרוזת |
| $flow.merchant_name | שם המוכר שהמשתמש ביקש. אם המשתמש לא מספק שם מוכר, הערך הזה הוא מחרוזת ריקה "" וצריך לשלוח עסקאות מכל המוכרים. |
מחרוזת |
| $flow.high_amount_value | סכום העסקה המינימלי שהמשתמש ביקש. אם המשתמש מסרב לספק סכום, ערך ברירת המחדל של הפרמטר הזה הוא 0. |
מספר שלם |
| $flow.channel_medium | הערוץ שהמשתמש בחר לקבל בו את ההודעה. הערכים התקינים מוגדרים על ידי הישויות המותאמות אישית prebuilt_components_transaction_history_phone ו-prebuilt_components_transaction_history_channel, בהתאם לשאלה אם למשתמש יש כתובת אימייל רשומה. כברירת מחדל, יש תמיכה ב-email, ב-mobile וב-whatsapp. |
מחרוזת |
| $flow.encryption_status | מציין אם המשתמש רוצה שהמסמך יוצפן לפני שהוא יישלח לערוץ שצוין. אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא true. |
בוליאני |
כדי להגדיר את ה-webhook של שליחת המידע לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_transaction_history:send_info.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.