הרכיב המוגדר מראש של סטטוס ההזמנה בודק את רמת האימות של הלקוח, ואז מספק ללקוח המאומת מידע על ההזמנות האחרונות או הקודמות שלו. הרכיב הזה משתמש ברכיב המוגדר מראש אימות קמעונאי כדי לאמת משתמשים. הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה אחרי שהיא מסתיימת.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
הזמנה אחרונה
משתמש קצה מתקשר ממספר לא רשום. הנציג מאמת את המשתמש ואז מספק מידע מפורט על המשלוחים בהזמנה. המשתמש מאשר שהוא רוצה לקבל הודעת SMS עם פרטים נוספים למספר הטלפון הרשום שלו.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| הנציג מאמת את המשתמש באמצעות הרכיב המוגדר מראש Retail authentication | |
| בסדר, יוני. השיחה שלך היא לגבי ההזמנה האחרונה של ישראל ישראלי, שכוללת מנורה, חולצה ו-10 פריטים נוספים, שבוצעה ב-10 בנובמבר 2023 בשעה 18:00? | |
| כן | |
| ההזמנה שלך כוללת 2 משלוחים, שיגיעו עד 15 בינואר 2024. רוצה לשמוע עוד על המשלוחים האלה? |
|
| כן | |
| משלוח 1, שמכיל ג'ינס, חגורה ו-2 פריטים נוספים, נמצא בדרך ויימסר עד 12 בינואר 2024. משלוח 2, שמכיל מנורה, חולצה ו-6 פריטים נוספים, נמסר ב-12 בנובמבר 2023. רוצה לקבל הודעת SMS עם פרטים נוספים על הפריטים? |
|
| כן | |
| שלחנו לך הודעת SMS עם קישור למעקב אחרי הסטטוס של כל המשלוחים שלך. תודה שהתקשרת אלינו. |
הזמנות כפולות
משתמש הקצה כבר אומת בעבר. המשתמש מבקש מידע על הזמנה ומספק את חמש הספרות האחרונות של ההזמנה. הנציג מזהה שלכמה הזמנות שביצע המשתמש הזה יש את אותן חמש ספרות אחרונות, ולכן הוא מאשר את ההזמנה שהמשתמש רוצה לשמוע את הסטטוס שלה ומספק למשתמש את סטטוס ההזמנה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| בסדר, ענבר. השיחה שלך היא לגבי ההזמנה האחרונה של Amber Doe, שכוללת מנורה, חולצה ועוד 2 פריטים, שבוצעה ב-10 בנובמבר 2023 בשעה 18:00? | |
| לא | |
| מהן 5 הספרות האחרונות של מזהה ההזמנה שברצונך לעקוב אחריה? | |
| 12355 | |
| חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12355, נכון? | |
| כן, זה נכון | |
| מעולה, סיימנו לאסוף את מזהה ההזמנה. | |
| לפי הרישומים שלנו, מצאנו 2 הזמנות שמסתיימות ב-5 הספרות הזהות 12355. איזו הזמנה חיפשת? הזמנה מספר 1 שבוצעה ב-10 בנובמבר 2023 בשעה 18:00 או הזמנה מספר 2 שבוצעה ב-9 בנובמבר 2023 בשעה 20:00? כדי לבחור בהזמנה מספר 1, צריך להגיד "1". כדי לבחור בהזמנה מספר 2, צריך להגיד "2". אחרת, אומרים "לא". |
|
| הזמנת מכשיר אחד | |
| ההזמנה שלך כוללת 2 משלוחים, שיגיעו עד 15 בינואר 2024. רוצה לשמוע עוד על המשלוחים האלה? |
|
| כן | |
| משלוח 1 שמכיל ג'ינס נמצא בדרך ויימסר עד 15 בינואר 2024. משלוח 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. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages, לוחצים על Start Page.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על 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. |
מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. מידע נוסף זמין במאמר הגדרת Webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים ברכיב הזה. הוראות מפורטות זמינות במאמר הגדרת webhook לאימות קמעונאי.
קבלת פרטי ההזמנה
הרכיב משתמש ב-webhook prebuilt_components_order_status:get_order_details כדי לאחזר פרטים של הזמנה ספציפית.
פרמטרים של בקשות 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 "קבלת פרטי הזמנה" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_order_status:get_order_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת הזמנות כפולות
הרכיב משתמש ב-webhook של prebuilt_components_retail_services:get_duplicate_order כדי לאחזר מידע מפורט, במטרה להבחין בין הזמנות כשלכמה מספרי הזמנות יש את אותן חמש ספרות אחרונות.
פרמטרים של בקשות 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 "קבלת הזמנות כפולות" לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_retail_services:get_duplicate_order.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שלח SMS
ה-webhook prebuilt_components_order_status:send_sms משמש את הרכיב לשליחת פרטי ההזמנה למספר הטלפון שצוין באמצעות SMS.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_id | מזהה ההזמנה שרוצים לשלוח את הפרטים שלה. | מחרוזת |
כדי להגדיר את ה-webhook של שליחת SMS לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_order_status:send_sms.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הפעלת התראות
ה-webhook prebuilt_components_order_status:enable_notification משמש את הרכיב כדי להפעיל התראות למספר הטלפון הרשום של המשתמש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_notification | מציין אם צריך להפעיל התראות למשתמש. | בוליאני |
כדי להגדיר את ה-webhook של הפעלת ההתראות לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_order_status:enable_notification.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.