הרכיב המובנה של כרטיס הנעילה מאמת את המשתמש, מאחזר כרטיסים שרשומים על שם המשתמש ומאפשר למשתמש לנעול כרטיס באופן זמני, לנעול כרטיס באופן קבוע או להפעיל מחדש כרטיס. אחרי אישור של כרטיס נעול, הרכיב מאפשר למשתמש לבקש כרטיס חדש. הרכיב הזה משתמש בגרסה מותאמת אישית של הרכיב המובנה Authentication כדי לאמת את בעלי הכרטיסים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, לרכיב המוכן מראש הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הסוכן בתחילת השיחה.
משתמש לא מאומת עם כמה כרטיסים
הסוכן מזהה שהמשתמש לא אומת בעבר ואוסף מידע כדי לוודא שהמשתמש הוא בעל כרטיס רשום. אחרי שהמשתמש עובר אימות, הנציג מאחזר מידע על הכרטיסים שרשומים על שם המשתמש. המשתמש מאשר שהוא רוצה לנעול זמנית כרטיס נבחר, והנציג יוצר את בקשת נעילת הכרטיס.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות | |
| תודה, האימות שלך הושלם בהצלחה. | |
| אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו כמה כרטיסים שרשומים עם המספר שלך. יש לנו כרטיס ויזה שמסתיים ב-5555, כרטיס ויזה שמסתיים ב-6666, כרטיס מאסטרקארד שמסתיים ב-4444 וכרטיס מאסטרקארד שמסתיים ב-4449. נשמח לדעת מהן 4 הספרות האחרונות של הכרטיס שברצונך לנעול או להפעיל מחדש. |
|
| 4444 | |
| ארבע הספרות האחרונות של מספר הכרטיס שקיבלנו הן 4444. האם זה נכון? | |
| כן | |
| רוצה לנעול את הכרטיס באופן זמני או לצמיתות? | |
| אני רוצה לנעול אותו באופן זמני | |
| נשמח לדעת למה בחרת לנעול את הכרטיס. אפשר לבחור מבין האפשרויות כמו פגום, נגנב, אבד או אחרות. | |
| נגרם נזק למכשיר | |
| צר לי לשמוע. מסיבות אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. איך תרצה לקבל את הקוד – בטלפון או באימייל? | |
| שליחה לטלפון | |
| בסדר, לפני שנמשיך, נשלח קוד למספר הטלפון הנייד שרשום בחשבון שלך. אפשר לאמת את הקוד כדי לאשר את הבקשה? | |
| 123456 | |
| אוקיי, הכרטיס שלך שמסתיים בספרות 4444 יינעל באופן זמני. אחרי הנעילה, לא תוכלו לבצע עסקאות אונליין או במכונות POS באמצעות הכרטיס הזה. האם לאשר את הפעולה הזו? | |
| כן | |
| הכרטיס שלך ננעל בהצלחה. מספר הבקשה שלך הוא 9711485 והוא נשלח בהצלחה למספר הטלפון הנייד הרשום שלך. |
משתמש מאומת עם כרטיס אחד
הנציג מזהה שהמשתמש עבר אימות בעבר ומאחזר מידע על הכרטיס שרשום על שם המשתמש. המשתמש בוחר לנעול את הכרטיס באופן סופי, והסוכן יוצר את הבקשה לנעילת הכרטיס באופן סופי. הסוכן שואל את המשתמש אם הוא רוצה להנפיק מחדש כרטיס חדש במקום הכרטיס שננעל לצמיתות, ויוצר בקשה להנפקה מחדש של הכרטיס.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| רק רגע, אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו את כרטיס MasterCard שמסתיים בספרות 4444. רוצה לנעול את הכרטיס באופן זמני או לצמיתות? |
|
| באופן סופי | |
| נשמח לדעת למה בחרת לנעול את הכרטיס. אפשר לבחור מבין האפשרויות כמו פגום, נגנב, אבד או אחרות. | |
| המוצר היה פגום | |
| צר לי לשמוע. אל דאגה, ננעל את הכרטיס שלך לצמיתות. אפשר לאשר שהכרטיס מסתיים בספרות 4444? | |
| כן | |
| בסדר, לפני שנמשיך, נשלח קוד למספר הטלפון הנייד שרשום בחשבון שלך. אפשר לאמת את הקוד כדי לאשר את הבקשה? | |
| 123456 | |
| אוקיי, הכרטיס שלך שמסתיים בספרות 4444 יינעל באופן זמני. אחרי הנעילה, לא תוכלו לבצע עסקאות אונליין או במכונות POS באמצעות הכרטיס הזה. האם לאשר את הפעולה הזו? | |
| כן | |
| הכרטיס שלך ננעל בהצלחה. מספר הבקשה שלך הוא 6108410 והיא שותפה בהצלחה עם מספר הטלפון הנייד הרשום שלך. האם ברצונך להנפיק כרטיס חדש? |
|
| כן | |
| הכרטיס יישלח לכתובת הרשומה. אפשר לשאול מה המיקוד של הכתובת למשלוח? | |
| נכון! | |
| בסדר, עליך להמתין כמה שניות בזמן שאנחנו שולחים בקשה להנפקת כרטיס חדש. הבקשה להנפקת כרטיס חדש אושרה. מספר הבקשה שלך הוא 3808109 והיא שותפה בהצלחה עם מספר הטלפון הנייד הרשום שלך. הכרטיס יימסר לכתובת הרשומה שלך תוך 3 ימי עסקים. כדי להשתמש בכרטיס, צריך לפעול לפי ההוראות שצורפו אליו. |
הפעלה מחדש של הכרטיס
הסוכן מזהה שהמשתמש צריך לבצע אימות נוסף ושולח סיסמה חד-פעמית כדי לאמת את הזהות שלו. המשתמש מבקש להפעיל מחדש כרטיס, והסוכן מעביר אותו לנציג אנושי כדי להמשיך.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מסיבות אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. האם תרצה לקבל את הקוד בטלפון? | |
| כן | |
| שלחנו קוד למספר הטלפון שרשום אצלנו ומסתיים ב-5041. התהליך עשוי להימשך כמה שניות. אפשר לאשר את הקוד? | |
| 123456 | |
| האימות שלך בוצע בהצלחה. אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו כמה כרטיסים שרשומים למספר שלך. יש לנו כרטיס ויזה שמסתיים ב-1456, כרטיס מאסטרקארד שמסתיים ב-1457, כרטיס אמריקן אקספרס שמסתיים ב-1345 וכרטיס ויזה שמסתיים ב-3456. נשמח לדעת מהן 4 הספרות האחרונות של הכרטיס שברצונך לנעול או להפעיל מחדש. |
|
| 1456 | |
| ארבע הספרות האחרונות של מספר הכרטיס שקיבלנו הן 1456. זה נכון? | |
| כן | |
| הכרטיס המבוקש כבר נמצא בסטטוס נעילה זמנית. רוצה להפעיל מחדש את הכרטיס או לחסום אותו באופן סופי? | |
| הפעלה מחדש | |
| כדי שנוכל לעזור לך בצורה טובה יותר, עליך להמתין בזמן שאנחנו מעבירים את השיחה. |
מוסכמות למתן שמות
הרכיב המובנה הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | נעילת הכרטיס |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lock_card_locked_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lock_card:lock_card_ticket_number |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר את הפרמטרים בהיקף של זרימת העבודה בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות זרימת שיחות או בדף הפתיחה של הרכיב הזה.
המרכיב המובנה הזה מקבל את פרמטרי הקלט הבאים:
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $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.card_count | (אופציונלי) מספר כרטיסי האשראי שמשויכים למשתמש המאומת. | מספר שלם |
| $flow.card_status_active | מציין את הערך של הפרמטר שמוחזר על ידי Webhook של כרטיס אימות כדי לציין שהכרטיס שנבחר פעיל כרגע. ערך ברירת המחדל הוא "active". |
מחרוזת |
| $flow.card_status_lock_temp | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר נעול באופן זמני. ערך ברירת המחדל הוא "inactive". |
מחרוזת |
| $flow.card_status_lock_permanent | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר נעול באופן קבוע. ערך ברירת המחדל הוא "blocked". |
מחרוזת |
| $flow.card_status_reactivate | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר הופעל מחדש. ערך ברירת המחדל הוא "reactivate". |
מחרוזת |
| $flow.max_retry_card_number | מציין את מספר הניסיונות החוזרים שמותרים כשמבקשים את ארבע הספרות האחרונות של כרטיס האשראי. ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.max_otp_retry_count | מציינת את מספר הניסיונות החוזרים שמותרים כשמבקשים מהמשתמש את הסיסמה החד-פעמית (OTP). ערך ברירת המחדל הוא 3. |
מספר שלם |
כדי להגדיר את פרמטרי הקלט של הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- בוחרים בכרטיסייה Build (פיתוח).
- לוחצים על הרכיב המיובא בקטע Flows (תהליכי עבודה).
- בקטע דפים, לוחצים על דף הפתיחה.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route (מסלול), עורכים את הערכים של Parameter Presets (הגדרות קבועות מראש של פרמטרים) לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המובנה הזה מספק ערכים לפרמטרים הבאים של הפלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| auth_level | מציין את רמת האימות של המתקשר. | מספר שלם |
| phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| 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. |
מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המובנה הזה:
- מייבאים את הרכיב שנוצר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו עם הגדרה שמתארת את השירותים החיצוניים. פרטים נוספים מופיעים בקטע 'הגדרת webhook' בהמשך.
הגדרת webhook
כדי להשתמש ברכיב הזה, תצטרכו להגדיר את הוויבהוקים הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים שלכם.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים עבור הרכיב הזה. הוראות מפורטות זמינות במאמר בנושא הגדרת webhook לאימות.
קבלת פרטי הכרטיס
רכיב ה-webhook של prebuilt_components_account_services:get_card_details משמש לקבלת מידע על הכרטיסים שרשומים על שם המשתמש.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| last_four_digit_of_all_cards | רשימה שמכילה את ארבע הספרות האחרונות של כל כרטיס שרשום על שם המשתמש, לדוגמה ["0000", "1111", "2222"]. כל רכיב ברשימה הזו מייצג את אותו כרטיס כמו הרכיב עם אותו אינדקס ב-card_vendor_all. |
רשימה (מחרוזת) |
| card_vendor_all | רשימה שמכילה את ספק כרטיס האשראי של כל כרטיס שרשום על שם המשתמש, לדוגמה ["Visa", "Mastercard", "Discover"]. כל רכיב ברשימה הזו מייצג את אותו כרטיס כמו הרכיב עם אותו אינדקס ב-last_four_digit_of_all_cards. |
רשימה (מחרוזת) |
| card_count | מספר הכרטיסים שמשויכים למשתמש המאומת. | מספר שלם |
כדי להגדיר את ה-webhook של 'קבלת פרטי כרטיס' עבור הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_account_services:get_card_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
אימות הכרטיס
רכיב ה-webhook משמש כדי לקבל מידע על כרטיס ספציפי שרשום בחשבון של משתמש.prebuilt_components_lock_card:validate_card
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.last_four_digit_of_card_number | ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש ביקש לנעול. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| zip_code | המיקוד שרשום בחשבון של המשתמש. | מחרוזת |
| card_vendor | ספק כרטיס האשראי של הכרטיס שנבחר. | מחרוזת |
| card_status | מציין את הסטטוס הנוכחי של הכרטיס. כברירת מחדל, הערכים התקינים הם active (פעיל), temporarily blocked (חסום זמנית) או permanently blocked (חסום לצמיתות). הסטטוסים האלה מוגדרים על ידי הפרמטרים $flow.card_status_active, $flow.card_status_lock_temp ו-$flow.card_status_lock_permanent. מידע נוסף על פרמטרים של קלט |
מחרוזת |
כדי להגדיר את ה-webhook של אימות הכרטיס לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_lock_card:validate_card.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
נעילת הכרטיס
רכיב ה-webhook prebuilt_components_lock_card:lock_card_ticket_number משמש ליצירת בקשה לנעילת כרטיס שנבחר.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.last_four_digit_of_card_number | ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש ביקש לנעול. | מחרוזת |
| $flow.lock_type | מציין את סוג הנעילה שיוחל על הכרטיס של המשתמש. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_lock_card_lock_type_active. כברירת מחדל, יש תמיכה ב"blocked" (נעילה קבועה) וב"inactive (נעילה זמנית). |
מחרוזת |
| $flow.lock_reason | מציין את הסיבה שבגללה המשתמש ביקש לנעול את הכרטיס. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_lock_card_locked_reason. ברירת המחדל היא תמיכה ב-"damaged", "stolen", "lost" ו-"others". |
מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| ticket_number | מספר הכרטיס של בקשת הנעילה שנוצרה. | מספר שלם |
כדי להגדיר את ה-webhook של כרטיס הנעילה לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook prebuilt_components_lock_card:lock_card_ticket_number.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
הנפקת כרטיס מחדש
רכיב ה-webhook prebuilt_components_lock_card:reissue_card_number משמש ליצירת בקשה להנפקת כרטיס חדש או לשדרוג כרטיס קיים.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.last_four_digit_of_card_number | ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש ביקש לנעול. | מחרוזת |
| zip_code | המיקוד שרשום בחשבון של המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| acknowledgement_number | מספר הכרטיס של הבקשה שנוצרה להנפקת כרטיס חדש. | מספר שלם |
כדי להגדיר את התגובה לפעולה מאתר אחר (webhook) של הרכיב הזה בנושא הנפקת כרטיס מחדש, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_lock_card:reissue_card_number.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.