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

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

מגבלות

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

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

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

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

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

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

קלט של משתמשים	התשובה של הסוכן
	האם התקשרת בנוגע להזמנה האחרונה שלך שמספרה מסתיים ב-12375 וכוללת 2 מנורות, 2 מכשירי Pixel ו-10 מוצרים נוספים, שבוצעה בתאריך 2023-11-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 מנורות שבוצעו בתאריך 2023-11-10?
לא
	רוצה להחליף הזמנה נוספת?
כן
	אפשר בבקשה לציין את 5 הספרות האחרונות של מזהה ההזמנה שברצונך להחליף?
12346
	חמש הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 12346. האם זה נכון?
כן
	מעולה, סיימנו לאסוף את מזהה ההזמנה. מצאנו כמה מוצרים שעומדים בדרישות בהזמנה שלך. איזה מוצר ברצונך להחליף? מוצר 1: בקבוק מים של Google, מוצר 2: חולצת טישרט של Google. אפשר להגיד או להזין את מספר המוצר של הפריט שרוצים לבחור, או להגיד 'הבא' כדי לראות עוד מוצרים.
שניים
	כדי לאשר שאתם מעוניינים להחליף את חולצת Google. זה נכון?
כן
	מה הסיבה להחלפה? אפשר לומר משהו כמו: הפריט פגום או לא עובד, יש בעיה במידה או בהתאמה, יש בעיה בהזמנה לא שלמה, יש בעיה בסגנון, הצבע לא נכון או לומר משהו אחר.
בעיה בגודל או בהתאמה
	תודה שציינת את הסיבה להחלפה. מה הגודל שברצונך להחליף אליו? אלה המידות שזמינות: אומרים 1 למידה קטנה. אומרים 2 למידה בינונית. אומרים 3 למידה גדולה. אומרים 4 למידה XL. אומרים 5 למידה XXL.
1
	בשלב האחרון, איך היית רוצה להחליף את המוצר? לדוגמה, אפשר לומר: 'אני רוצה להחליף מוצר בחנות' או 'אני רוצה לתאם איסוף'.
תזמון איסוף
	מעולה. שלחנו תווית משלוח למספר הטלפון ולכתובת האימייל שרשומים בחשבון שלך. צריך להדפיס אותו ולצרף אותו לחבילה. הצוות שלנו ייצור איתך קשר תוך 24 עד 48 שעות כדי לתאם איסוף. אחרי שהפריט יגיע למחסן שלנו, ההחזר הכספי על ההחלפה יופיע בחשבון שלך תוך 3 עד 5 ימי עסקים. המוצר שהוחלף הוא בעל ערך נמוך יותר ואתה זכאי להחזר כספי של 5$. נשמח לדעת לאיפה תרצה לקבל את ההחזר הכספי. למשל, אפשר לומר 'קרדיט בחנות' או 'חשבון מקור'.
זיכוי ב-Store
	תודה שאישרת שברצונך לקבל החזר כספי לארנק. האם ברצונך להחליף הזמנה נוספת?
לא
	תודה שהתקשרת.

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

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

קלט של משתמשים	התשובה של הסוכן
	לא מצאנו מוצרים בהזמנה האחרונה שלך שעומדים בדרישות להחלפה. האם תרצה להחליף מוצרים בהזמנה אחרת?
כן
	אפשר בבקשה לציין את 5 הספרות האחרונות של מזהה ההזמנה שברצונך להחליף?
23487
	5 הספרות האחרונות של מזהה ההזמנה שקיבלנו הן 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 שמוחזר על ידי get_order_details webhook ומציין אמצעי תשלום של תשלום בזמן המסירה (COD). ערך ברירת המחדל הוא "COD".	מחרוזת
$flow.order_payment_mode_store_credit	מציין את הערך של השדה order_payment_mode שמוחזר על ידי get_order_details webhook ומציין אמצעי תשלום של קרדיט בחנות. ערך ברירת המחדל הוא "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. בקטע דפים, לוחצים על דף הפתיחה.
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

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

אימות

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

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

רכיב prebuilt_components_exchange_order:get_order_details webhook משמש לאחזור פרטי הזמנה עבור הזמנה ספציפית.

פרמטרים של בקשות 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 של Get order details (קבלת פרטי הזמנה) לרכיב הזה, מרחיבים את ההוראות.

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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על 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 (קבלת פרטים של הזמנה כפולה) עבור הרכיב הזה, מרחיבים את ההוראות.

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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

קבלת גודל החלפה זמין

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

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

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

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

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

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

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

כדי להגדיר את ה-webhook של Get available exchange size (קבלת גודל החלפה זמין) עבור הרכיב הזה, מרחיבים את ההוראות.

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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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 של Get product exchange availability (קבלת נתוני זמינות להחלפת מוצרים) עבור הרכיב הזה, מרחיבים את ההוראות.

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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

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

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

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

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

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

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

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

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

כדי להגדיר את ה-webhook של Get store details (קבלת פרטים מהחנות) לרכיב הזה, מרחיבים את ההוראות.

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

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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-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. בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
10. בודקים את הגדרות האימות ומעדכנים אותן לפי הצורך.
11. לוחצים על Save.

הושלמה

הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.