רכיב מוכן מראש של סטטוס הזמנה

הרכיב המובנה מראש'סטטוס ההזמנה' בודק את רמת האימות של הלקוח, ואז מספק ללקוח מאומת מידע על ההזמנות האחרונות או הקודמות של המשתמש. הרכיב הזה משתמש ברכיב המובנה Retail authentication כדי לאמת משתמשים. הרכיב משתמש גם בגנרטורים לסיכום אחרי השיחה.

מגבלות

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

• הרכיב הזה לא מצפין נתונים.

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

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

הזמנה אחרונה

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

קלט של משתמשים	התשובה של הסוכן
	הסוכן מאמת את המשתמש באמצעות רכיב מוכן מראש של אימות לקמעונאים
	אוקיי, John. האם התקשרת בנוגע להזמנה האחרונה שלך על שם John Doe שכוללת מנורה, חולצה ועוד 10 פריטים שבוצעה בתאריך 2023-11-10 בשעה 18:00?
כן
	ההזמנה שלך כוללת 2 משלוחים, שיגיעו עד 15 בינואר 2024. רוצה לקבל מידע נוסף על המשלוחים האלה?
כן
	משלוח 1 עם ג'ינס, חגורה ו-2 פריטים נוספים נמצא בתהליך משלוח ויגיע עד 2024-01-12. משלוח 2 עם מנורה, חולצה ו-6 פריטים נוספים נמסר ב-2023-11-12. האם תרצה לקבל הודעת SMS עם פרטים נוספים על הפריטים שלך?
כן
	שלחנו לך הודעת SMS עם קישור למעקב אחרי סטטוס כל המשלוחים שלך. תודה שהתקשרת אלינו.

הזמנות כפולות

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

קלט של משתמשים	התשובה של הסוכן
	אוקיי, צהובה מוזהבת. האם ההתקשרות שלך היא בנוגע להזמנה האחרונה של Amber Doe שכוללת מנורה, חולצה ועוד 2 פריטים, שבוצעה בתאריך 2023-11-10 בשעה 18:00?
לא
	אפשר לקבל את 5 הספרות האחרונות של מספר ההזמנה שברצונך לעקוב אחריה?
12355
	5 הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12355. האם זה נכון?
כן, זה נכון
	מעולה, סיימנו לאסוף את מזהה ההזמנה.
	לפי הרשומות שלנו, מצאנו 2 הזמנות שמסתיימות באותן 5 ספרות: 12355. איזו הזמנה אתה מחפש? הזמנה מספר 1 שבוצעה בתאריך 2023-11-10 בשעה 18:00 או הזמנה מספר 2 שבוצעה בתאריך 2023-11-09 בשעה 20:00? כדי לבחור בהזמנה מספר 1, אומרים 1. כדי לבחור בהזמנה מספר 2, אומרים 2. אחרת, אומרים 'לא'.
הזמנה אחת
	ההזמנה שלך כוללת 2 משלוחים, שיגיעו עד 15 בינואר 2024. רוצה לקבל מידע נוסף על המשלוחים האלה?
כן
	משלוח 1 עם ג'ינס נמצא בתהליך משלוח ויגיע עד 2024-01-15. משלוח 2 עם מנורה, חולצה ופריט נוסף בוטל. רוצה לקבל הודעת SMS עם פרטים נוספים על הפריטים?
לא, זה הכול
	תודה שהתקשרת אלינו.

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

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

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	סטטוס ההזמנה
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_order_status:get_order_details

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

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

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

שם הפרמטר	תיאור	פורמט קלט
$session.params.phone_number	(אופציונלי) מספר הטלפון המקומי של המשתמש, ללא קידומת המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.all_recent_order_id	(אופציונלי) הפרמטר הזה מציג רשימה של מזהי הזמנות שמשויכים למשתמש המאומת, ממוינים לפי תאריך ביצוע ההזמנה בסדר יורד. האלמנט הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null.	רשימה (מחרוזת)
$session.params.email	(אופציונלי) כתובת האימייל שרשומה בחשבון.	מחרוזת
$session.params.user_first_name	(אופציונלי) השם הפרטי של המשתמש, שמשמש לברכה ולאישור הבעלות על החשבון.	מחרוזת
$flow.max_shipment	מציין את מספר המשלוחים שמוצגים למשתמש בכל פעם. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.tracking_status_delivered	מציין את הערך שמוחזר על ידי ה-webhook ומציין את סטטוס ההזמנה שנמסרה. ערך ברירת המחדל הוא "delivered".	מחרוזת
$flow.tracking_status_cancelled	מציין את הערך שמוחזר על ידי ה-webhook ומציין את סטטוס ההזמנה שבוטלה. ערך ברירת המחדל הוא "cancelled".	מחרוזת
$flow.tracking_status_returned	מציין את הערך שמוחזר על ידי ה-webhook ומציין את סטטוס ההזמנה שהוחזרה. ערך ברירת המחדל הוא "returned".	מחרוזת
$flow.tracking_status_partially_returned	מציין את הערך שמוחזר על ידי ה-webhook ומציין את סטטוס ההזמנה שהוחזר חלקית. ערך ברירת המחדל הוא "partially returned".	מחרוזת
$flow.max_retry_alternate_profile	מציינת את מספר הניסיונות החוזרים שמותרים כשמבקשים סטטוס הזמנה ממספר טלפון לא רשום או מפרופיל חלופי. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_order_number	מציין את מספר הניסיונות החוזרים שמותרים כשמספקים מספר הזמנה. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_another_order_id	ההגדרה הזאת קובעת את מספר הניסיונות החוזרים שמותרים אחרי שמזינים מספר הזמנה לא תקין. ערך ברירת המחדל הוא 3.	מספר שלם

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

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

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

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

שם הפרמטר	תיאור	פורמט הפלט
phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
all_recent_order_id	הפרמטר הזה מפרט את מזהי ההזמנות שמשויכים למשתמש המאומת, ממוינים לפי תאריך ביצוע ההזמנה בסדר יורד. האלמנט הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null.	רשימה (מחרוזת)
אימייל	כתובת האימייל שרשומה בחשבון.	מחרוזת
user_first_name	השם הפרטי של המשתמש, שמשמש לברכה ולאישור הבעלות על החשבון.	מחרוזת
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.	מחרוזת

הגדרה בסיסית

כדי להגדיר את הרכיב המובנה הזה:

1. מייבאים את הרכיב שנוצר מראש.
2. מגדירים את ה-webhooks הגמישים שסופקו עם הגדרה שמתארת את השירותים החיצוניים. אפשר לעיין במאמר בנושא הגדרת webhook.

הגדרת webhook

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

אימות

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

קבלת פרטי ההזמנה

רכיב prebuilt_components_order_status:get_order_details webhook משמש לאחזור פרטי הזמנה עבור הזמנה ספציפית.

פרמטרים של בקשות API

הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט קלט
$flow.order_id	מזהה ההזמנה שאותה רוצים לאחזר.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
order_date	התאריך שבו בוצעה ההזמנה, בפורמט YYYY-MM-DD.	מחרוזת
order_time	השעה שבה בוצעה ההזמנה, בפורמט HH:MM.	מחרוזת
order_status	מציין את הסטטוס של ההזמנה. ערכים לדוגמה: "pending", ‏ "processing", ‏ "in-transit", ‏ "on-hold", ‏ "cancelled", ‏ "delivered", ‏ "returned", ‏ "partially returned".	מחרוזת
order_product_name	רשימה של שמות המוצרים בהזמנה.	רשימה (מחרוזת)
order_product_quantity	המספר הכולל של המוצרים שהוזמנו לכל מוצר בהזמנה.	מספר שלם
order_product_count	מספר המוצרים הייחודיים בהזמנה.	מספר שלם
order_status_notification	מציין אם ההתראות מופעלות להזמנה הזו.	בוליאני
return_eligibility_date	רשימת התאריכים שעד אליהם כל מוצר בהזמנה כשיר להחזרה, בפורמט YYYY-MM-DD.	רשימה (מחרוזת)
order_customer_billing_name	השם הפרטי של הלקוח שמופיע בפרטי החיוב של ההזמנה.	מחרוזת
order_latest_delivery_date	תאריך המסירה האחרון מבין כל תאריכי המסירה המשוערים של המשלוחים בהזמנה, בפורמט YYYY-MM-DD.	מחרוזת
order_shipment_multiple	מציין אם ההזמנה כוללת כמה משלוחים.	בוליאני
order_shipment_count	מספר המשלוחים בהזמנה.	מספר שלם
order_shipment_product_count	המספר הכולל של מוצרים בכל משלוח בהזמנה.	רשימה (מספר שלם)
order_shipment_product_name	רשימה של שמות המוצרים בכל משלוח בהזמנה.	רשימה (מחרוזת)
order_estimated_delivery_date	רשימה של מועדי מסירה משוערים לכל משלוח בהזמנה, בפורמט YYYY-MM-DD.	רשימה (מחרוזת)
order_shipment_status	רשימה שמציינת את הסטטוס של כל משלוח בהזמנה. ערכים לדוגמה: "pending", ‏ "processing", ‏ "in-transit", ‏ "on-hold", ‏ "cancelled", ‏ "delivered", ‏ "returned", ‏ "partially returned".	רשימה (מחרוזת)

כדי להגדיר את ה-webhook של Get order details (קבלת פרטי הזמנה) לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים את ה-webhook ‏prebuilt_components_order_status:get_order_details.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
9. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

קבלת הזמנות כפולות

רכיב ה-prebuilt_components_retail_services:get_duplicate_order webhook משמש לאחזור מידע מפורט כדי להבחין בין הזמנות כשכמה מספרי הזמנות מסתיימים באותן חמש ספרות.

פרמטרים של בקשות API

הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט קלט
$flow.duplicate_order_id	רשימה שמכילה את חמש הספרות האחרונות של מספרי ההזמנות שמשותפות בין הזמנה אחת או יותר של המשתמש.	רשימה (מחרוזת)

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
all_order_date	רשימה של תאריכי הזמנות כפולות עם חמש הספרות האחרונות שצוינו בפורמט YYYY-MM-DD. כל רכיב במערך הזה תואם לרכיב זהה במערך all_order_time.	בוליאני
all_order_time	רשימה של זמני הזמנות כפולות עם חמש הספרות האחרונות שצוינו בפורמט HH:MM. כל רכיב במערך הזה תואם לרכיב זהה במערך all_order_date.	מספר

כדי להגדיר את ה-webhook של Get duplicate orders (קבלת הזמנות כפולות) לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים את ה-webhook ‏prebuilt_components_retail_services:get_duplicate_order.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
9. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

שלח SMS

רכיב ה-webhook‏ prebuilt_components_order_status:send_sms משמש לשליחת פרטי ההזמנה למספר הטלפון שצוין באמצעות SMS.

פרמטרים של בקשות API

הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט קלט
$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$flow.order_id	מזהה ההזמנה שאליה רוצים לשלוח את פרטי ההזמנה.	מחרוזת

כדי להגדיר את ה-webhook לשליחת SMS עבור הרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים ב-webhook של prebuilt_components_order_status:send_sms.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
9. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

הפעלת התראות

רכיב ה-webhook‏ prebuilt_components_order_status:enable_notification משמש להפעלת התראות למספר הטלפון הרשום של המשתמש.

פרמטרים של בקשות API

הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט קלט
$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$flow.order_notification	מציין אם ההתראות צריכות להיות מופעלות עבור המשתמש.	בוליאני

כדי להגדיר את ה-webhook של הפעלת ההתראות לרכיב הזה, מרחיבים את ההוראות.

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים ב-webhook‏ prebuilt_components_order_status:enable_notification.
7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
9. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

הושלמה

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