הרכיב המוגדר מראש לביטול הזמנה בודק את רמת האימות של המשתמש. אחרי שהמשתמש מאומת, הרכיב מספק מידע על ההזמנות האחרונות או הקודמות של המשתמש. המשתמש יכול לבחור לבטל הזמנה שלמה או פריטים ספציפיים בהזמנה. הרכיב הזה משתמש ברכיב המובנה אימות קמעונאי כדי לאמת משתמשים. הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה אחרי שהיא מסתיימת.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
ביטול מוצר בודד בהזמנה שבוצעה לאחרונה
משתמש הקצה כבר אומת בעבר. הנציג מאשר אילו פריטים מההזמנה האחרונה צריך לבטל. הנציג בודק את אמצעי התשלום המקורי ומאשר את פרטי הביטול מול המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם השיחה שלך קשורה להזמנה האחרונה שלך, שמספרה מסתיים ב-12978, שכוללת 5 בקבוקי מים וטי-שירט אחת, ובוצעה ב-9 בנובמבר 2023 בשעה 20:00? | |
| כן | |
| מצאנו בהזמנה שלך כמה מוצרים שעומדים בדרישות. איזה מוצר ברצונך לבטל? מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טי של Google. צריך לומר או להזין את מספר המוצר של הפריט שברצונך לבחור, או לומר "הבא" כדי להציג מוצרים נוספים. |
|
| הבא | |
| לא מצאנו פריטים נוספים ברשומות שלנו. צריך לבחור מהרשימה ששותפה. מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טי של Google. צריך לומר או להזין את מספר המוצר של הפריט שרוצים לבחור, או לומר "הבא" כדי להציג מוצרים נוספים. |
|
| 1 | |
| כדי לאמת, אתם מעוניינים לבטל את בקבוק המים של Google. זה נכון? | |
| כן | |
| אנחנו רואים שהכמות הזמינה של המוצר שבחרת היא 5. צריך לציין את כמות המוצרים שרוצים לבטל. | |
| 4 | |
| צריך לציין את הסיבה לביטול. אפשר לומר משהו כמו: שיניתי את דעתי, כבר לא צריך, אני רוצה לקנות פריט אחר, המשלוח התעכב, קניתי בטעות, אני רוצה לשנות את אמצעי התשלום, או לומר סיבה אחרת. | |
| אני רוצה לקנות פריט אחר | |
| תודה על העדכון. רוצה לבטל מוצר נוסף? |
|
| לא | |
| אם הרכישה בוצעה באמצעות הארנק, ההחזר הכספי יועבר לארנק או לחשבון הזיכוי ב-Store. ההחזר הכספי יופיע בחשבון תוך 3 עד 5 ימי עסקים. חשוב לדעת: סכום ההחזר הכספי לא כולל את דמי המשלוח והטיפול. |
ביטול ההזמנה כולה
משתמש הקצה כבר אומת בעבר. הנציג מוודא שהמשתמש רוצה לבטל הזמנה ספציפית, ואז אוסף את סיבת הביטול. הנציג בודק את אמצעי התשלום המקורי ומאשר את פרטי הביטול מול המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם השיחה שלך קשורה להזמנה האחרונה שביצעת, שמספרה מסתיים ב-12345, שכוללת חולצה אחת ובוצעה בתאריך 10.11.2023 בשעה 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 שמוחזר על ידי ה-webhook של get_order_details, שמציין אמצעי תשלום בזמן המסירה (COD). ערך ברירת המחדל הוא "COD". |
מחרוזת |
| $flow.order_payment_mode_store_credit | מציין את הערך של השדה order_payment_mode שמוחזר על ידי ה-webhook של get_order_details, שמציין אמצעי תשלום של זיכוי ב-Store. ערך ברירת המחדל הוא "store_credit". |
מחרוזת |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף 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. |
מחרוזת |
גנרטורים
הרכיב הזה משתמש בגנרטורים כדי להפעיל חלקים ספציפיים בשיחה.
סיכום
המחולל Summarization משמש ליצירת סיכום אחרי השיחה שמתאר את השיחה שבה טיפל הרכיב.
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. מידע נוסף זמין במאמר הגדרת Webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים ברכיב הזה. הוראות מפורטות זמינות במאמר הגדרת webhook לאימות קמעונאי.
קבלת פרטי ההזמנה
הרכיב משתמש ב-webhook prebuilt_components_cancel_order:get_order_details כדי לאחזר פרטים של הזמנה ספציפית.
פרמטרים של בקשות 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 "קבלת פרטי הזמנה" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_cancel_order:get_order_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת פרטי הזמנה כפולים
הרכיב משתמש ב-webhook של prebuilt_components_retail_services:get_duplicate_order_details כדי לאחזר מידע מפורט, במטרה להבחין בין הזמנות כשלכמה מספרי הזמנות יש את אותן חמש ספרות אחרונות.
פרמטרים של בקשות 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_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
פרטי הביטול של הפוסט
הרכיב משתמש ב-webhook prebuilt_components_cancel_order:post_cancellation_details כדי לשלוח בקשת ביטול.
פרמטרים של בקשות 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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.