רכיב מוכן מראש של היסטוריית עסקאות

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

• סוג העסקה
• שם המוֹכר
• סכום העסקה

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

מגבלות

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

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

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

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

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

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

קלט של משתמשים	התשובה של הסוכן
	הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות
	תודה, האימות שלך בוצע בהצלחה.
	אנחנו מאחזרים את פרטי החשבון שלך. מצאנו 2 חשבונות שמקושרים למספר שלך. מהן 4 הספרות האחרונות של החשבון שאליו אתה מתייחס?
1001
	ארבע הספרות האחרונות של מספר החשבון שקיבלנו הן 1001. האם זה נכון?
כן
	צריך לציין את תאריך ההתחלה של העסקאות, קודם את החודש, אחר כך את היום ואז את השנה. חשוב לדעת: היסטוריית העסקאות תסופק רק לגבי 90 הימים האחרונים.
	הסוכן אוסף את תאריך התחלת העסקאות באמצעות רכיב מוכן מראש של תאריך לידה
	מעולה, קיבלנו את תאריך ההתחלה של העסקאות שלך. עכשיו צריך לציין את תאריך הסיום של העסקאות, קודם את החודש, אחר כך את היום ואז את השנה. חשוב לדעת: היסטוריית העסקאות תסופק רק לגבי 90 הימים האחרונים.
	הסוכן אוסף את תאריך התחלת העסקאות באמצעות רכיב מוכן מראש של תאריך לידה
	תודה. האם אתה מחפש את העסקאות שבוצעו בין 25 ביוני 2023 ל-21 ביולי 2023?
כן
	מה שם המוכר שרוצה לקבל מידע על העסקאות שלו?
Google
	שם המוכר שזיהינו הוא Google. אפשר לקבל ממך אישור בחיוב או בשלילה?
כן
	רוצים לראות את היסטוריית העסקאות בכרטיסי החיוב המיידי או בכרטיסי האשראי?
Credit
	צריך לציין סכום כדי לאחזר עסקאות בסכום הזה או מעליו. לדוגמה, אם רוצים למצוא עסקאות מעל 100.30$, אומרים "100".
500
	רק רגע, אנחנו מאחזרים את פרטי העסקאות שלך. מצאנו עסקאות מהתאריכים 2023-06-2 עד 2023-07-21. רוצה לקבל אותו באמצעות 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.	מספר שלם

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

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. בוחרים בכרטיסייה Build (פיתוח).
5. לוחצים על הרכיב המיובא בקטע Flows (תהליכי עבודה).
6. בקטע דפים, לוחצים על דף הבית.
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

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

אימות

אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים עבור הרכיב הזה. הוראות מפורטות זמינות במאמר בנושא הגדרת 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_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 של קבלת עסקאות עבור הרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים ב-webhook של prebuilt_components_transaction_historyt:get_transactions.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
9. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
11. לוחצים על 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 של שליחת מידע עבור הרכיב הזה, מרחיבים את ההוראות.

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

הושלמה

הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.