הרכיב המוגדר מראש להחזרות ולהחזרים כספיים בודק את רמת האימות של המשתמש. אחרי שהמשתמש מאומת, הרכיב מספק מידע על ההזמנות האחרונות או הקודמות של המשתמש. המשתמש יכול לבחור להחזיר כמה פריטים בהזמנה ולבחור אפשרויות, כולל שיטות להחזר כספי ולהחזרת פריטים. הרכיב הזה משתמש ברכיב המובנה אימות קמעונאי כדי לאמת משתמשים. הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה ולענות על שאלות נפוצות.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
החזרת מוצר בודד לחנות
משתמש הקצה כבר אומת בעבר. הנציג מאשר אילו פריטים מההזמנה האחרונה צריך להחזיר ומברר מה הסיבה להחזרה. המשתמש בוחר להחזיר את הפריטים בחנות, והנציג מספק רשימה של החנויות הקרובות ביותר. המשתמש בוחר חנות, והנציג יוצר תווית משלוח שנשלחת לערוצים הרשומים של המשתמש.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם השיחה שלך קשורה להזמנה האחרונה שלך, שמספרה מסתיים ב-12345, שכוללת 2 מנורות ובוצעה ב-10 בנובמבר 2023? | |
| כן | |
| רק כדי לוודא, אתה רוצה להחזיר את המנורה של Google. זה נכון? | |
| כן | |
| אנחנו רואים שהכמות הזמינה של המוצר שבחרת היא 2. צריך לציין את כמות המוצרים שרוצים להחזיר. | |
| שתיים | |
| צריך לציין את הסיבה להחזרה. אפשר לומר משהו כמו: הפריט פגום או לא פועל, כבר לא צריך אותו, בעיה במידה או בהתאמה, נשלח פריט שגוי, הפריט הגיע מאוחר מדי, נקנה בטעות או לומר משהו אחר. | |
| אחרים | |
| ציינו את הסיבה להחזרה. | |
| איכות ירודה | |
| רק כדי לוודא, הסיבה להחזרה היא איכות ירודה. זה נכון? | |
| כן | |
| צריך לציין לאן לשלוח את ההחזר הכספי. אפשר לומר משהו כמו "זיכוי ב-Store" או "חשבון מקור". | |
| חשבון המקור | |
| תודה שאישרת שברצונך לקבל את ההחזר הכספי לאמצעי התשלום המקורי. כשלב אחרון, איך ברצונך להחזיר את המוצר? אפשר לכתוב משהו כמו: החזרה בחנות, מסירה במיקום או תזמון איסוף. |
|
| החזרה בחנות | |
| בואו נחפש חנות בסביבה שלכם. | |
| הנציג אוסף את המיקוד באמצעות הרכיב המוגדר מראש איסוף מיקוד | |
| זו רשימת המיקומים שקרובים למיקוד שהזנת. כתובת 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 שמראה שהמשתמש בחר בסיבת ההחזרה "אחר". ערך ברירת המחדל הוא "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 שמוחזר על ידי ה-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_return_refund_mode_of_refund שמציין שהמשתמש בחר לקבל החזר כספי לחשבון המקור שלו. ערך ברירת המחדל הוא source_account. |
מחרוזת |
| $flow.order_return_location_scheduled_for_pickup | מציין את הערך של הישות prebuilt_components_exchange_order_location שמראה שהמשתמש בחר לתזמן איסוף של ההחזרה. ערך ברירת המחדל הוא scheduled_for_pickup. |
מחרוזת |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages, לוחצים על Start Page.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route, עורכים את הערכים של Parameter Presets לפי הצורך.
- לוחצים על 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 משמש ליצירת סיכום אחרי השיחה שמתאר את השיחה שבה טיפל הרכיב.
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. מידע נוסף זמין במאמר הגדרת Webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
אימות
אם לא הגדרתם בעבר שירותים חיצוניים שנדרשים לאימות, תצטרכו להגדיר אותם כדי לאפשר אימות של משתמשים ברכיב הזה. הוראות מפורטות זמינות במאמר הגדרת webhook לאימות קמעונאי.
קבלת פרטי ההזמנה
הרכיב משתמש ב-webhook prebuilt_components_return_refund:get_order_details כדי לאחזר פרטים של הזמנה ספציפית.
פרמטרים של בקשות 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 "קבלת פרטי הזמנה" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_return_refund: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_return_refund:get_store_details משמש את הרכיב כדי לאחזר את רשימת החנויות שנמצאות בקרבת המיקוד שהמשתמש סיפק.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.zip_code | מיקוד לחיפוש חנויות בסביבה. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| store_id | רשימה של מזהי חנויות. | רשימה (מחרוזת) |
| store_address | רשימה של כתובות החנויות שתואמות לכל רכיב של store_id. |
רשימה (מחרוזת) |
כדי להגדיר את ה-webhook "קבלת פרטי החנות" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_return_refund:get_store_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
פרטי החזרה בדואר
הרכיב משתמש ב-webhook של prebuilt_components_return_refund:post_return_details כדי לשלוח החזרה.
פרמטרים של בקשות 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 של פרטי החזרת הפוסט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_return_refund:post_return_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת פרטי החזר כספי על תשלום במזומן בעת המסירה
הרכיב משתמש ב-webhook prebuilt_components_return_refund:send_COD_refund_information כדי לשלוח למשתמש מידע על תשלום שקשור להחזרה.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.order_id | מזהה ההזמנה שעבורה רוצים לפתוח כרטיס תמיכה. | מחרוזת |
| $flow.channel | הערוץ הספציפי שאליו יישלח המידע. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_channel_email_phone. כברירת מחדל, יש תמיכה ב-phone וב-email. |
מחרוזת |
כדי להגדיר את ה-webhook של שליחת פרטי החזר כספי על תשלום במזומן בעת המסירה לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_return_refund:send_COD_refund_information.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.