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

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

מגבלות

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

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

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

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

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

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

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

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

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

תודה. האם אתה מחפש את הדף הזה בין התאריכים 2023-06-01 ל-2023-06-30?
כן
רק רגע, אנחנו מאחזרים את פרטי הדף.

מצאנו טרנזקציות בין התאריכים 2023-06-01 ל-2023-06-30. האם תרצה לקבל אותו באימייל, ב-SMS או בוואטסאפ?
שליחה לאימייל שלי
האם תרצה להצפין את המסמך לפני שנשתף אותו איתך?
לא תודה
דף החשבון יישלח לכתובת האימייל שרשומה בחשבון תוך 15 דקות.

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

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

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

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

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

תודה. האם אתה מחפש את הדף בין התאריכים 13 ביולי 2023 ל-14 ביולי 2023?
כן
רק רגע, אנחנו מאחזרים את פרטי הדוח שלך.

מצאנו טרנזקציות בין התאריכים 2023-07-13 ל-2023-07-14. האם תרצה לקבל אותו באימייל, ב-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. בקטע דפים, לוחצים על דף הפתיחה.
  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

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

אימות

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

קבלת עסקאות

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

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

הושלמה

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