הרכיב המוגדר מראש לפתיחת חשבון מאפשר למשתמשים חדשים וקיימים לפתוח חשבון חדש או לבדוק את הסטטוס של בקשות קיימות. הרכיב הזה משתמש ברכיבים המוכנים מראש איסוף תאריך לידה, איסוף שם ואיסוף מספר טלפון כדי לאסוף פרטי משתמשים לצורך רישום חשבון חדש.
סוגי חשבונות
כברירת מחדל, הרכיב הזה תומך בסוגי החשבונות הבאים:
- חשבונות חיסכון
- חשבונות עו"ש, שנקראים גם חשבונות עובר ושב
- חשבונות Demat
- חשבונות שכר
אפשר להוסיף או להסיר סוגי חשבונות נתמכים על ידי שינוי הישות המותאמת אישית prebuilt_components_open_account_account_type.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
משתמש חדש
הנציג אוסף את מספר הטלפון של המשתמש ומזהה שהמשתמש לא רשום לחשבון. הנציג אוסף פרטים כמו השם המלא ותאריך הלידה של המשתמש, ומפיק בקשה שנשלחת למספר הטלפון שהמשתמש סיפק.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו צריכים את מספר הטלפון למטרות אימות. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש Telephone number collection | |
| מעולה, סיימנו לאסוף את מספר הטלפון. אנחנו שמחים שברצונך לפתוח אצלנו חשבון. |
|
| הנציג אוסף את השם המלא של המשתמש באמצעות הרכיב המוגדר מראש איסוף שמות | |
| תודה, משה כהן. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש איסוף תאריך לידה | |
| מעולה, קיבלנו את תאריך הלידה שלך. איזה סוג חשבון ברצונך לפתוח? אפשר לומר "חיסכון", "עו"ש", "משכורת" או "חשבון דמאט". |
|
| החשבון הנוכחי | |
| רק כדי לוודא, רצית לפתוח חשבון עו"ש חדש, נכון? | |
| כן | |
| תודה על המידע ששלחת. אנחנו יוצרים את האפליקציה שלך. מזהה האפליקציה שלך הוא 81037. כדי להשלים את הבקשה, צריך ללחוץ על הקישור שנשלח למספר הטלפון הנייד הרשום. |
משתמש קיים
הנציג מזהה שהמשתמש כבר אומת בעבר ומאשר את סוג החשבון שהמשתמש רוצה לפתוח. הנציג יוצר בקשה למשתמש ושולח הוראות למספר הטלפון הרשום של המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו שמחים שברצונך לפתוח אצלנו חשבון חדש. איזה סוג חשבון ברצונך לפתוח? אפשר לומר "חיסכון", "עו"ש", "משכורת" או "חשבון ניירות ערך". |
|
| חשבון חיסכון, בבקשה | |
| רק כדי לוודא, רצית לפתוח חשבון חיסכון חדש, נכון? | |
| כן, זה נכון | |
| תודה על המידע ששלחת. אנחנו יוצרים את האפליקציה שלך. תודה על הסבלנות. מזהה האפליקציה שלך הוא 21430. כדי להשלים את הבקשה, צריך ללחוץ על הקישור שנשלח למספר הטלפון הנייד הרשום. |
אפליקציה קיימת
הנציג מזהה שהמשתמש פתח בעבר אפליקציה אחת ומציג למשתמש את הסטטוס הנוכחי. המשתמש מסרב לפתוח בקשה נוספת לחשבון חדש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו צריכים את מספר הטלפון למטרות אימות. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש Telephone number collection | |
| מעולה, סיימנו לאסוף את מספר הטלפון. הבקשה שלך עם המזהה 12234 לפתיחת חשבון חיסכון נמצאת בטיפול. רוצה לפתוח חשבון אחר? |
|
| לא | |
| בסדר, תודה שהתקשרת אלינו. |
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | פתיחת החשבון |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע איך הרכיב צריך להתנהג. צריך להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.
הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.auth_level | (אופציונלי) מציין את רמת האימות של המתקשר. | מספר שלם |
| $session.params.phone_number | (אופציונלי) מספר הטלפון הרשום של הלקוח שמשמש לאימות. | מחרוזת |
| $session.params.min_age_limit | מציינת את הגיל המינימלי המותר למשתמשים שפותחים חשבון חדש. ערך ברירת המחדל הוא 18. |
מספר שלם |
| $session.params.max_age_limit | מציינת את הגיל המקסימלי המותר למשתמשים שפותחים חשבון חדש. ערך ברירת המחדל הוא 100. |
מספר שלם |
| $flow.max_dob_retry_count | מציינת את מספר הניסיונות המותרים לאיסוף תאריך לידה חוקי. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_account_type | מציין את מספר הניסיונות החוזרים המותרים כשמנסים לאסוף את סוג החשבון שהמשתמש רוצה לפתוח. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_another_account | מציינת את מספר הניסיונות החוזרים המותרים כשהמשתמש רוצה לשנות את סוג החשבון שהוא בחר. ערך ברירת המחדל הוא 2. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages, לוחצים על Start Page.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המוכן מראש הזה מספק ערכים לפרמטרים הבאים של פלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| 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)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות טלפוני
הרכיב משתמש ב-webhook של prebuilt_components_open_account:telephone_verification כדי לקבל מידע על חשבונות רשומים ועל בקשות קודמות שמשויכות למספר הטלפון של המשתמש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| account_count | מספר החשבונות שמשויכים למספר הטלפון הרשום. החשבונות האלה כוללים חשבונות עצמיים וחשבונות שלמשתמש יש ייפוי כוח עבורם. אם אין חשבונות שמשויכים למספר הטלפון שצוין, הערך הזה הוא null. |
מספר שלם |
| user_first_name | השם הפרטי של המשתמש הרשום. אם מספר הטלפון לא משויך לחשבון רשום, הערך הזה הוא null. |
מחרוזת |
| user_last_name | שם המשפחה של המשתמש הרשום. אם מספר הטלפון לא משויך לחשבון רשום, הערך הזה הוא null. |
מחרוזת |
| user_dob | תאריך הלידה של המשתמש הרשום בפורמט YYYY-MM-DD. אם מספר הטלפון לא משויך לחשבון רשום, הערך הזה הוא null. |
מחרוזת |
| application_count | מספר הבקשות שמשויכות למספר הטלפון הרשום. אם אין בקשות שמשויכות למספר הטלפון שצוין, הערך הזה הוא null. |
מספר שלם |
| application_id | רשימה שמכילה את מזהה האפליקציה של כל אפליקציה שמשויכת למספר הטלפון שצוין, לדוגמה ["00000", "11111", "22222"]. כל רכיב ברשימה הזו מייצג את אותה אפליקציה כמו הרכיב עם אותו אינדקס ב-account_type וב-application_status. אם אין בקשות שמשויכות למספר הטלפון שצוין, הערך הזה הוא null. |
רשימה (מחרוזת) |
| account_type | רשימה שמכילה את סוג החשבון של כל אפליקציה שמשויכת למספר הטלפון שצוין, לדוגמה ["savings", "checking", "demat"]. כל רכיב ברשימה הזו מייצג את אותה אפליקציה כמו הרכיב עם אותו אינדקס ב-application_id וב-application_status. אם אין בקשות שמשויכות למספר הטלפון שצוין, הערך הזה הוא null. |
רשימה (מחרוזת) |
| application_status | רשימה שמכילה את הסטטוס של כל אפליקציה שמשויכת למספר הטלפון שצוין, לדוגמה ["in progress", "on hold", "completed"]. כל רכיב ברשימה הזו מייצג את אותה אפליקציה כמו הרכיב עם אותו אינדקס ב-application_id וב-account_type. אם אין בקשות שמשויכות למספר הטלפון שצוין, הערך הזה הוא null. |
רשימה (מחרוזת) |
כדי להגדיר את ה-webhook לאימות טלפוני ברכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_open_account:telephone_verification.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
יצירת אפליקציה
הרכיב משתמש ב-webhook prebuilt_components_open_account:generate_application כדי ליצור בקשה לחשבון חדש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| user_first_name | השם הפרטי של המשתמש. | מחרוזת |
| user_last_name | שם המשפחה של המשתמש. | מחרוזת |
| user_dob | תאריך הלידה של המשתמש בפורמט "YYYY-MM-DD". | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| application_id | מזהה הבקשה שנוצר לבקשה לפתיחת חשבון חדש. | מחרוזת |
כדי להגדיר את ה-webhook של אפליקציית Generate לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_open_account:generate_application.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.