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

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

מגבלות

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

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

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

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

כרטיס אשראי אחד

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

קלט של משתמשים	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו מספר כרטיס שמסתיים ב-1002 ומשויך למספר שלך.
	צריך לציין את תאריך ההתחלה של פירוט העסקאות בכרטיס, בפורמט הבא: חודש, יום, שנה. לתשומת ליבכם, פירוט העסקאות בכרטיס האשראי יסופק רק ל-180 הימים האחרונים.
	הנציג אוסף את תאריך ההתחלה של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	מעולה, קיבלנו את תאריך ההתחלה של פירוט העסקאות בכרטיס האשראי. עכשיו צריך לציין את תאריך הסיום של פירוט העסקאות בכרטיס האשראי, בפורמט הבא: חודש, יום, שנה. לתשומת ליבכם, פירוט העסקאות בכרטיס האשראי יסופק רק ל-180 הימים האחרונים.
	הנציג אוסף את תאריך הסיום של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	מעולה, קיבלנו את תאריך הסיום של פירוט העסקאות בכרטיס האשראי שלך. תודה. עליך לאשר אם חיפשת את דף החשבון לתאריכים 1.6.2023 עד 30.6.2023.
כן
	אנחנו מאחזרים את פרטי דף החשבון שלך. מצאנו עסקאות בין התאריכים 1 ביוני 2023 ל-30 ביוני 2023. איך לשלוח לך את הקוד? באימייל, ב-SMS או בוואטסאפ?
שלח לכתובת האימייל שלי
	רוצה שנצפין את המסמך לפני שנשתף אותו איתך?
לא תודה
	הדוח יישלח תוך 15 דקות לכתובת האימייל הרשומה שלכם.

כמה כרטיסי אשראי

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

קלט של משתמשים	התשובה של הסוכן
	הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication
	תודה, האימות בוצע בהצלחה.
	אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו שיש 2 כרטיסים שמשויכים למספר שלך. יש לך אפשרות לשלוח לנו את 4 הספרות האחרונות של הכרטיס הרלוונטי?
1122
	ארבע הספרות האחרונות של מספר הכרטיס שקיבלנו הן 1122, נכון?
כן
	צריך לציין את תאריך ההתחלה של פירוט העסקאות בכרטיס, בפורמט הבא: חודש, יום, שנה. לתשומת ליבכם, פירוט העסקאות בכרטיס האשראי יסופק רק ל-180 הימים האחרונים.
	הנציג אוסף את תאריך ההתחלה של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	מעולה, קיבלנו את תאריך ההתחלה של פירוט העסקאות בכרטיס האשראי. עכשיו צריך לציין את תאריך הסיום של פירוט העסקאות בכרטיס האשראי, בפורמט הבא: חודש, יום, שנה. לתשומת ליבכם, פירוט העסקאות בכרטיס האשראי יסופק רק ל-180 הימים האחרונים.
	הנציג אוסף את תאריך הסיום של הדוח באמצעות הרכיב המוגדר מראש תאריך לידה
	מעולה, קיבלנו את תאריך הסיום של פירוט העסקאות בכרטיס האשראי שלך. תודה. עליך לאשר אם חיפשת את דף החשבון לתאריכים 13.7.2023 עד 14.7.2023.
כן
	אנחנו מאחזרים את פרטי הדוח, צריך להמתין. מצאנו עסקאות שבוצעו בין 13 ביולי 2023 ל-14 ביולי 2023. איך לשלוח לך את הקוד? באימייל, ב-SMS או בוואטסאפ?
SMS
	רוצה שנצפין את המסמך לפני שנשתף אותו איתך?
כן
	פרטי הסיסמה יישלחו למספר הנייד הרשום. הדוח יישלח תוך 15 דקות למספר הנייד הרשום.

מוסכמות למתן שמות

הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	פירוט עסקאות בכרטיס
סוג ישות	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_statement_channel_all
תגובה לפעולה מאתר אחר (webhook)	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_credit_card_statement:request_statement

פרמטרים של קלט

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

הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:

שם הפרמטר	תיאור	פורמט הקלט
$session.params.auth_level	(אופציונלי) מציין את רמת האימות של המתקשר.	מספר שלם
$session.params.auth_level_req	מציינת את רמת האימות שנדרשת כדי שמשתמש יוכל לגשת לדף פירוט העסקאות בכרטיס האשראי שלו. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. כברירת מחדל, הערך הוא 1.	מספר שלם
$session.params.account_auth_enabled	מציין אם המשתמש צריך לעבור אימות כבעל חשבון, כפי שמתואר בקטע רמות אימות. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. כברירת מחדל, הערך הוא false.	בוליאני
$session.params.card_auth_enabled	מציין אם המשתמש צריך לעבור אימות כבעל הכרטיס, כפי שמתואר בקטע רמות אימות. הערך הזה מוגדר בהגדרות הקבועות מראש של הפרמטרים של מילוי הבקשה בכניסה לדף בדף check auth level. כברירת מחדל, הערך הוא true.	בוליאני
‎$session.params.phone_number	(אופציונלי) מספר הטלפון הרשום של הלקוח שמשמש לאימות.	מחרוזת
$session.params.credit_card_count	(אופציונלי) מספר כרטיסי האשראי שמשויכים למשתמש המאומת.	מספר שלם
$session.params.last_four_digit_of_card_number	(אופציונלי) ארבע הספרות האחרונות של מספר הכרטיס של הלקוח שעבורו צריך לספק את דף החשבון. אם ללקוח יש כרטיס אחד, המידע הזה מאוחזר באופן אוטומטי אחרי האימות. אם ללקוח יש כמה כרטיסים, מספר הכרטיס הספציפי נאסף מהלקוח.	מחרוזת
$session.params.credit_card_statement_max_days	מציין את מספר הימים המקסימלי לפני התאריך הנוכחי שמותר לתאריך ההתחלה של ההצהרה. כברירת מחדל, הערך הזה הוא -180, כלומר תאריכי ההתחלה של הדוחות יכולים להתחיל עד 180 ימים לפני התאריך הנוכחי. הפרמטר הזה מוגדר במסלול true של דף הפתיחה.	מספר שלם
$flow.max_retry_count	מציין את מספר הניסיונות החוזרים המותרים כשמבקשים ממשתמש הקצה לספק תאריך סיום חוקי של דף חשבון. ערך ברירת המחדל הוא 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	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
credit_card_count	מספר כרטיסי האשראי שמשויכים למספר הטלפון הרשום.	מספר שלם
last_four_digit_of_card_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_credit_card_statement:credit_card_details משמש את הרכיב לאחזור פרטי כרטיס אשראי של מספר טלפון רשום.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
credit_card_count	מספר כרטיסי האשראי שמשויכים למספר הטלפון הרשום.	מספר שלם
credit_card	ארבע הספרות האחרונות של מספר כרטיס האשראי של הלקוח. אם ללקוח יש כמה כרטיסים, הערך הזה הוא null.	מחרוזת
אימייל	כתובת האימייל הרשומה של המשתמש. אם אין כתובת אימייל שרשומה למספר הטלפון, הערך הזה הוא null.	מחרוזת

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

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

אימות הכרטיס

הרכיב משתמש ב-webhook‏ prebuilt_components_credit_card_statement:validate_date כדי לאמת אם כרטיס אשראי מסוים קיים למספר טלפון רשום.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_card_number	ארבע הספרות האחרונות של מספר כרטיס האשראי שהמשתמש סיפק.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
valid_card	מציין אם הכרטיס שצוין נמצא עבור מספר הטלפון הרשום.	בוליאני

כדי להגדיר את ה-webhook של אימות הכרטיס לרכיב הזה, צריך להרחיב את ההוראות.

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

קבלת עסקאות

ה-webhook‏ prebuilt_components_credit_card_statement:card_transaction_details משמש את הרכיב כדי לאחזר את העסקאות של כרטיס מסוים, בהתאם למספר הטלפון הרשום של המשתמש, ארבע הספרות האחרונות של מספר הכרטיס ותקופת הדוח.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_card_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_credit_card_statement:card_transaction_details.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
11. לוחצים על Save.

בקשה לקבלת דוח

ה-webhook‏ prebuilt_components_credit_card_statement:request_statement משמש את הרכיב כדי לשלוח דף חשבון של כרטיס אשראי לערוץ שנבחר, בהתאם למספר הטלפון הרשום של המשתמש, ארבע הספרות האחרונות של מספר כרטיס האשראי ותקופת דף החשבון.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.last_four_digit_of_card_number	ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש בחר ואישר לקבל עבורו מידע על פירוט העסקאות בכרטיס האשראי.	מחרוזת
$flow.statement_start_date	תאריך ההתחלה של הדוח המבוקש בפורמט YYYY-MM-DD.	מחרוזת
$flow.statement_end_date	(אופציונלי) תאריך ההתחלה של הדוח המבוקש בפורמט YYYY-MM-DD. אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא התאריך הנוכחי.	מחרוזת
$flow.channel_medium	הערוץ שהמשתמש בחר לקבל בו את ההודעה. הערכים התקינים מוגדרים על ידי הישויות המותאמות אישית prebuilt_components_statement_channel_phone ו-prebuilt_components_statement_channel_all, בהתאם לשאלה אם למשתמש יש כתובת אימייל רשומה. כברירת מחדל, יש תמיכה ב-email, ב-mobile וב-WhatsApp.	מחרוזת
$flow.encryption_status	מציין אם המשתמש רוצה שהמסמך יוצפן לפני שהוא יישלח לערוץ שצוין. אם המשתמש לא מספק ערך או שהמתקשר מסרב לספק תאריך סיום, ערך ברירת המחדל הוא true.	בוליאני

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

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

הושלמה

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