רכיב מוכן מראש לאיסוף כתובות

הרכיב המובנה לאיסוף כתובות אוסף כתובת מלקוח ומאמת אותה באמצעות Google Address Validation API.

מגבלות

בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:

תכונות נוספות

הרכיב המוכן מראש הזה כולל את התכונות הנוספות הבאות:

דוגמאות לדו-שיח

בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.

אימות כתובת מלאה

המשתמש מספק כתובת מלאה, ורכיב איסוף הכתובות מאמת אותה.

הטקסט של המשתמש התשובה של הסוכן
כדי להתחיל, מה הכתובת המלאה שלך?
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא.
כן
מעולה, הכתובת נשמרה.

כתובת תקינה חלקית עם רכיבים משוערים

  1. המשתמש מספק כתובת חלקית.
  2. הסוכן מנחש את החלק החסר ומאמת אותו אחרי שהמשתמש מאשר.
הטקסט של המשתמש התשובה של הסוכן
כדי להתחיל, מה הכתובת המלאה שלך?
‎1600 Amphitheatre Parkway
ניחשתי חלק מהכתובת: העיר היא Mountain View, המיקוד הוא 94043, האזור המנהלי הוא CA, המדינה היא ארה"ב.

אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא.
כן
מעולה, הכתובת נשמרה.

כתובת תקינה חלקית עם רכיבים שהמשתמש סיפק

  1. המשתמש מספק כתובת חלקית.
  2. המשתמש דוחה את החלק המשוער ומזין קלט משלו.
  3. הנציג מקבל את הקלט מהמשתמש ומבקש שוב אישור.
  4. המשתמש מאשר את הכתובת הסופית.
הטקסט של המשתמש התשובה של הסוכן
כדי להתחיל, מה הכתובת המלאה שלך?
‎1600 Amphitheatre Parkway
ניחשתי חלק מהכתובת: העיר היא Mountain View, המיקוד הוא 94043, האזור המנהלי הוא CA, המדינה היא ארה"ב.

אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא.
לא
בסדר. איזה חלק בכתובת צריך לשנות?
מיקוד
מה המיקוד?
94044
סיימתי עם העדכון הזה. יש עוד משהו שצריך לשנות? צריך לומר כן או לא.
לא
אחרי האימות, החלפתי את המיקוד ל-94043.

אספתי את הכתובת הסופית: מספר הרחוב הוא 1600, הרחוב הוא Amphitheatre Parkway, העיר היא Mountain View, האזור המנהלי הוא CA, המיקוד הוא 94043, המדינה היא ארה"ב. זה נכון? צריך לומר כן או לא.
כן
מעולה, הכתובת נשמרה.

קלט לא מזוהה

הרכיב יוצא מהתהליך אחרי שהמשתמש מספק קלט לא מזוהה שלוש פעמים.

הטקסט של המשתמש התשובה של הסוכן
כדי להתחיל, מה הכתובת המלאה שלך?
זה בסדר
סליחה, לא הבנתי. כדי להתחיל, מה הכתובת המלאה שלך?
נחמד
הממ, עדיין לא הצלחתי להבין. כדי להתחיל, מה הכתובת המלאה שלך?
נהניתי מאוד
סליחה, לא הבנתי את התשובה שלך.

כתובת לא נתמכת

הרכיב יוצא מהתהליך אחרי שהמשתמש מספק כתובת שלא נתמכת על ידי Address Validation API.

הטקסט של המשתמש התשובה של הסוכן
כדי להתחיל, מה הכתובת המלאה שלך?
הודו
מצטער, אין לי אפשרות לאמת כתובות באזור הזה.

אימות כתובת

בסקירה הכללית על Address Validation API מוסבר איך הרכיב לאיסוף כתובות מאמת את הכתובות.

רכיב איסוף הכתובות מתעד את הקלט של המשתמש באמצעות הישות המערכתית ‎@sys.address ושולח את הכתובת המתועדת אל Address Validation API כדי לחלץ רכיבי כתובת לעיבוד נוסף.

‫Address Validation API מחזיר את רכיבי הכתובת הבאים, שבהם אתם יכולים להשתמש כדי לאסוף ולאמת כתובת מלאה:

  • administrative_area_level_1
  • archipelago
  • country
  • locality
  • postal_code
  • route
  • street_number

אתם יכולים לנסות את הדגמת Address Validation של Google עם כל כתובת מאזור נתמך.

מוסכמות למתן שמות

הרכיב הזה משתמש במוסכמות הבאות למתן שמות:

תכונה פורמט דוגמה
Flow [שם הרכיב] איסוף כתובות
כוונה ספציפית לרכיב prebuilt_components_[component_name]_[intent_name] prebuilt_components_address_collection_locality
פרמטר [param_name] user_provided_address
תגובה לפעולה מאתר אחר (webhook) prebuilt_components_[component_name]:[webhook_action] prebuilt_components_address_collection:address_validation

פרמטרים של קלט

פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים האלה כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר פרמטרים ברמת התהליך בדף הפתיחה של הרכיב. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך שיחה או בדף ההתחלה של הרכיב הזה.

המשתמש יכול להגדיר אילו רכיבי כתובת נדרשים על ידי הרכיב הזה באמצעות שינוי של הפרמטרים שמוגדרים מראש בדף ההתחלה של התהליך.

הרכיב הזה מקבל את הפרמטרים הבאים:

שם הפרמטר תיאור פורמט הקלט
‎$flow.zip_code אם רכיב הכתובת של המיקוד נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
‎$flow.city אם רכיב הכתובת של העיר נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
$flow.admin_area אם רכיב הכתובת של האזור המנהלי נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
‎$flow.street_number אם רכיב הכתובת של מספר הבית נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
‎$flow.route אם רכיב הכתובת של המסלול נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
$flow.country אם רכיב הכתובת של המדינה נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
$flow.island אם רכיב הכתובת של האי נדרש, מגדירים אותו כ-true. אחרת, מגדירים אותו כ-false. בוליאני
$flow.retry_num הגדרת המספר המקסימלי של ניסיונות חוזרים לקריאות לפונקציות Webhook של Maps Address Validation API. מספר שלם

כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה יצירה.
  5. לוחצים על הרכיב המיובא בקטע Flows.
  6. בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
  7. לוחצים על המסלול true בדף הפתיחה.
  8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
  9. לוחצים על Save.

פרמטרים של פלט

פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב.

הרכיב המוכן מראש מספק את פרמטרי הפלט הבאים:

שם הפרמטר תיאור פורמט הפלט
address_collection_address הפרמטר הזה מחזיר את אובייקט הכתובת אם הרכיב תיעד כתובת
{
"admin-area": string,
"city": string,
"country": string,
"island": string,
"route": string,
"zip-code": string,
"street-number": string
}
address_collection_status הפרמטר הזה מחזיר את הסטטוס של הכתובת שנאספה. הערך שמוחזר הוא אחד מהבאים:

VALID_ADDRESS: הכתובת נאספה ואומתה על ידי Address Validation API.

INVALID_ADDRESS: הכתובת אושרה על ידי המשתמש, אבל רכיב אחד או יותר לא אומתו או סומנו כ-UNCONFIRMED_BUT_PLAUSIBLE על ידי Address Validation API.

MAPS_API_ERROR: הכתובת לא נאספה בגלל שגיאה ב-Address Validation API.

COUNTRY_NOT_SUPPORTED: הכתובת לא נאספה כי Address Validation API לא תומך באזור הזה.

NO_USER_CONFIRMATION: הכתובת לא אושרה כי המשתמש לא אישר כתובת.
string

הגדרה בסיסית

כדי להגדיר את הרכיב המוכן מראש:

  1. מייבאים את הרכיב המוגדר מראש.
  2. מפעילים את Address Validation API.
  3. מגדירים את ה-webhook הגמיש שסופק עם מפתח ה-Maps API. מידע נוסף זמין בקטע הגדרת Webhook.

הגדרת תגובה לפעולה מאתר אחר (webhook)

כדי לאמת כתובות באמצעות Address Validation API, צריך להגדיר את ה-webhook הגמיש שסופק עם פרטי הכניסה הנכונים.

‫webhook לאימות כתובת

ה-webhook הזה מבצע את הפעולות הבאות:

  1. מעבד את הפרמטרים שנקלטו ב-Dialogflow CX, יוצר את הבקשה ומאמת את הכתובת באמצעות Address Validation API.
  2. חילוץ רכיבי כתובת מאושרים, לא מאושרים, חסרים ומשוערים מהתגובה של Address Validation API.

כדי להגדיר את ה-webhook לרכיב הזה, צריך לעדכן את ההגדרות של ה-webhook עם מפתח ה-API הנכון של Maps API.

כדי לאחזר את מפתח ה-API, נכנסים אל Google Cloud Console > APIs & Services > Credentials, בוחרים את מפתח ה-API של מפות Google ומעתיקים את השדה של מפתח ה-API.

כדי להגדיר את ה-webhook:

  1. נכנסים למסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב- Google Cloud .
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook של prebuilt_components_address_collection:address_validation.
  7. בשדה Webhook URL ב-Dialogflow CX, מחליפים את כתובת ה-URL בכתובת שכוללת את מפתח ה-Maps API: https://addressvalidation.googleapis.com/v1:validateAddress?key=<var>MAPS_API_KEY</var>.
  8. בהגדרות Authentication, מגדירים את שם המשתמש בתור key ומגדירים את הסיסמה למפתח Maps API.
  9. לוחצים על Save.

הושלמה

הרכיב המוגדר מראש וה-webhook שלו מוגדרים עכשיו ומוכנים לבדיקה.