הרכיב המוגדר מראש הזה מתעד ומאמת את קוד המדינה ומספר הטלפון.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- מספרי טלפון עם יותר מ-16 ספרות לא מתקבלים.
הגדרות מומלצות לסוכן
מפעילים את DTMF כדי לאפשר למשתמשים להזין ערכים מספריים באמצעות לוח המקשים של הטלפון.
תכונות נוספות
הרכיב המוגדר מראש הזה מספק את הפונקציות הנוספות הבאות:
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
מספר טלפון תקין בשני שלבים
משתמש הקצה מספק קוד מדינה ואז מספר טלפון. הנציג מאמת ומקבל את הפרטים.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם או הקוד של המדינה שלך? | |
| +1 | |
| הבנתי, קוד המדינה שלך הוא פלוס 1. מה מספר הטלפון שלך? | |
| 6502530000 | |
| הבנתי. המספר שציינת הוא +1 6502530000, נכון? | |
| כן, זה נכון | |
| מעולה, סיימתי לאסוף את מספר הטלפון. |
מספר טלפון תקין בפנייה אחת
משתמש הקצה מספק את קוד המדינה ואת מספר הטלפון בו-זמנית, והנציג מאמת ומקבל אותם.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם או הקוד של המדינה שלך? | |
| +1 6502530000 | |
| הבנתי. המספר שציינת הוא +1 6502530000, נכון? | |
| כן, זה נכון | |
| מעולה, סיימתי לאסוף את מספר הטלפון. |
מספר טלפון לא חוקי
משתמש הקצה מספק קוד מדינה ומספר טלפון בפנייה אחת. הנציג בודק ומוצא שמספר הטלפון שסופק הוא באורך תקין (עד 16 ספרות), אבל הוא לא מספר טלפון תקין. לאחר מכן, הנציג מבקש שוב ממשתמש הקצה למסור את מספר הטלפון.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם או הקוד של המדינה שלך? | |
| +1 6502530001 | |
| מצטערים, מספר הטלפון הזה לא מזוהה. אספתי את קוד המדינה כ-+1. צריך להזין מספר טלפון תקין. | |
| 6502530000 | |
| הבנתי. המספר שציינת הוא +1 6502530000, נכון? | |
| כן, זה נכון | |
| מעולה, סיימתי לאסוף את מספר הטלפון. |
קוד מדינה ומספר טלפון לא תקינים
משתמש הקצה מספק קידומת חיוג של מדינה ומספר טלפון בפנייה אחת. הנציג בודק ומגלה שקידומת החיוג של המדינה ומספר הטלפון שסופקו לא תקינים. לאחר מכן הנציג מבקש שוב ממשתמש הקצה לספק את קידומת המדינה ומספר הטלפון.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם או הקוד של המדינה שלך? | |
| +0080000000000 | |
| נראה שקוד המדינה או מספר הטלפון שציינת לא תקינים. בואו נתחיל מחדש. צריך לומר את שם המדינה או את קוד המדינה. | |
| 1 | |
| הבנתי, קוד המדינה שלך הוא פלוס 1 . מה מספר הטלפון שלך? | |
| 6502530000 | |
| הבנתי. המספר שציינת הוא +1 6502530000, נכון? | |
| כן, זה נכון | |
| מעולה, סיימתי לאסוף את מספר הטלפון. |
קלט לא מזוהה
הרכיב יוצא מהתהליך אחרי שמשתמש הקצה מספק קלט לא מזוהה שלוש פעמים.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| מה השם או הקוד של המדינה שלך? | |
| זה בסדר | |
| סליחה, לא הבנתי. אפשר לומר או להזין שוב את קוד המדינה? | |
| נחמד | |
| הממ, עדיין לא הצלחתי להבין. חשוב לוודא שאתם אומרים את קוד המדינה. אם אני לא שומע אותך טוב, אפשר גם להשתמש בלוח המקשים כדי להזין את קוד המדינה. | |
| טוב | |
| סליחה, לא הבנתי את התשובה שלך. |
אימות מספר טלפון
הרכיב המוגדר מראש למספר טלפון משתמש בפונקציית המערכת IS_PHONE_NUMBER כדי לאמת שמספר הטלפון תואם לתבנית תקינה.
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | איסוף מספרי טלפון |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_telephone_number_collection_incorrect_country_code |
| פרמטר | [param_name] | telephone_number |
| סוג ישות | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_telephone_no_country_code |
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המוכן מראש הזה מספק ערכים לפרמטרים הבאים של פלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| telephone_number_collection_telephone_number | הפרמטר הזה מחזיר את מספר הטלפון שנקלט על ידי הרכיב | מחרוזת |
| telephone_number_collection_country_code | הפרמטר הזה מחזיר את קוד המדינה שמתועד על ידי הרכיב | מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
הושלמה
עכשיו הנציג אמור להיות מוגדר ומוכן לבדיקה.