רכיב מוכן מראש לזיהוי הונאות קמעונאיות וניהול מחלוקות

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

הרכיב הזה משתמש ברכיב המוגדר מראש Retail authentication כדי לאפשר למשתמשים לאמת את עצמם.

הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה אחרי שהיא מסתיימת.

מגבלות

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

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

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

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

ערעור על מוצר ספציפי

  1. אם המשתמש לא אומת בעבר, הנציג אוסף פרטים על ההזמנות הקודמות של המשתמש כדי לאמת את זהותו.
  2. אחרי האימות, הנציג אוסף מידע על הערעור, כולל הסיבה לערעור והמוצר הספציפי שהמשתמש רוצה לערער עליו.
  3. הנציג שולח את הערעור ומספק את מספר האישור.
הטקסט של המשתמש התשובה של הסוכן
שלום, 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. מספר שלם

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

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה יצירה.
  5. לוחצים על הרכיב המיובא בקטע Flows.
  6. בקטע Pages (דפים), לוחצים על Start Page (דף התחלה).
  7. לוחצים על המסלול true בדף הפתיחה.
  8. בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
  9. לוחצים על 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 יוצר סיכום של השיחה שמתאר את השיחה שטופלה על ידי הרכיב.

הגדרה בסיסית

כדי להגדיר את הרכיב המוכן מראש:

  1. מייבאים את הרכיב המוגדר מראש.
  2. מגדירים את ה-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 "קבלת פרטי הזמנה" לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_fraud_and_dispute_order:get_order_details.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על 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 "קבלת פרטים של הזמנה כפולה" לרכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_retail_services:get_duplicate_order_details.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על 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 של פרטי הדיווח לאחר פרסום המודעה ברכיב הזה, מרחיבים את ההוראות.

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב-Google Cloud.
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. לוחצים על תגובות לפעולה מאתר אחר (webhooks).
  6. בוחרים את ה-webhook‏ prebuilt_components_fraud_and_dispute_order:post_reporting_details.
  7. מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
  8. בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
  9. בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
  10. בודקים ומעדכנים את הגדרות האימות לפי הצורך.
  11. לוחצים על 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 של שליחת ההודעות לרכיב הזה, צריך להרחיב את ההוראות.

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

הושלמה

הרכיב וה-webhooks שלו מוגדרים עכשיו ומוכנים לבדיקה.