רכיב מובנה מראש לאימות קמעונאי

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

הרכיב הזה משתמש ברכיב המובנה Telephone number collection כדי לאסוף ולאמת את פרטי הטלפון של הלקוח.

רמות אימות

רכיבים שונים שנוצרו מראש דורשים רמות שונות של אימות, ורמות גבוהות יותר דורשות יותר פרטי משתמש. רכיב האימות של הקמעונאי מאפשר למשתמש לבצע אימות ברמה 0 (התאמת ANI) או ברמה 1 (בסיסי), כמו שמתואר בטבלה הבאה.

רמת האימות דרישות
רמה 0: התאמה של ANI המשתמש מאומת באמצעות שיחה ממספר טלפון שתואם לחשבון רשום, או באמצעות מסירת מספר טלפון כזה.

אפשר לאמת את המשתמש לרמה 0 באמצעות הרכיב המוגדר מראש Greeting.
רמה 1: בסיסית המשתמש מאומת באמצעות קוד סיסמה חד-פעמית (OTP) שנשלח לכתובת האימייל או למספר הטלפון שלו.

סוגי המשתמשים הנתמכים

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

מגבלות

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

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

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

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

אימות ברמה 0 בוצע בהצלחה: התאמת ANI

המשתמש מתקשר ממספר טלפון שרשום בחשבון קיים, מאמת את הזהות שלו ומאומת בהצלחה לרמה 0.

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

אימות מוצלח ברמה 1: סיסמה חד-פעמית (OTP)

  1. המשתמש מתקשר ממספר טלפון לא מזוהה.
  2. הרכיב אוסף את מספר הטלפון הרשום של המשתמש, ואז שולח ומבקש מהמשתמש לאשר את ה-OTP שנשלח לערוץ שהוא בחר.
  3. המשתמש מזין OTP תקף ומאמת את הזהות שלו בהצלחה ברמה 1.
הטקסט של המשתמש התשובה של הסוכן
לא מצאנו את מספר הטלפון הזה במערכת שלנו. עליך לציין את מספר הטלפון הרשום.
הנציג אוסף את מספר הטלפון באמצעות הרכיב המוגדר מראש Telephone number collection.
מעולה, סיימנו לאסוף את מספר הטלפון.

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

מוסכמות למתן שמות

הרכיב הזה משתמש במוסכמות הבאות למתן שמות:

תכונה פורמט דוגמה
Flow [שם הרכיב] אימות קמעונאי
כוונה ספציפית לרכיב prebuilt_components_[component_name]_[intent_name] prebuilt_components_retail_authentication_incorrect_phone_number
סוג ישות prebuilt_components_[component_name]_[entity_type] prebuilt_components_channel_email_phone
תגובה לפעולה מאתר אחר (webhook) prebuilt_components_[component_name]:[webhook_action] prebuilt_components_retail_authentication:verify_user_details

פרמטרים של קלט

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

הרכיב הזה מקבל את הפרמטרים הבאים:

שם הפרמטר תיאור פורמט הקלט
$session.params.auth_level_req מגדירה את רמת האימות של המשתמש. הערכים התקינים הם 0 או 1. מספר שלם
$session.params.auth_level (אופציונלי) מציין את רמת האימות הנוכחית של המשתמש. מספר שלם
‎$session.params.phone_number (אופציונלי) מספר הטלפון של המשתמש. אם לא תספקו את הפרמטר הזה, הרכיב יאסוף את מספר הטלפון מהמשתמש. מחרוזת
$flow.max_retry_phone_number מספר הניסיונות החוזרים המותרים לאיסוף מספר הטלפון של המשתמש. ערך ברירת המחדל הוא 3. מספר שלם
$flow.max_retry_otp מספר הניסיונות המותרים לאיסוף סיסמה חד-פעמית. ערך ברירת המחדל הוא 3. מספר שלם
$flow.max_retry_otp_not_received מספר הניסיונות החוזרים שמותרים כשלא מתקבלת סיסמה חד-פעמית. ערך ברירת המחדל הוא 1. מספר שלם
$flow.max_retry_otp_confirm_channel מספר הניסיונות החוזרים המותרים כשבוחרים את הערוץ לקבלת סיסמה חד-פעמית. ערך ברירת המחדל הוא 3. מספר שלם

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

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה יצירה.
  5. לוחצים על הרכיב המיובא בקטע Flows.
  6. בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
  7. לוחצים על המסלול true בדף הפתיחה.
  8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
  9. לוחצים על Save.

פרמטרים של פלט

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

הרכיב המוגדר מראש הזה מספק ערכים לפרמטרים הבאים של הפלט:

שם הפרמטר תיאור פורמט הפלט
auth_level מציין את רמת האימות הנוכחית של המשתמש. מספר שלם
all_recent_order_id רשימה של מזהי הזמנות שמשויכים למשתמש המאומת, ממוינת לפי תאריך ביצוע ההזמנה בסדר יורד. הרכיב הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null. רשימה (מחרוזת)
phone_number מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. מחרוזת
אימייל כתובת האימייל שרשומה בחשבון. מחרוזת
user_first_name השם הפרטי של המשתמש, שמשמש לברכת שלום ולאישור הבעלות על החשבון. מחרוזת
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)

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

אימות פרטי המשתמש

ה-webhook‏ prebuilt_components_retail_authentication:verify_user_details מאחזר את פרטי חשבון המשתמש על סמך מספר הטלפון שסופק.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. מחרוזת

פרמטרים של תגובה מה-API

הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:

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

כדי להגדיר את ה-webhook לאימות פרטי המשתמש ברכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_retail_authentication:verify_user_details.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

שליחת סיסמה חד-פעמית (OTP)

הרכיב משתמש ב-webhook של prebuilt_components_retail_authentication:send_otp כדי לשלוח סיסמה חד-פעמית (OTP) לערוץ רשום שהמשתמש בחר.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:

שם הפרמטר תיאור פורמט הקלט
‎$session.params.phone_number מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. מחרוזת
$flow.channel הערוץ שהמשתמש בחר לקבל בו את הסיסמה החד-פעמית. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_channel_email_phone. כברירת מחדל, יש תמיכה רק ב-email וב-phone. מחרוזת

פרמטרים של תגובה מה-API

הרכיב שולף את הפרמטרים הבאים מהתגובה מה-API:

שם הפרמטר תיאור פורמט הפלט
generated_otp הערך של ה-OTP שנוצר ונשלח למשתמש בערוץ שנבחר. מחרוזת

כדי להגדיר את ה-webhook של שליחת OTP לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_retail_authentication:send_otp.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על Save.

הושלמה

הרכיב המוגדר מראש וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.