הרכיב המובנה של כרטיס אבוד או גנוב מאמת את המשתמש, מאחזר כרטיסים שרשומים על שם המשתמש ומאפשר למשתמש לנעול כרטיס. אחרי שהמשתמש מאשר את הכרטיס הנעול, הרכיב מאפשר לו להירשם לשדרוג או להנפיק כרטיס חדש. הרכיב הזה משתמש בגרסה מותאמת אישית של הרכיב המובנה Authentication כדי לאמת את בעלי הכרטיסים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, יש לרכיב המוכן מראש הזה את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הסוכן בתחילת השיחה.
משתמש לא מאומת עם כרטיס אחד
הנציג מזהה שהמשתמש לא אומת בעבר ואוסף מידע כדי לוודא שהמשתמש הוא בעל כרטיס רשום. אחרי שהמשתמש עובר אימות, הסוכן מאחזר מידע על הכרטיס היחיד שרשום על שם המשתמש. המשתמש מאשר שהוא רוצה לנעול את הכרטיס, והנציג נועל את הכרטיס. לבסוף, הסוכן מאשר את הכרטיס המועדף של המשתמש ואת כתובת למשלוח, ומנפיק למשתמש כרטיס חדש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות | |
| תודה, האימות שלך בוצע בהצלחה. | |
| רק רגע, אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו את כרטיס MasterCard שמסתיים בספרות 4444. רוצה לנעול את הכרטיס שלך לצמיתות? |
|
| כן | |
| נשמח לדעת למה בחרת לנעול את הכרטיס. אפשר לבחור מבין האפשרויות כמו פגום, נגנב, אבד או אחרות. | |
| איבדתי את הכרטיס | |
| תודה על המשוב. נעזור לך לנעול את הכרטיס באופן סופי. אפשר לאשר שהכרטיס מסתיים בספרות 4444? | |
| כן | |
| בסדר, לפני שנמשיך, נשלח קוד למספר הטלפון הנייד הרשום שלך. עליך לציין את הקוד כדי לאמת את הבקשה. | |
| 123457 | |
| אוקיי, הכרטיס שלך שמסתיים בספרות 4444 יינעל באופן סופי. אחרי הנעילה, לא תוכלו לבצע עסקאות אונליין או במכונות POS באמצעות הכרטיס הזה. האם לאשר את הפעולה? | |
| כן | |
| הכרטיס שלך ננעל בהצלחה. מספר הבקשה שלך הוא 9761431 והוא נשלח בהצלחה למספר הטלפון הנייד שרשום בחשבון. רוצה להנפיק כרטיס חדש? | |
| כן | |
| אתם עומדים בדרישות לקבלת כרטיס פלטינה. התשלום השנתי הוא 97 דולר, ואפשר לקבל בונוסים שנתיים והטבות מיוחדות בשווי 494 דולר. כדי לקבל מידע נוסף, עליך ללחוץ על הקישור שנשלח למספר הטלפון הנייד הרשום שלך. האם ברצונך להירשם לכרטיס הזה? |
|
| כן | |
| הכרטיס יישלח לכתובת הרשומה. אפשר לשאול אם המיקוד של הכתובת למשלוח הוא 12345? | |
| כן | |
| בסדר, עליך להמתין כמה שניות בזמן שאנחנו שולחים בקשה להנפקת כרטיס חדש. הבקשה להנפקת כרטיס חדש אושרה. מספר הבקשה שלך הוא 4643943 והיא שותפה בהצלחה למספר הטלפון הנייד הרשום שלך. הכרטיס יימסר לכתובת הרשומה שלך תוך 3 ימי עסקים. כדי להשתמש בכרטיס, צריך לפעול לפי ההוראות שצורפו אליו. |
משתמש מאומת עם כמה כרטיסים
הסוכן מזהה שהמשתמש כבר אומת ומאחזר מידע על הכרטיסים שרשומים על שם המשתמש. המשתמש בוחר כרטיס שננעל בעבר, ולכן הסוכן מאפשר למשתמש לבקש כרטיס חדש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו כמה כרטיסים שרשומים עם המספר שלך. יש לנו כרטיס ויזה שמסתיים בספרות 1456, כרטיס מאסטרקארד שמסתיים בספרות 1457, כרטיס מאסטרקארד שמסתיים בספרות 1345 וכרטיס ויזה שמסתיים בספרות 3456 עליך לציין את 4 הספרות האחרונות של הכרטיס שברצונך לנעול. |
|
| 1457 | |
| ארבע הספרות האחרונות של מספר הכרטיס שקיבלנו הן 1457, זה נכון? | |
| כן | |
| הכרטיס המבוקש כבר בסטטוס נעילה קבוע. רוצה להנפיק כרטיס חדש? | |
| כן | |
| הכרטיס יישלח לכתובת הרשומה. אפשר לשאול אם המיקוד של הכתובת למשלוח הוא 12345? | |
| כן | |
| בסדר, עליך להמתין כמה שניות בזמן שאנחנו שולחים בקשה להנפקת כרטיס חדש. הבקשה להנפקת כרטיס חדש אושרה. מספר הבקשה שלך הוא 5423270 והיא שותפה בהצלחה למספר הטלפון הנייד הרשום שלך. הכרטיס יימסר לכתובת הרשומה שלך תוך 3 ימי עסקים. כדי להשתמש בכרטיס, צריך לפעול לפי ההוראות שצורפו אליו. האם תרצה לחסום כרטיס אחר? |
|
| לא, זה הכול מבחינתי | |
| אוקיי, תודה שהתקשרת אלינו. |
מוסכמות למתן שמות
הרכיב המובנה הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | כרטיס שאבד או נגנב |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lost_and_stolen_lock_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lost_and_stolen_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 | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר פעיל כרגע. ערך ברירת המחדל הוא "active". |
מחרוזת |
| $flow.card_status_lock_temp | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר נעול באופן זמני. ערך ברירת המחדל הוא "inactive". |
מחרוזת |
| $flow.card_status_lock_permanent | מציין את הערך של הפרמטר שמוחזר על ידי Validate card webhook כדי לציין שהכרטיס שנבחר נעול באופן קבוע. ערך ברירת המחדל הוא "blocked". |
מחרוזת |
| $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.
אימות הכרטיס
רכיב ה-prebuilt_components_lost_and_stolen_card:validate_cardwebhook משמש
כדי לקבל מידע על כרטיס ספציפי שרשום בחשבון
של משתמש.
פרמטרים של בקשות 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. מידע נוסף על פרמטרים של קלט |
מחרוזת |
| card_upgrade | מציין אם יש שדרוג זמין לכרטיס שנבחר. | בוליאני |
| card_upgrade_type | ההגדרה מציינת את סוג שדרוג הכרטיס שזמין, למשל "gold" או "platinum". אם הערך של card_upgrade הוא false, לא צריך להוסיף את הפרמטר הזה. |
מחרוזת |
| card_upgrade_annual_fee | במאפיין הזה מציינים את סכום העמלה השנתית שנדרשת לשדרוג הכרטיס, למשל 150. אם הערך של card_upgrade הוא false, לא צריך להוסיף את הפרמטר הזה. |
מספר |
| card_upgrade_benefit | המדיניות מציינת את סכום ההטבות בדולרים שזמינות לשדרוג הכרטיס, למשל 450. אם הערך של card_upgrade הוא false, לא צריך להוסיף את הפרמטר הזה. |
מספר |
| reissue_status | מציין אם הונפק כרטיס חדש במקום הכרטיס הזה. | בוליאני |
| dispatch_status | מציין אם הכרטיס שהונפק מחדש נשלח לכתובת הרשומה. אם הערך של reissue_status הוא false, הערך של dispatch_status חייב להיות false. |
בוליאני |
| card_estimated_duration | הזמן המשוער למסירת כרטיס חדש, לדוגמה "2 days" או "24 hours". אם הערך של reissue_status הוא false, לא צריך להוסיף את הפרמטר הזה. |
מחרוזת |
כדי להגדיר את ה-webhook של אימות הכרטיס לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_lost_and_stolen_card:validate_card.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
נעילת הכרטיס
רכיב ה-webhook prebuilt_components_lost_and_stolen_card:lock_card_ticket_number משמש ליצירת בקשה לנעילת כרטיס שנבחר.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.last_four_digit_of_card_number | ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש ביקש לנעול. | מחרוזת |
| $flow.lock_type | מציין את סוג הנעילה שיוחל על הכרטיס של המשתמש. כברירת מחדל, הרכיב הזה תומך בנעילות קבועות של כרטיסים שאבדו או נגנבו. סוגי הנעילה התקינים מוגדרים על ידי הפרמטרים $flow.card_status_active, $flow.card_status_lock_temp ו-$flow.card_status_lock_permanent. מידע נוסף על פרמטרים של קלט |
מחרוזת |
| $flow.lock_reason | מצוינת הסיבה שבגללה המשתמש ביקש לנעול את הכרטיס. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_lost_and_stolen_lock_reason. ברירת המחדל היא תמיכה ב-"damaged", "stolen", "lost" ו-"others". |
מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| ticket_number | מספר הכרטיס של בקשת הנעילה שנוצרה. | מספר שלם |
כדי להגדיר את ה-webhook של כרטיס הנעילה לרכיב הזה, אפשר להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook prebuilt_components_lost_and_stolen_card:lock_card_ticket_number.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הנפקת כרטיס מחדש
רכיב ה-webhook prebuilt_components_lost_and_stolen_card:reissue_card_number משמש ליצירת בקשה להנפקת כרטיס חדש או לשדרוג כרטיס קיים.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.last_four_digit_of_card_number | ארבע הספרות האחרונות של מספר הכרטיס שהמשתמש ביקש לנעול. | מחרוזת |
| zip_code | המיקוד שרשום בחשבון של המשתמש. | מחרוזת |
| card_upgrade | מציין אם המשתמש בחר לשדרג את הכרטיס שלו. | בוליאני |
| card_upgrade_type | מציין את סוג שדרוג הכרטיס שנבחר על ידי המשתמש, למשל "gold" או "platinum". אם הערך של card_upgrade הוא false, לא צריך להוסיף את הפרמטר הזה. |
מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| acknowledgement_number | מספר הכרטיס של הבקשה שנוצרה להנפקת כרטיס חדש. | מספר שלם |
כדי להגדיר את התגובה לפעולה מאתר אחר (webhook) של הנפקת כרטיס מחדש לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_lost_and_stolen_card:reissue_card_number.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.