הרכיב המובנה של ביטול ההזמנה בודק את רמת האימות של המשתמש. אחרי שהמשתמש עובר אימות, הרכיב מספק מידע על ההזמנות האחרונות או הקודמות של המשתמש. לאחר מכן המשתמש יכול לבטל הזמנה שלמה או לבטל פריטים ספציפיים בהזמנה. הרכיב הזה משתמש ברכיב המובנה Retail authentication כדי לאמת משתמשים. הרכיב משתמש גם בגנרטורים לסיכום אחרי השיחה.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, לרכיב המוכן מראש הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. דיאלוגים לדוגמה שמדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הנציג בתחילת השיחה.
ביטול מוצר יחיד בהזמנה מהזמן האחרון
משתמש הקצה אומת בעבר. הנציג יאשר איתך אילו פריטים מההזמנה האחרונה צריך לבטל. הנציג בודק את אמצעי התשלום המקורי ומאשר את פרטי הביטול עם המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם התקשרת בנוגע למספר ההזמנה האחרונה שלך שמסתיים ב-12978, שכוללת 5 בקבוקי מים וחולצה אחת, שבוצעה בתאריך 2023-11-09 בשעה 20:00? | |
| כן | |
| מצאנו כמה מוצרים בהזמנה שלך שעומדים בדרישות. איזה מוצר תרצה לבטל? מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טישרט של Google. עליך להגיד או להזין את מספר המוצר של הפריט שברצונך לבחור, או להגיד 'הבא' כדי להציג מוצרים נוספים. |
|
| הבא | |
| לא מצאנו פריטים אחרים ברשומות שלנו. עליך לבחור מתוך הרשימה המשותפת. מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טישרט של Google. עליך להגיד או להזין את מספר המוצר של הפריט שרוצה לבחור, או להגיד 'הבא' כדי לראות עוד מוצרים. |
|
| 1 | |
| כדי לאשר שאתם מעוניינים לבטל את ההזמנה של בקבוק המים של Google. זה נכון? | |
| כן | |
| אנחנו רואים שהכמות הזמינה של המוצר שבחרת היא 5. עליך לציין את כמות המוצרים שברצונך לבטל. | |
| 4 | |
| צריך לציין את הסיבה לביטול. אפשר לומר משהו כמו: התחרטתי, כבר לא צריך, רוצה לקנות פריט אחר, המשלוח מתעכב, קניתי בטעות, רוצה לשנות את אמצעי התשלום, או לומר משהו אחר. | |
| אני רוצה לקנות פריט נוסף | |
| תודה שפנית אלינו. רוצה לבטל עוד מוצר? |
|
| לא | |
| אם ביצעתם רכישות באמצעות הארנק, ההחזרים הכספיים יועברו לארנק או לחשבון שלכם בקרדיט בחנות. יחלפו 3 עד 5 ימי עסקים עד שההחזר הכספי יופיע בחשבון שלכם. לתשומת ליבך, סכום ההחזר הכספי לא יכלול את עלויות המשלוח והטיפול. |
ביטול הזמנה מלאה
משתמש הקצה אומת בעבר. הנציג מאשר שהמשתמש רוצה לבטל הזמנה ספציפית, ואז אוסף את סיבת הביטול. הנציג בודק את אמצעי התשלום המקורי ומאשר את פרטי הביטול מול המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם ההתקשרות שלך היא בנוגע למספר ההזמנה האחרון שלך שמסתיים ב-12345 וכולל חולצה אחת שהוזמנה בתאריך 2023-11-10 בשעה 18:00? | |
| לא | |
| רוצה לבטל הזמנה אחרת? | |
| כן | |
| אפשר לקבל את 5 הספרות האחרונות של מספר ההזמנה שברצונך לעקוב אחריה? | |
| 12346 | |
| חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12346. האם זה נכון? | |
| כן | |
| יופי, סיימנו לאסוף את מזהה ההזמנה. רוצה לבטל את כל ההזמנה? |
|
| כן | |
| צריך לציין את הסיבה לביטול. אפשר לומר משהו כמו: התחרטתי, כבר לא צריך, רוצה לקנות פריט אחר, המשלוח מתעכב, קניתי בטעות, רוצה לשנות את אמצעי התשלום, או לומר משהו אחר. | |
| כבר לא צריך | |
| תודה שהודעת לנו. יצרנו את בקשת הביטול שלך. |
מוסכמות למתן שמות
הרכיב המובנה הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | ביטול הזמנה |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_cancel_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_cancel_order:post_cancellation_details |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר פרמטרים בהיקף של זרימת נתונים בדף ההתחלה של הרכיב. אפשר להגדיר פרמטרים ברמת הסשן באמצעות זרימת שיחות או בדף הפתיחה של הרכיב הזה.
המרכיב המובנה הזה מקבל את פרמטרי הקלט הבאים:
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | (אופציונלי) מספר הטלפון המקומי של המשתמש, ללא קידומת המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $session.params.all_recent_order_id | (אופציונלי) הפרמטר הזה מציג רשימה של מזהי הזמנות שמשויכים למשתמש המאומת, ממוינים לפי תאריך ביצוע ההזמנה בסדר יורד. האלמנט הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null. |
רשימה (מחרוזת) |
| $session.params.email | (אופציונלי) כתובת האימייל שרשומה בחשבון. | מחרוזת |
| $session.params.user_first_name | (אופציונלי) השם הפרטי של המשתמש, שמשמש לברכה ולאישור הבעלות על החשבון. | מחרוזת |
הרכיב המובנה מראש הזה מאפשר להגדיר את הפרמטרים האופציונליים הבאים כדי לקבוע את ההתנהגות של הרכיב, כולל ניסיונות חוזרים.
| שם הפרמטר | תיאור | פורמט |
|---|---|---|
| $flow.max_retry_another_account_counter | מציין את מספר הניסיונות החוזרים שמותרים כשבוחרים אם להמשיך עם חשבון חלופי. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_order_number | מציינת את מספר הניסיונות המותרים כשמספקים את חמש הספרות האחרונות של מספר הזמנה. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_another_order | מציין את מספר הניסיונות החוזרים שמותרים כשבוחרים הזמנה אחרת במקרים שבהם מזהה ההזמנה לא נמצא או שההזמנה לא כשירה לביטול. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_select_order_number | מציין את מספר הניסיונות החוזרים שמותרים כשמספקים את מספר ההזמנה המלא במקרים שבהם לכמה הזמנות יש את אותן חמש ספרות אחרונות. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_product_display_counter | מציין את המספר המקסימלי של מוצרים שיוצגו בתור אחד. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_product_display | מציין את המספר המקסימלי של מוצרים שיוצגו במהלך השיחה. ערך ברירת המחדל הוא 9. |
מספר שלם |
| $flow.max_retry_product_number_counter | מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים מוצר לביטול. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_product_cancel_confirm_counter | מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמאשרים את המוצר שנבחר. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_select_quantity | מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים את כמות המוצרים לביטול. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.order_product_cancel_reason_others | מציין את הערך של הישות prebuilt_components_product_cancel_reason שמציין שהמשתמש בחר בסיבת ביטול אחרת. ערך ברירת המחדל הוא "others". |
מחרוזת |
| $flow.max_retry_cancel_reason | מציינת את מספר הניסיונות החוזרים שמותרים כשמאשרים את הסיבה לביטול. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.order_payment_mode_COD | מציין את הערך של השדה order_payment_mode שמוחזר על ידי get_order_details webhook ומציין אמצעי תשלום של תשלום בזמן המסירה (COD). ערך ברירת המחדל הוא "COD". |
מחרוזת |
| $flow.order_payment_mode_store_credit | מציין את הערך של השדה order_payment_mode שמוחזר על ידי get_order_details webhook ומציין אמצעי תשלום של קרדיט בחנות. ערך ברירת המחדל הוא "store_credit". |
מחרוזת |
כדי להגדיר את פרמטרי הקלט של הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- בוחרים בכרטיסייה Build (פיתוח).
- לוחצים על הרכיב המיובא בקטע Flows (תהליכי עבודה).
- בקטע דפים, לוחצים על דף הפתיחה.
- לוחצים על המסלול 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. |
מחרוזת |
גנרטורים
הרכיב הזה משתמש בגנרטורים כדי להפעיל חלקים ספציפיים בשיחה.
סיכום
הגנרטור Summarization משמש ליצירת סיכום של השיחה אחרי שהיא מסתיימת, שמתאר את השיחה שהרכיב טיפל בה.
הגדרה בסיסית
כדי להגדיר את הרכיב המובנה הזה:
- מייבאים את הרכיב שנוצר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו עם הגדרה שמתארת את השירותים החיצוניים. אפשר לעיין במאמר בנושא הגדרת webhook.
הגדרת webhook
כדי להשתמש ברכיב הזה, תצטרכו להגדיר את הוויבהוקים הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים שלכם.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים עבור הרכיב הזה. הוראות מפורטות זמינות במאמר בנושא הגדרת webhook לאימות קמעונאי.
קבלת פרטי ההזמנה
רכיב prebuilt_components_cancel_order:get_order_details webhook משמש לאחזור פרטי הזמנה עבור הזמנה ספציפית.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $flow.order_id | מזהה ההזמנה שאותה רוצים לאחזר. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| order_date | התאריך שבו בוצעה ההזמנה, בפורמט YYYY-MM-DD. |
מחרוזת |
| order_time | השעה שבה בוצעה ההזמנה, בפורמט HH:MM. |
מחרוזת |
| order_product_count | מספר המוצרים הייחודיים בהזמנה. | מספר שלם |
| order_payment_mode | מציין את אמצעי התשלום שבו השתמשתם כשביצעתם את ההזמנה. | מחרוזת |
| cancelable_product_id | רשימה של מזהי מוצרים שאפשר לבטל בהזמנה. | רשימה (מחרוזת) |
| cancelable_product_name | רשימה של שמות מוצרים שניתן לבטל בהזמנה. | רשימה (מחרוזת) |
| cancelable_product_brand_name | רשימה של שמות מותגים של מוצרים שאפשר לבטל בהזמנה. | רשימה (מחרוזת) |
| cancelable_product_quantity | רשימת הכמויות של מוצרים שניתן לבטל בהזמנה. | רשימה (מחרוזת) |
כדי להגדיר את ה-webhook של Get order details (קבלת פרטי הזמנה) לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook של prebuilt_components_cancel_order:get_order_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
קבלת פרטים על הזמנות כפולות
רכיב ה-prebuilt_components_retail_services:get_duplicate_order_details 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 order details (קבלת פרטים של הזמנה כפולה) עבור הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_retail_services:get_duplicate_order_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
פרטים אחרי הביטול
רכיב prebuilt_components_cancel_order:post_cancellation_details webhook משמש לשליחת בקשת ביטול.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_id | מזהה ההזמנה שרוצים לשלוח לגביה כרטיס. | מחרוזת |
| $flow.cancel_product_id_list | רשימה של מזהי מוצרים שהמשתמש רוצה לבטל. | רשימה (מחרוזת) |
| $flow.cancel_product_quantity_list | רשימה של כמויות המוצרים שהמשתמש רוצה לבטל, בהתאמה לכל רכיב ב-$flow.cancel_product_id_list. |
רשימה (מחרוזת) |
| $flow.cancel_reason_list | רשימה של סיבות לביטול של כל מוצר שבוטל, בהתאמה לכל רכיב ב-$flow.cancel_product_id_list. |
רשימה (מחרוזת) |
| $flow.order_refund_mode | מצב התשלום להחזר כספי. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_cancel_mode_of_refund. |
מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| order_cancellation_ticket_id | מזהה הכרטיס של הביטול שנשלח. | מחרוזת |
כדי להגדיר את ה-webhook של פרטי ביטול הפוסט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_cancel_order:post_cancellation_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.