הרכיב המובנה של המבצעים והדילים בודק אם המתקשר הוא משתמש רשום. אם למשתמש יש חשבון רשום, הרכיב יכול לספק מידע על מבצעים ועסקאות שרלוונטיים למשתמש. המשתמש יכול גם לקבל פרטים על מבצעים והנחות כלליים, או לדווח על בעיות בקוד שובר ספציפי. הרכיב הזה משתמש ברכיב המובנה Alphanumeric collection כדי לאסוף קודי שוברים. הרכיב משתמש גם בגנרטורים לסיכום השיחה, לשאלות נפוצות ולפרטי המבצע.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוכנים מראש, יש לרכיב המוכן מראש הזה את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לתיבות דו-שיח
בדוגמאות הבאות לדיאלוגים מוצגים תרחישים נפוצים שמטופלים על ידי הרכיב המובנה הזה. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשקוראים לרכיב באמצעות טלפוניה, מה שמפעיל את כוונת הפתיחה שמוגדרת כברירת מחדל ואת התגובה הראשונה של הנציג בתחילת השיחה.
מבצעים ודילים ספציפיים למשתמשים וכלליים
משתמש הקצה אומת בעבר. המשתמש מבקש לראות את ההצעות האחרונות שלו, והסוכן מציג רשימה של הצעות שרלוונטיות למשתמש. המשתמש שואל כמה שאלות על המבצעים, ואז מבקש מבצעים בקטגוריה ספציפית. הסוכן מציג את רשימת המוצרים בקטגוריה. הסוכן מציע לשלוח את פרטי המבצע למשתמש והמשתמש מסרב.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| שלום! האם תרצה לעיין במבצעים האחרונים שלנו או שנתקלת בבעיות בקוד שובר ספציפי? | |
| אני רוצה לראות את המבצעים האחרונים | |
| כדי לוודא, אנחנו רוצים לדעת אם אתה מחפש מבצעים. זה נכון? | |
| כן | |
| מצאנו בשבילך את המבצעים הבאים: מבצע 1: 5% הנחה על ביגוד, קוד המבצע APPARELS5, בתוקף עד 28 במרץ 2024. מבצע 2: 15% הנחה על מצרכים, קוד המבצע GROCERY500, בתוקף עד 28 במרץ 2024. מקווה שהמבצעים האלה יעניינו אותך. יש לך שאלות לגבי מבצעים או דילים? |
|
| האם יש סכום רכישה מינימלי למימוש המבצע על מוצרי המכולת? | |
| כן, יש ערך רכישה מינימלי של 10 כדי לקבל את ההנחה של 15% על מוצרי מכולת. כדי לקבל את ההטבה, צריך להזין את הקוד GROCERY500. ההטבה תקפה עד 28 במרץ 2024. אנחנו מקווים שנוכל לספק לך את הפרטים שדרושים לך. יש לך שאלות לגבי מבצעים או דילים? |
|
| יש לך מבצעים על מוצרי אלקטרוניקה? | |
| בטח. הנה פרטי המבצע: מבצע 1: 5% הנחה על מוצרי אלקטרוניקה, קוד המבצע ELECTRIC5, בתוקף עד 28 במרץ 2024. מבצע 2: 15% הנחה על מוצרי אלקטרוניקה, קוד המבצע ELECTRIC15, בתוקף עד 28 במרץ 2024. מקווים שהצלחנו לספק לך את הפרטים שחיפשת. יש לך שאלות לגבי מבצעים או דילים? |
|
| לא, סיימתי | |
| רוצה לקבל פרטים על המבצעים בנייד או באימייל שרשמת? | |
| לא תודה | |
| תודה שהתקשרת. |
בעיה בקוד שובר
משתמש הקצה אומת בעבר. למשתמש יש בעיה עם קוד שובר. הנציג אוסף את קוד השובר ומספק למשתמש פרטים על מימוש קוד השובר. המשתמש מאשר שיש לו בעיה עם קוד השובר והנציג שולח כרטיס לדיווח על הבעיה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| שלום! האם תרצה לעיין במבצעים האחרונים שלנו או שנתקלת בבעיות בקוד שובר ספציפי? | |
| נתקלתי בבעיות עם קוד שובר | |
| כדי לוודא, אתה מחפש קודי שוברים. זה נכון? | |
| כן | |
| אנחנו מצטערים לשמוע על כך. אפשר בבקשה לקבל את קוד השובר שבו השתמשת? | |
| הנציג אוסף את קוד השובר באמצעות הרכיב המובנה Alphanumeric collection | |
| קוד המבצע APPARELS5 שמשויך למוצרי הלבשה מחייב ערך רכישה מינימלי של 100$ והוא תקף עד 2024-03-28. עליך לוודא שמתקיימים התנאים, כמו דרישת ערך הרכישה המינימלי. האם המידע הזה מועיל לך? |
|
| לא | |
| באיזו בעיה נתקלת? למשל, אפשר לומר שקוד השובר לא עובד, או שהקוד לא עובד באזור שלכם. | |
| קוד השובר לא פועל | |
| לצורך אישור, הבעיה שציינת היא שקוד השובר לא פועל. זה נכון? | |
| כן | |
| פתחנו כרטיס תמיכה כדי לדווח על הבעיה שנתקלת בה. תודה שהתקשרת. |
מוסכמות למתן שמות
הרכיב המובנה הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | מבצעים ודילים |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע את ההתנהגות של הרכיב. צריך להגדיר פרמטרים בהיקף של זרימה בדף ההתחלה של הרכיב. אפשר להגדיר פרמטרים ברמת הסשן באמצעות זרימת שיחות או בדף הפתיחה של הרכיב הזה.
הרכיב המובנה הזה מקבל את פרמטרי הקלט הבאים:
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | (אופציונלי) מספר הטלפון המקומי של המשתמש, ללא קידומת המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
הרכיב המובנה מראש הזה מאפשר להגדיר את הפרמטרים האופציונליים הבאים כדי לקבוע את ההתנהגות של הרכיב, כולל ניסיונות חוזרים.
| שם הפרמטר | תיאור | פורמט |
|---|---|---|
| $flow.max_retry_concern_type | מציין את מספר הניסיונות החוזרים שמותרים כשבוחרים אם המשתמש רוצה לשמוע מבצעים או לדווח על בעיה בקוד קופון. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_offers_category | מציינת את מספר הניסיונות החוזרים שמותרים כשמספקים קטגוריה כדי לשמוע הצעות מחיר. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_another_coupon_code | מציינים את מספר הניסיונות החוזרים שמותרים כשמספקים את קוד השובר הספציפי שגורם לבעיה אצל המשתמש. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_coupon_code_issue_counter | מציין את מספר הניסיונות החוזרים שמותרים כשמדווחים על בעיה שנתקלים בה עם קוד שובר. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.max_retry_message_confirm_channel | מציין את מספר הניסיונות החוזרים שמותרים כשמספקים ערוץ לקבלת פרטי ההצעה. ערך ברירת המחדל הוא 2. |
מספר שלם |
| $flow.valid_coupon_code_status | מציין את הערך של השדה coupon_code_status שמוחזר על ידי get_coupon_code_details webhook ומציין שקוד השובר תקף. ערך ברירת המחדל הוא "valid". |
מחרוזת |
| $flow.invalid_coupon_code_status | מציין את הערך של השדה coupon_code_status שמוחזר על ידי get_coupon_code_details webhook ומציין שקוד השובר לא תקין. ערך ברירת המחדל הוא "invalid". |
מחרוזת |
| $flow.expired_coupon_code_status | הערך של השדה coupon_code_status שמוחזר על ידי get_coupon_code_details webhook, שמציין שתוקף קוד השובר פג. ערך ברירת המחדל הוא "expired". |
מחרוזת |
כדי להגדיר את פרמטרי הקלט של הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- בוחרים בכרטיסייה Build (פיתוח).
- לוחצים על הרכיב המיובא בקטע Flows (תהליכי עבודה).
- בקטע דפים, לוחצים על דף הבית.
- לוחצים על המסלול true בדף הפתיחה.
- בחלון Route (מסלול), עורכים את הערכים של Parameter Presets (הגדרות קבועות מראש של פרמטרים) לפי הצורך.
- לוחצים על Save.
פרמטרים של פלט
פרמטרים של פלט הם פרמטרים של סשן שיישארו פעילים אחרי היציאה מהרכיב. הפרמטרים האלה מכילים מידע חשוב שנאסף על ידי הרכיב. הרכיב המובנה הזה מספק ערכים לפרמטרים הבאים של הפלט:
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| 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 משמש ליצירת סיכום של השיחה אחרי שהיא מסתיימת, שמתאר את השיחה שהרכיב טיפל בה.
שאלות נפוצות כלליות
הגנרטור General FAQ משמש לטיפול בשאלות נפוצות שקשורות להנחות, למבצעים, לרכישות ולמועדוני לקוחות.
- האם אפשר להחזיר מוצרים שנרכשו במבצע אם מתחרטים?
- האם אפשר לקבל דוגמיות או מתנות בחינם ברכישה של מוצרים מסוימים?
- האם אתם מציעים התאמות מחירים אם הפריט שקניתי מוצע למכירה מאוחר יותר?
- האם יש מגבלת זמן למימוש תגמולים ממועדון לקוחות?
פרטים ספציפיים על המבצע למשתמש
הגנרטור User-specific offer details משמש כדי לספק פרטים על מבצעים ספציפיים למשתמשים על סמך המידע שסופק על ידי get_offers_details
webhook.
פרטים על מבצעים ודילים
הגנרטור Offers and deals details משמש כדי לספק פרטים על מבצעים ועסקאות כלליים על סמך המידע שסופק על ידי get_offers_details
ה-webhook.
המשתמש יכול לשאול על מבצעים בקטגוריה מסוימת או לבקש פרטים נוספים על מבצעים ספציפיים.
שאלות נפוצות בנושא מבצעים ודילים
Offers and deals FAQ הגנרטור משמש לטיפול בשאלות נפוצות שקשורות למבצעים.
- יש מבצעים מיוחדים ללקוחות חדשים?
- איך אפשר לקבל הודעות על מבצעים קרובים?
- האם יש מבצעים שזמינים רק בחנות או רק אונליין?
- באיזו תדירות נוספים מבצעים חדשים לפלטפורמה?
שאלות נפוצות בנושא הנחות וקודי הטבה
ה-Discount and promo code FAQ משמש לטיפול בשאלות נפוצות שקשורות להנחות ולקודי שוברים.
- האם אפשר להשתמש בקוד הנחה יותר מפעם אחת?
- האם אפשר להשתמש בכמה הנחות בהזמנה אחת?
- איך מממשים קוד הנחה במהלך התשלום?
- מה קורה אם שכחתי להזין קוד הנחה במהלך התשלום?
הגדרה בסיסית
כדי להגדיר את הרכיב המובנה הזה:
- מייבאים את הרכיב שנוצר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו עם הגדרה שמתארת את השירותים החיצוניים. אפשר לעיין במאמר בנושא הגדרת webhook.
הגדרת webhook
כדי להשתמש ברכיב הזה, תצטרכו להגדיר את הוויבהוקים הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים שלכם.
קבלת פרטי המבצעים
רכיב ה-webhook prebuilt_components_offers_and_deals:get_offers_details משמש לאחזור פרטים על מבצעים ספציפיים למשתמשים ועל מבצעים כלליים.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון שאליו נשלחים פרטי המבצע. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| active_category | רשימה של קטגוריות מבצעים שזמינות למשתמש. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_offers_and_deals_category. |
רשימה (מחרוזת) |
| user_email | כתובת האימייל שרשומה בחשבון שציינת, שדרכה נשלחים פרטי המבצע. | מחרוזת |
| user_offer | רשימה של פרטי מבצע ספציפיים למשתמש. כל רכיב ברשימה מייצג מוצר יחיד, עם צמדי מפתח/ערך שמתארים מאפיינים שונים של המוצר, לדוגמה {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}. |
רשימה (אובייקט) |
| all_offers | רשימה של פרטים כלליים על המבצע. כל רכיב ברשימה מייצג מבצע יחיד, באותו פורמט של השדה user_offer. |
רשימה (אובייקט) |
כדי להגדיר את ה-webhook של Get offers details (קבלת פרטי מבצעים) עבור הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook prebuilt_components_offers_and_deals:get_offers_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת פרטים על קוד שובר
רכיב ה-webhook prebuilt_components_offers_and_deals:get_coupon_code_details משמש לאחזור פרטים על קוד שובר ספציפי שמשתמש דיווח על בעיות שקשורות אליו.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $flow.coupon_code | קוד השובר שאליו רוצים לאחזר פרטים. | מחרוזת |
| $session.params.phone_number | מספר הטלפון שמשויך לחשבון של המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מתגובת ה-API כדי שהרכיב יוכל להשתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| offer_id | מזהה המוצר של קוד השובר. | מחרוזת |
| offer_category_name | קטגוריה של קוד השובר. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_offers_and_deals_category. |
מחרוזת |
| coupon_code_status | הסטטוס של קוד השובר. הערכים החוקיים מוגדרים על ידי פרמטרי הקלט $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status ו-$flow.valid_coupon_code_status. |
מחרוזת |
| valid_until | התאריך שעד אליו קוד השובר בתוקף, בפורמט YYYY-MM-DD. |
מחרוזת |
| minimum_order_value | מחיר המינימום להזמנה שנדרש לשימוש בקוד השובר. | מחרוזת |
כדי להגדיר את ה-webhook של Get coupon code details (קבלת פרטים של קוד שובר) עבור הרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook prebuilt_components_offers_and_deals:get_coupon_code_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת הודעה
רכיב ה-prebuilt_components_offers_and_deals:send_message webhook משמש לשליחת הודעה עם פרטי המבצע לערוץ שנבחר על ידי המשתמש.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.confirmation_channel | הערוץ שהמשתמש בחר לקבל בו את פרטי המבצע. הערכים התקינים מוגדרים על ידי הישות prebuilt_components_channel_email_phone. |
מחרוזת |
כדי להגדיר את ה-webhook של שליחת ההודעה לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook של prebuilt_components_offers_and_deals:send_message.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
פתיחת כרטיס
רכיב ה-webhook prebuilt_components_offers_and_deals:raise_ticket משמש לשליחת כרטיס תמיכה לדיווח על בעיה של משתמש עם קוד שובר.
פרמטרים של בקשות API
הפרמטרים הבאים מסופקים על ידי הרכיב כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט קלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.coupon_code | קוד השובר שעליו המשתמש דיווח על בעיה. | מחרוזת |
| $flow.offer_id | מזהה המוצר של קוד השובר שצוין. | מחרוזת |
| $flow.coupon_code_issue | הבעיה שצוינה על ידי המשתמש לגבי קוד השובר. | מחרוזת |
כדי להגדיר את ה-webhook של יצירת כרטיס, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים ב-webhook rebuilt_components_offers_and_deals:raise_ticket.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שאותו רוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-Webhook.
- בודקים ומעדכנים את הגדרות התגובה כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הרכיב צריך אותם כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
הסוכן ורכיבי ה-webhook שלו אמורים להיות מוגדרים עכשיו ומוכנים לבדיקה.