הרכיב המוגדר מראש של הפתיח מאחזר את מספר הטלפון של המתקשר (ANI), אם הוא זמין. אם המערכת מאחזרת את מספר הטלפון, הרכיב מבצע אימות קל באמצעות מספר הטלפון, ומאמת אותו מול מספרי הטלפון הרשומים. הנציג מברך את המשתמש בהודעה מותאמת אישית על סמך פרטי החשבון שלו.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב מניח שמספרי הטלפון מנוהלים במערכת לניהול קשרי לקוחות (CRM) או בשירות אחר.
- הרכיב הזה לא מאמת לקוחות קיימים שמשתמשים במספר טלפון חלופי כדי ליצור קשר.
דוגמאות לדו-שיח
הדיאלוגים לדוגמה הבאים מדגימים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם ממחישים מה קורה כשהטלפוניה מפעילה את הרכיב, שמפעיל את כוונת ברירת המחדל של הודעת הפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
משתמש מאומת
המשתמש מזוהה על סמך המספר שממנו הוא מתקשר, ומקבל הודעת ברכה מותאמת אישית.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| שלום [Caller First Name]. תודה שפנית אל [שם החברה], אנחנו מחויבים לבריאות הפיננסית שלך. איך נוכל לעזור לך היום? |
משתמש לא מזוהה
המערכת לא מזהה את מספר המתקשר, ומשמיעה למשתמש את הודעת הפתיחה הרגילה.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| תודה שפנית אל [שם החברה], אנחנו מחויבים לבריאות הפיננסית שלך. איך נוכל לעזור לך היום? |
מוסכמות למתן שמות
הרכיב הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | הודעת פתיחה |
| פרמטר | [param_name] | ani_auth |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
פרמטרים של קלט
פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים האלה כדי לקבוע את ההתנהגות של הרכיב. אתם צריכים להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.
הרכיב הזה מקבל את הפרמטרים הבאים:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.company_name | שומר את שם החברה כדי להשתמש בו באופן דינמי בהנחיה של הודעת הפתיחה. | מחרוזת |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שהרכיב אוסף.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| ani_auth | מתעד את התוצאה של אימות מבוסס-ANI. ערך ברירת המחדל הוא false. |
בוליאני |
| auth_level | מציין את רמת האימות של המתקשר. ערך ברירת המחדל הוא null. -1 מציין שהמשתמש לא אומת על ידי ה-ANI שלו. 0 מציין שאימות ה-ANI הצליח. |
מספר שלם |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhook הגמיש שסופק עם השירותים החיצוניים, כמו שמוסבר במאמר הגדרת webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
קבלת פרטי החשבון
הרכיב משתמש ב-webhook של prebuilt_components_greeting:get_account_details כדי לזהות את המתקשר באמצעות ה-ANI שלו. אם מספר הטלפון של המתקשר קיים בשירות החיצוני שהוגדר, הרכיב מאחזר את המידע הרלוונטי כדי להתאים אישית את החוויה, כולל שם המתקשר וכתובת האימייל שלו.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| phone_number | מספר הטלפון של המתקשר (ANI). | מספר שלם |
פרמטרים של תגובה מה-API
הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| user_first_name | השם הפרטי של המשתמש, שמשמש להצגת ברכה מותאמת אישית. | מחרוזת |
| user_email | כתובת האימייל של המשתמש. | מחרוזת |
כדי להגדיר את ה-webhook של Get Account Details לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_greeting:get_account_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את הגדרת התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הרכיב שהוגדר מראש וה-webhook שלו מוגדרים עכשיו ומוכנים לבדיקה.