הרכיב המוגדר מראש לטיפול בהונאות ובערעורים בקמעונאות מאפשר למשתמשים לאמת את הזהות שלהם. אחרי שהמשתמש מאומת, הרכיב מספק מידע על ההזמנות האחרונות או הקודמות של המשתמש, ומאפשר למשתמש לשלוח ערעור שקשור להזמנה או למוצר.
הרכיב הזה משתמש ברכיב המוגדר מראש Retail authentication כדי לאפשר למשתמשים לאמת את עצמם.
הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה אחרי שהיא מסתיימת.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.
ערעור על מוצר ספציפי
- אם המשתמש לא אומת בעבר, הנציג אוסף פרטים על ההזמנות הקודמות של המשתמש כדי לאמת את זהותו.
- אחרי האימות, הנציג אוסף מידע על הערעור, כולל הסיבה לערעור והמוצר הספציפי שהמשתמש רוצה לערער עליו.
- הנציג שולח את הערעור ומספק את מספר האישור.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| שלום, John. כדי לאמת את הזהות שלכם, נצטרך את מזהה ההזמנה, תאריך העסקה והסכום לפני שנגיש את בקשת הערעור או התלונה על הונאה. | |
| מהן 5 הספרות האחרונות של מזהה ההזמנה? | |
| 12345 | |
| חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12345, נכון? | |
| כן | |
| מעולה, סיימנו לאסוף את מזהה ההזמנה. מה תאריך ההזמנה? צריך לומר את חודש ההזמנה, לאחר מכן את יום ההזמנה ואז את שנת ההזמנה. |
|
| 2023-10-12 | |
| אוקיי, תאריך ההזמנה שלך הוא 12 באוקטובר 2023, נכון? | |
| כן | |
| מעולה, קיבלנו את תאריך ההזמנה. מה סכום ההזמנה בדולרים? לדוגמה, אם סכום העסקה בהזמנה היה 100.30$, אומרים "100". |
|
| 97 | |
| אוקיי, סכום העסקה של ההזמנה הוא 97$, נכון? | |
| כן | |
| צריך לציין את סוג התרמית או המחלוקת שרוצים לדווח עליה. אפשר לומר משהו כמו: תשלומים או חיוב, מוצר, החזרות והחזר כספי, אבטחת מידע או בעיות שקשורות לפרטיות, משלוח או הובלה, אריזה, או לומר "אחרים". | |
| מוצר | |
| תודה על העדכון. כדי לאשר, הסיבה להונאה או למחלוקת היא המוצר. זה נכון? | |
| כן | |
| ציינו אם הבעיה שבחרתם קשורה להזמנה שלמה, למוצר ספציפי או לכל נושא אחר. | |
| מוצר | |
| האם השיחה שלך קשורה להזמנה האחרונה שלך, שמספרה מסתיים ב-12345, שכוללת 2 מנורות, חולצה אחת ומוצר נוסף, ובוצעה ב-10 בנובמבר 2023 בשעה 18:00? | |
| כן | |
| מצאנו כמה מוצרים בהזמנה שלך. באיזה מוצר מדובר? מוצר 1: מנורת Google, מוצר 2: חולצת Google, מוצר 3: מכנסי ג'ינס של Google. אפשר לומר או להזין את מספר המוצר שרוצים לבחור, או לומר "הבא" כדי להציג מוצרים נוספים. |
|
| 3 | |
| כדי לאמת, אתם רוצים לפתוח פנייה בנושא הונאה או מחלוקת לגבי Google Jeans. זה נכון? | |
| כן | |
| בכמה מילים, מה הסיבה המפורטת לתרמית או למחלוקת? | |
| איכות ירודה | |
| כדי לאשר, הסיבה שצוינה להונאה או למחלוקת היא באיכות נמוכה. זה נכון? | |
| כן | |
| תודה על האישור. פתחנו פנייה לצוות שלנו שאחראי על הונאות או מחלוקות. הם אמורים לחזור אליך בקרוב. מספר הפנייה שלך הוא 6595513. רוצה לשמוע שוב את מספר האישור? |
|
| כן | |
| מספר הפנייה שלך הוא 6595513. רוצה שנשלח לך הודעת אישור עם מספר הפנייה? |
|
| כן | |
| איך אתם רוצים לקבל את הודעת האישור – בטלפון או באימייל שרשומים בחשבון? | |
| טלפון | |
| רק כדי לוודא, רוצה לקבל את הודעת האישור בטלפון? צריך לומר כן או לא. | |
| כן | |
| תודה. הודעת אישור נשלחה לטלפון הרשום שלך. התהליך עשוי להימשך זמן מה. רוצה לפתוח כרטיס תמיכה בנושא הונאה או ערעור לגבי הזמנה אחרת? |
|
| לא | |
| תודה שהתקשרת אלינו. הצוות שלנו יטפל בפנייה שלך. |
מוסכמות למתן שמות
הרכיב הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | הונאה וערעור |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_dispute_reason |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_fraud_and_dispute_order:get_security_answers |
פרמטרים של קלט
פרמטרים של קלט קובעים התנהגויות מסוימות של הרכיב. תנאי אחד או יותר בתהליך משתמשים בפרמטרים האלה כדי לקבוע את ההתנהגות של הרכיב. אתם צריכים להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.
הרכיב הזה מקבל את הפרמטרים הבאים:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $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_telephone_number | מציינת את מספר הניסיונות החוזרים שמותרים כשמזינים מספר טלפון רשום. ערך ברירת המחדל הוא 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_report_confirm | מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמאשרים את המוצר שנבחר. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_dispute_reason | מציין את מספר הניסיונות החוזרים המותרים כשמאשרים את הסיבה להתנגדות. ערך ברירת המחדל הוא 2. |
מספר שלם |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה יצירה.
- לוחצים על הרכיב המיובא בקטע Flows.
- בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שנשארים פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב.
הרכיב המוגדר מראש הזה מספק ערכים לפרמטרים הבאים של הפלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| all_recent_order_id | רשימה של מזהי הזמנות שמשויכים למשתמש המאומת, ממוינת לפי תאריך ביצוע ההזמנה בסדר יורד. הרכיב הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null. |
רשימה (מחרוזת) |
| אימייל | כתובת האימייל שרשומה בחשבון. | מחרוזת |
| user_first_name | השם הפרטי של המשתמש, שמשמש לברכת שלום ולאישור הבעלות על החשבון. | מחרוזת |
| dispute_ticket_id | מזהה הכרטיס של הערעור שנשלח. | מחרוזת |
| 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 של פרטי המשתמש, כדי להגדיר את ה-webhook של prebuilt_components_retail_authentication:verify_user_details.
קבלת פרטי ההזמנה
הרכיב משתמש ב-webhook prebuilt_components_fraud_and_dispute_order:get_order_details כדי לאחזר פרטים של הזמנה מסוימת.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.order_id | מזהה ההזמנה שרוצים לאחזר את הפרטים שלה. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| order_date | התאריך שבו ההזמנה בוצעה, בפורמט YYYY-MM-DD. |
מחרוזת |
| order_time | המועד שבו ההזמנה בוצעה, בפורמט HH:MM. |
מחרוזת |
| order_product_count | מספר המוצרים הייחודיים בהזמנה. | מספר שלם |
| order_amount | הסכום הכולל של ההזמנה. | מספר שלם |
| order_payment_mode | מציין את אמצעי התשלום שבו השתמשו לביצוע ההזמנה. | מחרוזת |
| all_product_id | רשימה של מזהי המוצרים של כל המוצרים בהזמנה. | רשימה (מחרוזת) |
| all_product_name | רשימה של שמות המוצרים של כל המוצרים בהזמנה. | רשימה (מחרוזת) |
| all_product_brand_name | רשימה של שמות המותגים של כל המוצרים בהזמנה. | רשימה (מחרוזת) |
| all_product_quantity | רשימה של כמויות לכל המוצרים בהזמנה. | רשימה (מחרוזת) |
כדי להגדיר את ה-webhook "קבלת פרטי הזמנה" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_fraud_and_dispute_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_fraud_and_dispute_order:post_reporting_details כדי לשלוח כרטיס תמיכה בנושא הונאה או מחלוקת.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_id | מזהה ההזמנה שעבורה רוצים לשלוח פנייה. | מחרוזת |
| $flow.dispute_product_id | מזהה המוצר שהמשתמש רוצה להגיש לגביו ערעור. | מחרוזת |
| $flow.order_product_dispute_reason | הסיבות לערעור על המוצר. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_product_dispute_reason. |
מחרוזת |
| $flow.order_product_dispute_reason_other | אם המשתמש בחר באפשרות "אחר" כסיבה לערעור, השדה הזה מכיל את הסיבה הספציפית לערעור שהמשתמש סיפק. | מחרוזת |
| $flow.order_product_dispute_reason_detail | סיבה מפורטת להתנגדות. | מחרוזת |
פרמטרים של תגובה מה-API
הרכיב מאחזר את הפרמטרים הבאים מהתגובה מה-API:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| order_product_dispute_ticket_number | מזהה הכרטיס של הערעור שנשלח. | מחרוזת |
כדי להגדיר את ה-webhook של פרטי הדיווח לאחר פרסום המודעה ברכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_fraud_and_dispute_order:post_reporting_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת הודעה
הרכיב משתמש ב-webhook של prebuilt_components_fraud_and_dispute_order:send_message כדי לשלוח למשתמש פרטי אישור לגבי הערעור.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_product_dispute_ticket_number | מספר האישור של הערעור שנשלח. | מחרוזת |
| $flow.confirmation_channel | הערוץ הספציפי שאליו יישלח המידע. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_channel_email_phone. כברירת מחדל, יש תמיכה ב-phone וב-email. |
מחרוזת |
כדי להגדיר את ה-webhook של שליחת ההודעות לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על תגובות לפעולה מאתר אחר (webhooks).
- בוחרים את ה-webhook prebuilt_components_fraud_and_dispute_order:send_message.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הרכיב וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.