רכיב מוכן מראש של הזמנה שבוצעה בה המרה

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

מגבלות

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

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

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

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

החלפת פריט פגום בחנות

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

קלט של משתמשים	התשובה של הסוכן
	האם השיחה שלך קשורה להזמנה האחרונה שביצעת ב-10 בנובמבר 2023, שמספרה מסתיים ב-12375 וכוללת 2 מנורות, 2 מכשירי Pixel ו-10 מוצרים אחרים?
כן
	מצאנו בהזמנה שלך כמה מוצרים שעומדים בדרישות. איזה מוצר ברצונך להחליף? מוצר 1: מנורת Google, מוצר 2: Google Pixel, מוצר 3: נורית LED של Google. אפשר לומר או להזין את מספר המוצר שרוצים לבחור, או לומר "הבא" כדי להציג מוצרים נוספים.
1
	רק כדי לוודא, אתם רוצים להחליף את המנורה של Google. זה נכון?
כן
	אנחנו רואים שהכמות הזמינה של המוצר שבחרת היא 2. צריך לציין את כמות המוצרים שרוצים להחליף.
שתיים
	צריך לציין את הסיבה להחלפה. אפשר לומר משהו כמו: הפריט פגום או לא פועל, בעיה במידה או בהתאמה, בעיה בהזמנה לא שלמה, בעיה בסגנון, צבע שגוי או לומר "אחר".
הפריט פגום
	תודה שעדכנת אותנו. כשלב אחרון, איך ברצונך להחליף את המוצר? לדוגמה: "החלפה בחנות" או "תיאום איסוף".
אני רוצה להחליף את המוצר בחנות
	בואו נחפש חנות בסביבה שלכם.
	הנציג אוסף את המיקוד באמצעות הרכיב המוגדר מראש איסוף מיקוד
	זו רשימת המיקומים שקרובים למיקוד שהזנת. כתובת 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. כתובת 2: Google California, 19510 Jamboree Road, Irvine, California 92612, US. צריך לומר או להזין את מספר הכתובת שרוצים לבחור, או לומר "הבא" כדי להציג עוד כתובות של חנויות.
החנות הראשונה
	בחרת את Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. זה נכון?
כן
	מעולה. שלחנו תווית משלוח ומספר פנייה למספר הטלפון ולכתובת האימייל שרשומים בחשבון שלך. צריך להדפיס אותה, לצרף אותה לחבילה ולשלוח את הפריט להחלפה תוך 30 יום. אחרי שהפריט יגיע למחסן שלנו, ההחלפה תופיע בחשבון תוך 3 עד 5 ימי עסקים. לתשומת ליבך: סכום ההחזר הכספי לא יכלול את דמי המשלוח והטיפול. המוצר החלופי שלך הוא בעל ערך גבוה יותר. ההפרש במחיר הוא 20$. בקרוב יישלח אליך קישור לתשלום למספר הטלפון הנייד הרשום שלך. כדי לבצע את ההחלפה, צריך לבצע את התשלום תוך 24 שעות. רוצה להחליף הזמנה אחרת?
לא, זה הכול
	תודה שהתקשרת.

החזר כספי על הפרש במחיר

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

קלט של משתמשים	התשובה של הסוכן
	האם השיחה שלך קשורה להזמנה האחרונה שלך, שמספרה מסתיים ב-12345, שכוללת 2 מנורות ובוצעה ב-10 בנובמבר 2023?
לא
	רוצה להחליף הזמנה אחרת?
כן
	מהן 5 הספרות האחרונות של מזהה ההזמנה שברצונך להחליף?
12346
	חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12346, נכון?
כן
	מעולה, סיימנו לאסוף את מזהה ההזמנה. מצאנו כמה מוצרים שעומדים בדרישות בהזמנה שלך. איזה מוצר ברצונך להחליף? מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טי של Google. אפשר לומר או להזין את מספר המוצר של הפריט שרוצים לבחור, או לומר "הבא" כדי להציג מוצרים נוספים.
שתיים
	כדי לאמת, אתה מעוניין להחליף את חולצת הטי של Google. זה נכון?
כן
	צריך לציין את הסיבה להחלפה. אפשר לומר משהו כמו: הפריט פגום או לא פועל, בעיה במידה או בהתאמה, בעיה בהזמנה לא שלמה, בעיה בסגנון, צבע שגוי או לומר "אחר".
בעיה במידה או בהתאמה
	תודה שעדכנת אותנו מה הסיבה להחלפה. לאיזו מידה היית רוצה להחליף? יש לנו את המידות הבאות: אומרים 1 למידה S. אומרים 2 למידה M. אומרים 3 למידה L. אומרים 4 למידה XL. אומרים 5 למידה XXL.
1
	כשלב אחרון, איך ברצונך להחליף את המוצר? לדוגמה: "החלפה בחנות" או "תיאום איסוף".
תזמון איסוף
	מעולה. שלחנו תווית משלוח למספר הטלפון ולכתובת האימייל שרשומים בחשבון שלך. צריך להדפיס אותה ולצרף אותה לחבילה. הצוות שלנו ייצור איתך קשר תוך 24 עד 48 שעות כדי לתאם איסוף. אחרי שנקבל את הפריט במחסן שלנו, ההחזר הכספי על ההחלפה יופיע בחשבון שלך תוך 3 עד 5 ימי עסקים. המוצר שהוחלף הוא בעל ערך נמוך יותר, ולכן מגיע לך החזר כספי בסך 5$. לאן לשלוח את ההחזר הכספי? אפשר לומר משהו כמו "זיכוי ב-Store" או "חשבון מקור".
זיכוי ב-Store
	תודה שאישרת שברצונך לקבל את ההחזר הכספי לארנק. רוצה להחליף הזמנה אחרת?
לא
	תודה שהתקשרת.

הזמנה שלא עומדת בדרישות

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

קלט של משתמשים	התשובה של הסוכן
	לא מצאנו בהזמנה האחרונה שלך מוצרים שאפשר להחליף. רוצה להחליף מוצר מהזמנה אחרת?
כן
	מהן 5 הספרות האחרונות של מזהה ההזמנה שברצונך להחליף?
23487
	חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 23487, נכון?
כן
	מעולה, סיימנו לאסוף את מזהה ההזמנה.
	מצטערים, אין בהזמנה שלך מוצרים שעומדים בדרישות המדיניות שלנו להחלפה. מידע נוסף על מדיניות ההחלפות שלנו זמין באתר שלנו. רוצה להחליף הזמנה אחרת?
לא
	תודה שהתקשרת.

מוסכמות למתן שמות

הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	סטטוס הזמנה
סוג ישות	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
תגובה לפעולה מאתר אחר (webhook)	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

פרמטרים של קלט

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

הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	(אופציונלי) מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$session.params.all_recent_order_id	(אופציונלי) הפרמטר הזה מציג את מזהי ההזמנות שמשויכים למשתמש המאומת, ממוינים לפי תאריך ביצוע ההזמנה בסדר יורד. הרכיב הראשון במערך מייצג את ההזמנה האחרונה. אם למשתמש אין הזמנות, הערך של הפרמטר הזה הוא null.	רשימה (מחרוזת)
‎$session.params.email	(אופציונלי) כתובת האימייל שרשומה בחשבון.	מחרוזת
$session.params.user_first_name	(אופציונלי) השם הפרטי של המשתמש, שמשמש לברכת שלום ולאישור הבעלות על החשבון.	מחרוזת

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

שם הפרמטר	תיאור	פורמט
$flow.max_retry_another_account	מגדירה את מספר הניסיונות החוזרים המותרים כשבוחרים אם להמשיך עם חשבון חלופי. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_order_number	מציינת את מספר הניסיונות החוזרים המותרים כשמזינים את חמש הספרות האחרונות של מספר ההזמנה. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_another_order	מציין את מספר הניסיונות החוזרים המותרים כשבוחרים הזמנה אחרת להחזרה, במקרים שבהם מזהה ההזמנה לא נמצא או שההזמנה לא כשירה להחלפה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_select_order_number	מציין את מספר ניסיונות החיפוש המותרים כשמזינים את מספר ההזמנה המלא, במקרים שבהם ליותר מהזמנה אחת יש את אותן חמש ספרות אחרונות. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_exchange_reason	מציינת את מספר הניסיונות המותרים כשמציינים את הסיבה להחלפה. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_exchange_reason_counter	מציינת את מספר הניסיונות החוזרים שמותרים כשמאשרים את הסיבה להחלפה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.order_product_exchange_reason_others	מציין את הערך של הישות prebuilt_components_exchange_order_reason שמציין שהמשתמש בחר באפשרות "אחר" כסיבה להחלפה. ערך ברירת המחדל הוא "others".	מחרוזת
$flow.max_product_display_counter	מציין את המספר המקסימלי של מוצרים שיוצגו בכל פעם. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_product_display	מציין את המספר המקסימלי של מוצרים שיוצגו במהלך השיחה כולה. ערך ברירת המחדל הוא 9.	מספר שלם
$flow.max_product_exchange_confirm	מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמאשרים את המוצר שנבחר. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_product_number_counter	מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים מוצר להחלפה. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_retry_select_quantity	מציין את מספר הניסיונות המקסימלי המותר כשבוחרים את כמות המוצרים להחלפה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_size_number_counter	מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים את הגודל להחלפה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_another_zip_code	מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמזינים מיקוד. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_store_display_counter	מציינת את המספר המקסימלי של חנויות שיוצגו בסבב אחד. ערך ברירת המחדל הוא 1.	מספר שלם
$flow.max_store_display	מציין את המספר המקסימלי של חנויות שיוצגו במהלך השיחה. ערך ברירת המחדל הוא 10.	מספר שלם
$flow.max_retry_store_number_counter	מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים חנות. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_store_selection	מציינת את מספר הניסיונות החוזרים המותרים כשמאשרים את בחירת החנות. ערך ברירת המחדל הוא 3.	מספר שלם
$flow.max_available_address_reselection_counter	מציין את מספר הניסיונות החוזרים המותרים כשמאשרים אם המשתמש רוצה לבחור כתובת חנות אחרת. ערך ברירת המחדל הוא 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".	מחרוזת
$flow.order_refund_mode_source_account	מציין את הערך של הישות prebuilt_components_exchange_order_refund_mode שמציין שהמשתמש בחר לקבל החזר כספי לחשבון המקור שלו. ערך ברירת המחדל הוא source_account.	מחרוזת
$flow.order_exchange_location_scheduled_for_pickup	מציין את הערך של הישות prebuilt_components_exchange_order_location שמציין שהמשתמש בחר לתזמן איסוף לצורך ההחלפה. ערך ברירת המחדל הוא scheduled_for_pickup.	מחרוזת

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

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

גנרטורים

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

שאלות נפוצות

הגנרטור FAQ משמש לטיפול בשאלות נפוצות לגבי החזרות והחלפות, כולל:

• יש תאריך יעד לתהליך ההחזרה?
• אפשר להחליף פריט שקיבלתי במתנה?
• מחיר המוצר וסכום ההחזר הכספי שונים. מה הסיבה לכך?

סיכום

המחולל Summarization משמש ליצירת סיכום אחרי השיחה שמתאר את השיחה שבה טיפל הרכיב.

הגדרה בסיסית

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

1. מייבאים את הרכיב שהוגדר מראש.
2. מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. מידע נוסף זמין במאמר הגדרת Webhook.

הגדרת תגובה לפעולה מאתר אחר (webhook)

כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.

אימות

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

קבלת פרטי ההזמנה

הרכיב משתמש ב-webhook‏ prebuilt_components_exchange_order:get_order_details כדי לאחזר פרטים של הזמנה ספציפית.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$flow.order_id	מזהה ההזמנה שרוצים לאחזר את הפרטים שלה.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
order_date	התאריך שבו בוצעה ההזמנה, בפורמט YYYY-MM-DD.	מחרוזת
order_product_count	מספר המוצרים הייחודיים בהזמנה.	מספר שלם
order_payment_mode	מציין את אמצעי התשלום שבו השתמשו לביצוע ההזמנה.	מחרוזת
exchangeable_product_id	רשימה של מזהי מוצרים שאפשר להחליף בהזמנה.	רשימה (מחרוזת)
exchangeable_product_name	רשימה של שמות המוצרים שאפשר להחליף בהזמנה.	רשימה (מחרוזת)
exchangeable_product_brand_name	רשימה של שמות מותגים של מוצרים שאפשר להחליף בהזמנה.	רשימה (מחרוזת)
exchangeable_product_quantity	רשימת הכמויות של המוצרים שאפשר להחליף בהזמנה.	רשימה (מחרוזת)
exchangeable_product_price	רשימת המחירים של המוצרים שאפשר להחליף בהזמנה.	רשימה (מחרוזת)

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

1. פותחים את מסוף Dialogflow CX.
2. בוחרים את הפרויקט ב-Google Cloud.
3. בוחרים את הסוכן.
4. לוחצים על הכרטיסייה ניהול.
5. לוחצים על Webhooks.
6. בוחרים את ה-webhook‏ prebuilt_components_exchange_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_exchange_order:get_available_exchange_size משמש את הרכיב כדי לאחזר את המידות הזמינות להחלפה במקרים שבהם המשתמש רוצה להחליף פריט בגלל בעיות במידה או בהתאמה.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
$flow.selected_order_product_id	מזהה המוצר שהמשתמש רוצה להחליף.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
product_available_sizes	רשימת המידות הזמינות למוצר שנבחר.	רשימה (מחרוזת)

כדי להגדיר את ה-webhook "קבלת גודל ההחלפה הזמין" לרכיב הזה, הרחיבו את ההוראות.

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

בדיקת זמינות של החלפת מוצר

ה-webhook‏ prebuilt_components_exchange_order:get_product_exchange_availability משמש את הרכיב כדי לבדוק אם המוצר, הכמות והמידה האופציונלית שהמשתמש בחר זמינים להחלפה.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$flow.order_id	מזהה ההזמנה שרוצים לאחזר את הפרטים שלה.	מחרוזת
$flow.selected_order_product_id	מזהה המוצר שהמשתמש רוצה להחליף.	מחרוזת
$flow.order_product_quantity_exchange_count	כמות המוצרים שהמשתמש רוצה להחליף.	מספר שלם
$flow.product_selected_size	המידה של המוצר שהמשתמש רוצה לקבל בתמורה.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

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

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

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

פתיחת כרטיס תמיכה בנושא הזמנה לא שלמה

הרכיב משתמש ב-webhook‏ prebuilt_components_exchange_order:raise_incomplete_order_ticket כדי לפתוח פנייה כשהמשתמש רוצה להחליף מוצר בהזמנה כי הוא לא שלם.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
‎$flow.order_id	מזהה ההזמנה שעבורה רוצים לפתוח כרטיס תמיכה.	מחרוזת
$flow.selected_order_product_id	מזהה המוצר שהמשתמש רוצה להחליף.	מחרוזת
$flow.order_product_quantity_exchange_count	כמות המוצרים שהמשתמש רוצה להחליף.	מספר שלם
$flow.order_product_exchange_reason	הסיבה שבגללה המשתמש רוצה להחליף את המוצר.	מחרוזת

כדי להגדיר את ה-webhook של "פתיחת פנייה בנושא הזמנה לא מלאה" לרכיב הזה, צריך להרחיב את ההוראות.

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

קבלת פרטי החנות

ה-webhook‏ prebuilt_components_exchange_order:get_store_details משמש את הרכיב כדי לאחזר את רשימת החנויות שנמצאות בקרבת המיקוד שהמשתמש סיפק.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
$flow.zip_code	מיקוד לחיפוש חנויות בסביבה.	מחרוזת

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
store_id	רשימה של מזהי חנויות.	רשימה (מחרוזת)
store_address	רשימה של כתובות החנויות שתואמות לכל רכיב של store_id.	רשימה (מחרוזת)

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

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

פרטי ההחלפה של הפריט

הרכיב משתמש ב-webhook של prebuilt_components_exchange_order:post_exchange_details כדי לשלוח בקשה להחלפה.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
‎$flow.order_id	מזהה ההזמנה שעבורה רוצים לפתוח כרטיס תמיכה.	מחרוזת
$flow.selected_order_product_id	מזהה המוצר שהמשתמש רוצה להחליף.	מחרוזת
$flow.order_product_quantity_exchange_count	כמות המוצרים שהמשתמש רוצה להחליף.	מספר שלם
$flow.product_selected_size	המידה של המוצר שהמשתמש רוצה לקבל בתמורה.	מחרוזת
$flow.order_product_exchange_reason	הסיבה שבגללה המשתמש רוצה להחליף את המוצר.	מחרוזת
$flow.order_exchange_location	המצב שנבחר לבורסה. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_exchange_order_location.	מחרוזת
$flow.order_exchange_store_id	מזהה החנות שהמשתמש בחר להחלפה בחנות.	מחרוזת
$flow.order_refund_mode	אמצעי התשלום להחזר הכספי, אם רלוונטי. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_exchange_order_refund_mode. אם לא נדרש החזר כספי, הערך הזה הוא null.	מחרוזת
‎$flow.total_refund_amount	הסכום להחזר כספי, אם מחיר המוצר שניתן להחלפה גבוה ממחיר המוצר החדש. אם לא נדרש החזר כספי, הערך הזה הוא null.	מספר שלם

פרמטרים של תגובה מה-API

הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.

שם הפרמטר	תיאור	פורמט הפלט
order_exchange_ticket_id	מזהה הכרטיס של ההחלפה שנשלחה.	מחרוזת

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

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

שליחת פרטי החזר כספי על תשלום במזומן בעת המסירה

הרכיב משתמש ב-webhook של prebuilt_components_exchange_order:send_COD_refund_information כדי לשלוח למשתמש מידע על תשלומים שקשורים להמרה.

פרמטרים של בקשות API

הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.

שם הפרמטר	תיאור	פורמט הקלט
‎$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
‎$flow.order_id	מזהה ההזמנה שעבורה רוצים לפתוח כרטיס תמיכה.	מחרוזת
$flow.channel	הערוץ הספציפי שאליו יישלח המידע. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_channel_email_phone. כברירת מחדל, יש תמיכה ב-phone וב-email.	מחרוזת

כדי להגדיר את ה-webhook של שליחת פרטי החזר כספי על תשלום במזומן בעת המסירה לרכיב הזה, מרחיבים את ההוראות.

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

הושלמה

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