הרכיב המובנה open account מאפשר למשתמשים חדשים וקיימים לפתוח חשבון חדש או לבדוק את הסטטוס של בקשות קיימות. הרכיב הזה משתמש ברכיבים מוכנים מראש של איסוף תאריך לידה, איסוף שם ואיסוף מספר טלפון כדי לאסוף פרטי משתמש לצורך רישום חשבון חדש.
סוגי חשבונות
כברירת מחדל, הרכיב הזה תומך בסוגי החשבונות הבאים:
- חשבונות חיסכון
- חשבונות עובר ושב, שנקראים גם חשבונות שוטפים
- חשבונות Demat
- חשבונות שכר
אפשר להוסיף או להסיר סוגי חשבונות נתמכים על ידי שינוי של הישות המותאמת אישית prebuilt_components_open_account_account_type.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, לרכיב המוכן מראש הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הסוכן בתחילת השיחה.
משתמש חדש
הסוכן אוסף את מספר הטלפון של המשתמש ומזהה שהמשתמש לא רשום לחשבון. לאחר מכן, הסוכן אוסף פרטים, כולל השם המלא ותאריך הלידה של המשתמש, ויוצר בקשה שנשלחת למספר הטלפון שצוין על ידי המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| עליך לספק לנו את מספר הטלפון למטרות אימות. | |
| הסוכן אוסף את מספר הטלפון של המשתמש באמצעות רכיב מוכן מראש של Telephone number collection | |
| מצוין, סיימנו לאסוף את מספר הטלפון. אנחנו שמחים שברצונך לפתוח אצלנו חשבון. |
|
| הנציג אוסף את השם המלא של המשתמש באמצעות הרכיב המובנה Name 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 (תהליכי עבודה).
- בקטע דפים, לוחצים על דף הפתיחה.
- לוחצים על המסלול 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
כדי להשתמש ברכיב הזה, תצטרכו להגדיר את הוויבהוקים הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים שלכם.
אימות טלפוני
רכיב ה-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.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.