הרכיב המוגדר מראש לאימות קמעונאי אוסף מידע כדי לאמת את הלקוח ברמת האימות הנדרשת. הרכיב הזה שנוצר מראש כולל דרישות אימות נפוצות, אבל לא בלעדיות לתחום הקמעונאות.
הרכיב הזה משתמש ברכיב המובנה Telephone number collection כדי לאסוף ולאמת את פרטי הטלפון של הלקוח.
רמות אימות
רכיבים שונים שנוצרו מראש דורשים רמות שונות של אימות, ורמות גבוהות יותר דורשות יותר פרטי משתמש. רכיב האימות של הקמעונאי מאפשר למשתמש לבצע אימות ברמה 0 (התאמת ANI) או ברמה 1 (בסיסי), כמו שמתואר בטבלה הבאה.
| רמת האימות | דרישות |
|---|---|
| רמה 0: התאמה של ANI | המשתמש מאומת באמצעות שיחה ממספר טלפון שתואם לחשבון רשום, או באמצעות מסירת מספר טלפון כזה. אפשר לאמת את המשתמש לרמה 0 באמצעות הרכיב המוגדר מראש Greeting. |
| רמה 1: בסיסית | המשתמש מאומת באמצעות קוד סיסמה חד-פעמית (OTP) שנשלח לכתובת האימייל או למספר הטלפון שלו. |
סוגי המשתמשים הנתמכים
רכיב האימות של הקמעונאי תומך במשתמשים עם מספר טלפון וכתובת אימייל רשומים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:
- הסיסמאות החד-פעמיות נשלחות רק למספר טלפון נייד או לכתובת אימייל שהלקוח רשם בעבר. הרכיב לא ישתמש ב-OTP כדי לאמת לקוחות שמתקשרים ממספר טלפון חלופי שלא רשום בחשבון. כשהמשתמש מתקשר ממספר טלפון חלופי, המערכת משתמשת בשאלות אבטחה כדי לאמת את הזהות שלו.
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.
אימות ברמה 0 בוצע בהצלחה: התאמת ANI
המשתמש מתקשר ממספר טלפון שרשום בחשבון קיים, מאמת את הזהות שלו ומאומת בהצלחה לרמה 0.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| שלום, המספר שחייגת אליו מקושר לחשבון של יונתן. האם השאלה שלך היא לגבי הזמנה של מישהו אחר? אם כן, צריך להגיד "כן". אם לא, צריך להגיד "לא". | |
| לא | |
| תודה, יוני. הזיהוי בוצע בהצלחה. |
אימות מוצלח ברמה 1: סיסמה חד-פעמית (OTP)
- המשתמש מתקשר ממספר טלפון לא מזוהה.
- הרכיב אוסף את מספר הטלפון הרשום של המשתמש, ואז שולח ומבקש מהמשתמש לאשר את ה-OTP שנשלח לערוץ שהוא בחר.
- המשתמש מזין 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. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה יצירה.
- לוחצים על הרכיב המיובא בקטע Flows.
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על 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. |
מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב המוגדר מראש.
- מגדירים את ה-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 לאימות פרטי המשתמש ברכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_retail_authentication:verify_user_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על 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 לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_retail_authentication:send_otp.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הרכיב המוגדר מראש וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.