הרכיב המוגדר מראש לאימות אוסף מידע מהמשתמש כדי להגיע לרמת האימות הנדרשת. הרכיב הזה כולל דרישות אימות שנפוצות בתעשיית השירותים הפיננסיים (FSI), אבל לא רק בה. הוא משתמש ברכיבים המוכנים מראש איסוף תאריך תפוגה של כרטיס אשראי, איסוף תאריך לידה ו-איסוף מספר טלפון כדי לאסוף ולאמת את פרטי המשתמש.
רמות אימות
רכיבים שונים שנוצרו מראש דורשים רמות שונות של אימות, ורמות גבוהות יותר דורשות יותר פרטי משתמש כדי לבצע אימות.
רכיב האימות מאפשר למשתמש לבצע אימות ברמה 0 (התאמת ANI), ברמה 1 (בסיסי) או ברמה 2 (אימות רב-שלבי), כפי שמתואר בטבלה הבאה:
| רמת האימות | דרישות |
|---|---|
| רמה 0: התאמה ל-ANI | אימות המשתמש באמצעות שיחה ממספר טלפון או מסירת מספר טלפון שתואם לחשבון רשום. המשתמש יכול לבצע אימות לרמה 0 באמצעות הרכיב המובנה של ברכת שלום. |
| רמה 1: בסיסית | מאמת את המשתמש באמצעות קוד סיסמה חד-פעמית (OTP) שנשלח לכתובת האימייל או למספר הטלפון שלו. אם האימות באמצעות OTP נכשל, המשתמש יכול לענות על שלוש מתוך ארבע שאלות אבטחה כדי לאמת את הזהות שלו: תאריך לידה, ארבע הספרות האחרונות של כרטיס החיוב המיידי או תאריך התפוגה של כרטיס האשראי (בהתאם לסוג החשבון או הכרטיס), סכום העסקה האחרונה ואמצעי התשלום האחרון של חשבון כרטיס האשראי. |
| רמה 2: אימות רב-שלבי | בנוסף, מאמת את המשתמש על ידי אימות של מפתח אבטחה שנוצר על ידי אפליקציה לאימות חשבונות חיצונית או התראה. |
סוגי המשתמשים הנתמכים
רכיב האימות תומך בלקוחות בנק רשומים שהם בעלי חשבון, בעלי כרטיס או שניהם. הרכיב תומך גם באימות של משתמשים שלא רשומים כלקוחות בנק, אבל יש להם ייפוי כוח לחשבונות שרשומים בבנק. למשתמש יכולים להיות חשבון אחד או יותר או כרטיסים שרשומים בבנק.
סוגי אימות
הרכיב הזה מאפשר לכם להגדיר אם המשתמש צריך לעבור אימות כבעל החשבון, כבעל הכרטיס או כשניהם. אפשר להגדיר את האפשרויות האלה באמצעות הפרמטרים של הקלט $session.params.account_auth_enabled ו-$session.params.card_auth_enabled.
בטבלה הבאה מתוארת ההתנהגות של הרכיב בשילובים שונים של ערכים בדגלי האימות של החשבון והכרטיס:
account_auth_enabled |
card_auth_enabled |
סוג אימות |
|---|---|---|
true |
false |
המשתמש מאומת כבעל החשבון, ומוודא שהוא מחזיק בחשבון אחד או יותר בבנק ומאשר שאלות אבטחה, כולל ארבע הספרות האחרונות של כרטיס החיוב המיידי הרשום. |
false |
true |
המשתמש מאומת כמחזיק כרטיס, מאמת שיש לו כרטיס אשראי אחד או יותר בבנק ומאשר שאלות אבטחה, כולל תאריך התפוגה של כרטיס אשראי רשום. |
true |
true |
הרכיב בודק קודם אם המשתמש הוא בעל חשבון רשום. אם למשתמש יש חשבון אחד או יותר בבנק, הרכיב מאמת את המשתמש באמצעות פרטי החשבון. אם למשתמש אין חשבונות בבנק, הרכיב מנסה לאמת את המשתמש באמצעות פרטי בעל הכרטיס. |
false |
false |
הרכיב בודק קודם אם המשתמש הוא בעל חשבון רשום. אם למשתמש יש חשבון אחד או יותר בבנק, הרכיב מאמת את המשתמש לאימות ברמה 0. אם למשתמש אין חשבונות בבנק, הרכיב בודק אם המשתמש הוא בעל כרטיס. אם למשתמש יש כרטיס אשראי אחד או יותר בבנק, הרכיב מאמת את המשתמש לאימות ברמה 0. |
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הסיסמאות החד-פעמיות נשלחות רק למספר טלפון נייד או לכתובת אימייל שנרשמו בעבר בחשבון. הרכיב לא משתמש ב-OTP כדי לאמת לקוחות שמתקשרים ממספר טלפון חלופי שלא רשום בחשבון שלהם. כשמתקשרים ממספר טלפון חלופי, המשתמש מאומת באמצעות שאלות אבטחה.
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
הדיאלוגים לדוגמה הבאים מדגימים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. בתיבות הדו-שיח מוצגת ההתנהגות כשמתבצעת שיחה טלפונית לרכיב, שמפעילה את כוונת המשתמש שמוגדרת כברירת מחדל להודעת הפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
אימות מוצלח ברמה 1: סיסמה חד-פעמית (OTP)
- הרכיב מאמת שהמשתמש אומת לרמה 0.
- הרכיב שולח סיסמה חד-פעמית לערוץ שהמשתמש בחר.
- הרכיב מבקש מהמשתמש לאשר את הסיסמה החד-פעמית.
- המשתמש מספק סיסמה חד-פעמית (OTP) תקינה כדי לאמת את רמה 1.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| מטעמי אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. איך אתם מעדיפים לקבל את הקוד, בטלפון או באימייל? | |
| טלפון | |
| שלחנו קוד למספר הטלפון הרשום שלך שמסתיים ב-0000. התהליך יכול להימשך כמה שניות. אפשר לבקש ממך לאשר את הקוד? | |
| הקוד הוא 123457 | |
| תודה, האימות בוצע בהצלחה. |
אימות מוצלח ברמה 1: שאלות אבטחה
- הרכיב מאשר את האימות ברמה 0 של המשתמש על ידי איסוף ואימות של מספר הטלפון שסופק.
- הרכיב מבקש מהמשתמש לענות על שלוש שאלות אבטחה ומאמת את התשובות הנכונות, כולל תאריך הלידה, ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי של המשתמש וסכום העסקה האחרונה.
- המשתמש מאמת את הזהות שלו בהצלחה ברמה 1.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| האם יש לך חשבון בבנק שלנו, או שיש לך ייפוי כוח? כדי לאשר, צריך להגיד "כן" או "לא". | |
| כן | |
| בסדר, אנחנו צריכים לקבל את מספר הטלפון שלך כדי לאחזר את פרטי החשבון. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש איסוף מספר טלפון. | |
| הבנתי. המספר שציינת הוא פלוס 1 6502530000, נכון? | |
| כן | |
| מעולה, סיימנו לאסוף את מספר הטלפון. אוקיי, מטעמי אבטחה נצטרך עוד קצת מידע כדי לאמת את הזהות שלך. |
|
| הנציג אוסף את תאריך הלידה של המשתמש באמצעות הרכיב המוגדר מראש Date of birth collection. | |
| אוקיי, תאריך הלידה שלך הוא 3 בפברואר 1995, נכון? | |
| כן | |
| מעולה, קיבלנו את תאריך הלידה שלך. עכשיו צריך להזין את ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי. |
|
| It's 1234 | |
| מה היה הסכום של העסקה האחרונה שלך? לדוגמה, אם סכום העסקה האחרונה היה 100.30$, אומרים "100". | |
| זה היה 500 דולר | |
| תודה, האימות בוצע בהצלחה. |
אימות מוצלח ברמה 2: אימות דו-שלבי
- המשתמש כבר אומת בעבר ברמה 1.
- המשתמש יוצר מפתח אבטחה באמצעות אפליקציית הבנק או אפליקציה לאימות חשבונות.
- המשתמש מספק את מפתח האבטחה לרכיב כדי לאמת את רמה 2.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| צריך לשתף את מפתח האבטחה. יוצרים את מפתח האבטחה בן 6 הספרות באפליקציה של הבנק או באפליקציה לאימות חשבונות. לאחר מכן אומרים או מזינים את הספרות. |
|
| 232425 | |
| תודה, האימות בוצע בהצלחה. |
הכחשת מידע
- המשתמש מסרב לספק את המידע שנדרש לאימות.
- הרכיב נסגר ומוצגת הודעת שגיאה.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| מטעמי אבטחה, אנחנו צריכים לאמת את הזהות שלך, ולכן נשלח לך קוד. איך אתם מעדיפים לקבל את הקוד, בטלפון או באימייל? | |
| לא, אני לא רוצה לשתף | |
| בסדר, מטעמי אבטחה נצטרך עוד קצת מידע כדי לאמת את הזהות שלך. | |
| הנציג אוסף את תאריך הלידה של המשתמש באמצעות הרכיב המוגדר מראש Date of birth collection. | |
| אוקיי, תאריך הלידה שלך הוא 3 בפברואר 1995, נכון? | |
| כן | |
| מעולה, קיבלנו את תאריך הלידה שלך. עכשיו צריך להזין את ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי. |
|
| It's 1234 | |
| מה היה הסכום של העסקה האחרונה שלך? לדוגמה, אם סכום העסקה האחרונה היה 100.30$, אומרים "100". | |
| אני לא רוצה לשתף את הפרטים | |
| לא הצלחנו לאמת את הזהות שלך, ולכן אנחנו לא יכולים להשלים את הפעולה הזו. אנו מתנצלים על אי הנוחות. |
מוסכמות למתן שמות
הרכיב הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | אימות |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_authentication_power_of_attorney |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_authentication_payment_mode |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_authentication:telephony_verification |
פרמטרים של קלט
פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים כדי לקבוע את ההתנהגות של הרכיב. המשתמש צריך להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בטבלה הבאה. המתקשר יכול להגדיר פרמטרים ברמת הסשן באמצעות תהליך שיחה או בדף הפתיחה של הרכיב הזה.
הרכיב הזה מקבל את הפרמטרים הבאים:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.auth_level | (אופציונלי) מציין את רמת האימות הנוכחית של המשתמש. | מספר שלם |
| $session.params.auth_level_req | מגדירה את רמת האימות של המשתמש. הערכים התקינים הם 0, 1 או 2. |
מספר שלם |
| $session.params.account_auth_enabled | מציין אם המשתמש צריך לעבור אימות כבעל החשבון. ההתנהגות של הרכיב תלויה בערך הזה ובערך של $session.params.card_auth_enabled, כפי שמתואר בקטע רמות אימות. |
בוליאני |
| $session.params.card_auth_enabled | מציין אם המשתמש צריך לעבור אימות כבעל הכרטיס. ההתנהגות של הרכיב תלויה בערך הזה ובערך של $session.params.account_auth_enabled, כפי שמתואר בקטע רמות אימות. |
בוליאני |
| $session.params.phone_number | (אופציונלי) מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. אם לא תספקו את הפרמטר הזה, הרכיב יאסוף את מספר הטלפון מהמשתמש. | מחרוזת |
| $flow.max_retry_telephone_counter | מציינת את מספר הניסיונות החוזרים המותרים כשמבקשים מהמשתמש להזין את מספר הטלפון שלו. ערך ברירת המחדל הוא 1. |
מספר שלם |
| $flow.max_retry_security_ans_count | מציינת את מספר הניסיונות החוזרים המותרים כשמזינים תשובות לשאלות אבטחה. ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.max_retry_security_key | מציינת את מספר הניסיונות החוזרים המותרים כשמנסים לאסוף את מפתח האבטחה. ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.max_retry_otp_not_received | מציינת את מספר הניסיונות החוזרים המותרים כשלא מתקבלת סיסמה חד-פעמית (OTP). ערך ברירת המחדל הוא 1. |
מספר שלם |
| $flow.max_retry_otp_count | מציינת את מספר הניסיונות החוזרים שמותרים כשמזינים את הסיסמה החד-פעמית (OTP). ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.security_ans_denial_count | מציינת את מספר הניסיונות החוזרים המותרים כשמשתמש מסרב לספק את המידע המבוקש. ערך ברירת המחדל הוא 1. |
מספר שלם |
| $flow.security_ans_mid_count | המדיניות הזו מציינת את מספר התשובות השגויות לשאלות האבטחה שמשתמש יכול לספק. ערך ברירת המחדל הוא 2, כלומר אם המתקשר מספק תשובות שגויות לשתי שאלות שונות, הרכיב יוצא עם כשל. |
מספר שלם |
| $flow.max_retry_card_counter | מציין את מספר הניסיונות החוזרים המותרים כשמבקשים את ארבע הספרות האחרונות של כרטיס החיוב המיידי של המשתמש. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.security_key_length | המדיניות הזו מציינת את האורך התקין של מפתח האבטחה שסופק על ידי האפליקציה לאימות חשבונות לצורך אימות ברמה 2. ערך ברירת המחדל הוא 6. |
מספר שלם |
| $flow.otp_length | מציינת את האורך החוקי של הסיסמה החד-פעמית (OTP) לאימות ברמה 1. ערך ברירת המחדל הוא 6. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי שהמשתמש יוצא מהרכיב. הפרמטרים האלה מכילים מידע חשוב שהרכיב אוסף.
הרכיב המוגדר מראש הזה מספק ערכים לפרמטרים הבאים של הפלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| auth_level | מציינת את רמת האימות הנוכחית של המשתמש. | מספר שלם |
| phone_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_authentication:telephony_verification משמש את הרכיב כדי לאחזר את פרטי חשבון המשתמש על סמך מספר הטלפון שסופק.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| account_count | מספר החשבונות שמשויכים למספר הטלפון הרשום. החשבונות האלה כוללים חשבונות עצמיים וחשבונות שלמשתמש יש ייפוי כוח לגביהם. | מספר שלם |
| last_four_digit_of_account_number | אם למשתמש יש חשבון אחד, יוחזרו ארבע הספרות האחרונות של מספר החשבון. אם למשתמש יש יותר מחשבון אחד, הערך של הפרמטר הזה הוא null. |
מחרוזת |
| אימייל | כתובת האימייל שרשומה בחשבון. אם אין כתובת אימייל שרשומה בחשבון, הערך של הפרמטר הזה הוא null. |
מחרוזת |
כדי להגדיר את ה-webhook לאימות טלפוני ברכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_authentication:telephony_verification.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת פרטי כרטיס אשראי
הרכיב משתמש ב-webhook של prebuilt_components_account_services:get_credit_card_details כדי לאחזר מידע על כרטיסי האשראי שרשומים למשתמש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| credit_card_count | מספר כרטיסי האשראי שמשויכים למספר הטלפון הרשום. | מספר שלם |
| last_four_digit_of_credit_card_number | אם למשתמש יש כרטיס אשראי אחד, יוחזרו ארבע הספרות האחרונות של מספר הכרטיס. אם למשתמש יש יותר מכרטיס אחד, הערך של הפרמטר הזה הוא null. |
מחרוזת |
| אימייל | כתובת האימייל שרשומה בחשבון. אם אין כתובת אימייל שרשומה בחשבון, הערך של הפרמטר הזה הוא null. |
מחרוזת |
כדי להגדיר את ה-webhook "קבלת פרטי כרטיס אשראי" לרכיב הזה, הרחיבו את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhook).
- בוחרים את ה-webhook prebuilt_components_account_services:get_credit_card_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת OTP
ה-webhook של prebuilt_components_authentication:send_otp שולח סיסמה חד-פעמית (OTP) לערוץ רשום שאתם בוחרים.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. | מחרוזת |
| $flow.channel | הערוץ שהמשתמש בחר לקבל בו את הסיסמה החד-פעמית. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_authentication_channel. כברירת מחדל, יש תמיכה ב-email וב-mobile. |
מחרוזת |
פרמטרים של תגובה מה-API
הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| generated_otp | הערך של הסיסמה החד-פעמית שנוצרה ונשלחה למשתמש בערוץ שנבחר. | מחרוזת |
כדי להגדיר את ה-webhook של שליחת ה-OTP לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_authentication:send_otp.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
תשובות לשאלות אבטחה
ה-webhook של prebuilt_components_authentication:security_answers מאחזר את התשובות לשאלות האבטחה של המשתמש מהחשבון הרשום שלו.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| security_last_trans_amount | מציין את הסכום המלא של העסקה האחרונה של המשתמש, ללא סמל מטבע. לדוגמה, אם סכום העסקה האחרונה של המשתמש הוא 100.30 דולר ארה"ב, הערך הצפוי של השדה הזה הוא "100.30". |
מחרוזת |
| last_payment_mode | אמצעי התשלום ששימש לעסקה האחרונה של המשתמש, עם ערכים חוקיים שמוגדרים על ידי הישות המותאמת אישית prebuilt_components_authentication_payment_mode. כברירת מחדל, הערכים האלה כוללים את mobile, upi, online, debit, credit ו-account. |
מחרוזת |
| security_card_number | ארבע הספרות האחרונות של מספר כרטיס החיוב המיידי של המשתמש. | מחרוזת |
| user_dob | תאריך הלידה של המשתמש בפורמט YYYY-MM-DD. | מחרוזת |
| cards_exp_date_all | תאריכי התפוגה של כל כרטיסי האשראי שרשומים אצל המשתמש בפורמט MMYYYY. | רשימה (מחרוזת) |
כדי להגדיר את ה-webhook של התשובות לשאלות האבטחה ברכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_authentication:security_answers.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
אימות דו-שלבי
ה-webhook של prebuilt_components_authentication:2fa_validation מאפשר לרכיב לאמת את מפתח האבטחה שהמשתמש סיפק לאימות דו-שלבי.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, בלי קוד המדינה. | מחרוזת |
| $flow.security_key | מפתח האבטחה שהמשתמש סיפק, שנוצר באמצעות אפליקציה של בנק או אפליקציה לאימות חשבונות. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| security_key_verified | מציין אם מפתח האבטחה שהמשתמש סיפק תקין. true מציין שמפתח האבטחה שסופק תקין. השגיאה false מציינת שמפתח האבטחה שסופק לא תקין. |
בוליאני |
כדי להגדיר את ה-webhook לאימות דו-שלבי ברכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_authentication:2fa_validation.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הרכיב המוגדר מראש וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.