הרכיב המוגדר מראש לדיווח על כרטיס שאבד או נגנב מאמת את המשתמש, מאחזר את הכרטיסים שרשומים על שם המשתמש ומאפשר למשתמש לנעול כרטיס. אחרי שהמשתמש מאשר את הכרטיס הנעול, הרכיב מאפשר לו להירשם לשדרוג או להנפיק כרטיס חדש. הרכיב הזה משתמש בגרסה מותאמת אישית של הרכיב המוגדר מראש Authentication כדי לאמת את בעלי הכרטיס.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
משתמש לא מאומת עם כרטיס אחד
הנציג מזהה שהמשתמש לא אומת בעבר ואוסף מידע כדי לוודא שהמשתמש הוא בעל כרטיס רשום. אחרי שהמשתמש מאומת, הנציג מאחזר מידע על הכרטיס היחיד שרשום למשתמש. המשתמש מאשר שהוא רוצה לנעול את הכרטיס, והנציג נועל את הכרטיס. לבסוף, הנציג מאשר את הכרטיס המועדף על המשתמש ואת הכתובת למשלוח, ומנפיק כרטיס חדש למשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Authentication | |
| תודה, האימות בוצע בהצלחה. | |
| אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו את כרטיס המאסטרקארד שלך שמסתיים בספרות 4444. רוצה לנעול את הכרטיס באופן סופי? |
|
| כן | |
| נשמח לדעת למה בחרת לנעול את הכרטיס. אפשר לבחור מבין האפשרויות הבאות: ניזוק, נגנב, אבד או אחר. | |
| איבדתי את הכרטיס שלי | |
| תודה על המשוב. נעזור לכם לנעול את הכרטיס באופן סופי. אפשר לבקש ממך לאשר שארבע הספרות האחרונות של הכרטיס הן 4444? | |
| כן | |
| בסדר, לפני שנמשיך, נשלח קוד למספר הטלפון הנייד הרשום שלך. כדי לאמת את הבקשה, צריך להזין את הקוד. | |
| 123457 | |
| בסדר, הכרטיס שלך שמסתיים בספרות 4444 יינעל באופן סופי. אחרי הנעילה, לא תוכלו לבצע עסקאות אונליין או במכונות POS באמצעות הכרטיס הזה. רוצה לאשר את הפעולה? | |
| כן | |
| הכרטיס ננעל. מספר הבקשה שלך הוא 9761431 והוא נשלח בהצלחה למספר הטלפון הנייד הרשום שלך. רוצה להנפיק כרטיס חדש? | |
| כן | |
| אתם זכאים לכרטיס פלטינה. התשלום השנתי הוא 97 דולר, ואפשר לקבל בונוסים שנתיים והטבות מיוחדות בשווי 494 דולר. כדי לקבל מידע נוסף, צריך ללחוץ על הקישור שנשלח למספר הטלפון הנייד הרשום שלך. רוצה להירשם לכרטיס הזה? |
|
| כן | |
| אנחנו נשלח את הכרטיס לכתובת הרשומה שלכם. האם המיקוד של הכתובת למשלוח הוא 12345? | |
| כן | |
| בסדר, צריך להמתין כמה שניות בזמן שאנחנו שולחים את הבקשה להנפקת כרטיס חדש. הבקשה להנפקת כרטיס חדש נשלחה בהצלחה. מספר הבקשה שלך הוא 4643943 והוא נשלח בהצלחה למספר הטלפון הנייד הרשום שלך. הכרטיס יישלח לכתובת הרשומה שלך תוך 3 ימי עסקים. כדי להשתמש בכרטיס, צריך לפעול לפי ההוראות שצורפו אליו. |
משתמש מאומת עם כמה כרטיסים
הנציג מזהה שהמשתמש כבר אומת בעבר ומאחזר מידע על הכרטיסים שרשומים למשתמש. המשתמש בוחר כרטיס שננעל בעבר, והנציג מאפשר למשתמש לבקש כרטיס חדש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו מאחזרים את פרטי הכרטיס שלך. מצאנו כמה כרטיסים שרשומים עם המספר שלך. יש לנו כרטיס Visa שמסתיים בספרות 1456, כרטיס MasterCard שמסתיים בספרות 1457, כרטיס MasterCard שמסתיים בספרות 1345 וכרטיס Visa שמסתיים בספרות 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 | מציין את ערך הפרמטר שמוחזר על ידי ה-webhook לאימות הכרטיס כדי לציין שהכרטיס שנבחר פעיל כרגע. ערך ברירת המחדל הוא "active". |
מחרוזת |
| $flow.card_status_lock_temp | מציין את ערך הפרמטר שמוחזר על ידי ה-webhook לאימות הכרטיס כדי לציין שהכרטיס שנבחר נעול באופן זמני. ערך ברירת המחדל הוא "inactive". |
מחרוזת |
| $flow.card_status_lock_permanent | מציין את ערך הפרמטר שמוחזר על ידי ה-webhook לאימות הכרטיס כדי לציין שהכרטיס שנבחר נעול באופן סופי. ערך ברירת המחדל הוא "blocked". |
מחרוזת |
| $flow.max_retry_card_number | מציין את מספר הניסיונות החוזרים המותרים כשמבקשים את ארבע הספרות האחרונות של כרטיס האשראי. ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.max_otp_retry_count | מציינת את מספר הניסיונות החוזרים שמותרים כשמבקשים מהמשתמש להזין את הסיסמה החד-פעמית (OTP). ערך ברירת המחדל הוא 3. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages, לוחצים על Start Page.
- לוחצים על המסלול 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)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים ברכיב הזה. הוראות מפורטות זמינות במאמר הגדרת תגובה לפעולה מאתר אחר (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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
אימות הכרטיס
הרכיב משתמש ב-webhook prebuilt_components_lost_and_stolen_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 | מציין את הסטטוס הנוכחי של הכרטיס. כברירת מחדל, הערכים התקינים הם: פעיל, חסום זמנית או חסום באופן סופי. הסטטוסים האלה מוגדרים על ידי הפרמטרים $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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.