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

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

מגבלות

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

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

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

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

החזרת מוצר בודד לחנות

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

קלט של משתמשים	התשובה של הסוכן
	האם התקשרת לגבי ההזמנה האחרונה שלך שמספרה מסתיים ב-12345 וכוללת 2 מנורות שבוצעו בתאריך 2023-11-10?
כן
	כדי לאשר שאתם מעוניינים להחזיר את מנורת 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. כדי לבחור כתובת, צריך להגיד או להזין את המספר שלה. כדי לראות עוד כתובות של חנויות, צריך להגיד 'הבא'.
1
	כדי לאשר, בחרת ב-Google Texas, ‏ 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. זה נכון?
כן
	מעולה. שלחנו תווית משלוח ומספר כרטיס למספר הטלפון ולכתובת האימייל שרשומים בחשבון שלך. צריך להדפיס את התווית, לצרף אותה לחבילה ולשלוח את הפריט להחזרה תוך 30 יום. אחרי שהפריט יגיע למחסן שלנו, ההחזר הכספי יופיע בחשבון תוך 3 עד 5 ימי עסקים. הערה: סכום ההחזר הכספי לא יכלול את דמי המשלוח והטיפול. תודה על הפנייה.

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

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

תכונה	פורמט	דוגמה
Flow	[שם הרכיב]	החזרה והחזר כספי
סוג ישות	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_return_refund_mode_of_return
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_return_refund:post_return_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	מציינת את מספר הניסיונות המותרים כשמספקים את חמש הספרות האחרונות של מספר הזמנה. ערך ברירת המחדל הוא 3.	מספר שלם
$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_return_confirm_counter	מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמאשרים את המוצר שנבחר. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_return_reason_counter	מציינת את מספר הניסיונות החוזרים שמותרים כשמאשרים את הסיבה להחזרה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.order_product_return_reason_others	מציין את הערך של prebuilt_components_return_refund_reason entity שמציין שהמשתמש בחר באפשרות 'אחר' כסיבה להחזרה. ערך ברירת המחדל הוא "others".	מחרוזת
$flow.max_retry_select_quantity	מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים את כמות המוצרים להחזרה. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_store_display_counter	מציין את המספר המקסימלי של חנויות שיוצגו בתור אחד. ערך ברירת המחדל הוא 1.	מספר שלם
$flow.max_store_display	מציין את המספר המקסימלי של חנויות שיוצגו במהלך השיחה. ערך ברירת המחדל הוא 10.	מספר שלם
$flow.max_retry_store_number_counter	מציין את המספר המקסימלי של ניסיונות חוזרים שמותרים כשבוחרים חנות. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_store_selection	מציינת את מספר הניסיונות החוזרים שמותרים כשמאשרים את בחירת החנות. ערך ברירת המחדל הוא 2.	מספר שלם
$flow.max_retry_another_zip_code	מציינת את המספר המקסימלי של ניסיונות חוזרים שמותרים כשמזינים מיקוד. ערך ברירת המחדל הוא 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_return_refund_mode_of_refund, שמציין שהמשתמש בחר לקבל החזר לחשבון המקור שלו. ערך ברירת המחדל הוא source_account.	מחרוזת
$flow.order_return_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_return_refund:get_order_details webhook משמש לאחזור פרטי הזמנה עבור הזמנה ספציפית.

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

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

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

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

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

שם הפרמטר	תיאור	פורמט הפלט
order_date	התאריך שבו בוצעה ההזמנה, בפורמט YYYY-MM-DD.	מחרוזת
order_product_count	מספר המוצרים הייחודיים בהזמנה.	מספר שלם
order_payment_mode	מציין את אמצעי התשלום שבו השתמשתם כשביצעתם את ההזמנה.	מחרוזת
returnable_product_id	רשימה של מזהי מוצרים שניתן להחזיר בהזמנה.	רשימה (מחרוזת)
returnable_product_name	רשימה של שמות מוצרים שניתן להחזיר בהזמנה.	רשימה (מחרוזת)
returnable_product_brand_name	רשימה של שמות מותגים של מוצרים שאפשר להחזיר בהזמנה.	רשימה (מחרוזת)
returnable_product_quantity	רשימת הכמויות של המוצרים שניתן להחזיר בהזמנה.	רשימה (מחרוזת)

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

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

פרטי ההחזרה

רכיב prebuilt_components_return_refund:post_return_details webhook משמש לשליחת בקשה להחזרת מוצר.

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

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

שם הפרמטר	תיאור	פורמט קלט
$session.params.phone_number	מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש.	מחרוזת
$flow.order_id	מזהה ההזמנה שרוצים לשלוח לגביה כרטיס.	מחרוזת
$flow.return_product_id_list	רשימה של מזהי מוצרים שהמשתמש רוצה להחזיר.	רשימה (מחרוזת)
$flow.return_product_quantity_list	רשימה של כמויות המוצרים שהמשתמש רוצה להחזיר, בהתאמה לכל רכיב ב-$flow.return_product_id_list.	רשימה (מחרוזת)
$flow.return_reason_list	רשימה של סיבות להחזרה של כל מוצר שהוחזר, בהתאמה לכל רכיב ב-$flow.return_product_id_list.	רשימה (מחרוזת)
$flow.order_return_location	המצב שנבחר להחזרה. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_exchange_order_location.	מחרוזת
$flow.order_return_store_id	מזהה החנות שנבחרה על ידי המשתמש להחזרת מוצר.	מחרוזת
$flow.order_refund_mode	מצב התשלום להחזר כספי. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_return_refund_mode_of_return. אם לא נדרש החזר כספי, הערך הוא null.	מחרוזת

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

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

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

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

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

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

רכיב prebuilt_components_return_refund:send_COD_refund_information webhook משמש לשליחת פרטי תשלום שקשורים להחזר כספי למשתמש.

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

הושלמה

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