הרכיב המוגדר מראש של המבצעים והדילים בודק אם המתקשר הוא משתמש רשום. אם למשתמש יש חשבון רשום, הרכיב יכול לספק מידע על מבצעים ודילים ספציפיים למשתמש. המשתמש יכול גם לקבל פרטים על מבצעים ודילים כלליים או לדווח על בעיות בקוד שובר ספציפי. הרכיב הזה משתמש ברכיב המובנה Alphanumeric collection כדי לאסוף קודי שוברים. הרכיב משתמש גם בגנרטורים כדי לסכם את השיחה, לענות על שאלות נפוצות ולספק פרטים על הצעות.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
מבצעים ודילים כלליים וספציפיים למשתמשים
משתמש הקצה כבר אומת בעבר. המשתמש מבקש את המבצעים האחרונים, והנציג מציג רשימה של מבצעים שרלוונטיים למשתמש. המשתמש שואל כמה שאלות על המבצעים, ואז מבקש מבצעים בקטגוריה ספציפית. הנציג מציג את רשימת המבצעים בקטגוריה. הנציג מציע לשלוח את פרטי המבצע למשתמש, והמשתמש מסרב.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| שלום! רוצה לראות את המבצעים האחרונים שלנו או שנתקלת בבעיות עם קוד שובר ספציפי? | |
| אני רוצה לראות את המבצעים האחרונים | |
| רק כדי לוודא, חיפשת מבצעים. זה נכון? | |
| כן | |
| מצאנו בשבילך את המבצעים הבאים, הנה הפרטים: מבצע 1: 5% הנחה על בגדים, קוד קופון APPARELS5, בתוקף עד 28.3.2024. מבצע 2: 15% הנחה על מצרכים, קוד קופון GROCERY500, בתוקף עד 28.3.2024. מקווים שהמבצעים האלה מעניינים אותך. יש לך שאלות לגבי מבצעים או דילים שאנחנו יכולים לענות עליהן? |
|
| האם יש סכום רכישה מינימלי כדי לקבל את ההטבה על קניית מצרכים? | |
| כן, יש ערך רכישה מינימלי של 10 כדי לקבל 15% הנחה על מצרכים. כדי לממש את המבצע, צריך להשתמש בקוד GROCERY500. המבצע בתוקף עד 28 במרץ 2024. אנחנו מקווים שהפרטים האלה יעזרו לך. יש לך שאלות לגבי מבצעים או דילים שאנחנו יכולים לענות עליהן? |
|
| יש לך מבצעים על מוצרי אלקטרוניקה? | |
| בטח! אלה פרטי המבצעים: מבצע 1: 5% הנחה על מוצרי אלקטרוניקה, קוד קופון ELECTRIC5, בתוקף עד 28 במרץ 2024. מבצע 2: 15% הנחה על מוצרי אלקטרוניקה, קוד קופון ELECTRIC15, בתוקף עד 28 במרץ 2024. אנחנו מקווים שהמידע הזה יעזור לך. יש לך שאלות לגבי מבצעים או דילים שאנחנו יכולים לענות עליהן? |
|
| לא, סיימתי | |
| רוצה לקבל את פרטי המבצע לנייד או לאימייל הרשומים שלך? | |
| לא תודה | |
| תודה שהתקשרת. |
בעיה בקוד שובר
משתמש הקצה כבר אומת בעבר. המשתמש מציין שיש לו בעיה עם קוד שובר. הנציג אוסף את קוד השובר ומספק למשתמש פרטים על מימוש קוד השובר. המשתמש מאשר שיש לו בעיה עם קוד השובר, והנציג שולח פנייה כדי לדווח על הבעיה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| שלום! רוצה לראות את המבצעים האחרונים שלנו או שנתקלת בבעיות עם קוד שובר ספציפי? | |
| יש לי בעיות עם קוד שובר | |
| רק כדי לוודא, אתה מחפש קודי שוברים. זה נכון? | |
| כן | |
| אנחנו מצטערים לשמוע על כך. יש לך אפשרות לשתף את קוד השובר שבו השתמשת? | |
| הנציג אוסף את קוד השובר באמצעות הרכיב המוגדר מראש איסוף אלפאנומרי | |
| קוד המבצע APPARELS5 שמשויך למוצרי הלבשה דורש ערך רכישה מינימלי של 100$ ותקף עד 28 במרץ 2024. צריך לוודא שהתנאים, כמו דרישת הרכישה המינימלית, מתקיימים. המידע הזה עזר לך? |
|
| לא | |
| מה הבעיה שנתקלת בה? אפשר לכתוב משהו כמו "קוד השובר שלי לא עובד" או "הקוד לא עובד באזור שלי". | |
| קוד השובר לא עובד | |
| רק כדי לוודא, הבעיה שציינת לגבי קוד השובר היא שהקוד לא עובד. זה נכון? | |
| כן | |
| פתחנו כרטיס תמיכה כדי לדווח על הבעיה. תודה שהתקשרת. |
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| 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 שמוחזר על ידי ה-webhook של get_coupon_code_details, שמציין שקוד השובר תקף. ערך ברירת המחדל הוא "valid". |
מחרוזת |
| $flow.invalid_coupon_code_status | מציין את הערך של השדה coupon_code_status שמוחזר על ידי ה-webhook של get_coupon_code_details, שמציין שקוד השובר לא תקין. ערך ברירת המחדל הוא "invalid". |
מחרוזת |
| $flow.expired_coupon_code_status | מציין את הערך של השדה coupon_code_status שמוחזר על ידי ה-webhook של get_coupon_code_details, שמציין שפג התוקף של קוד השובר. ערך ברירת המחדל הוא "expired". |
מחרוזת |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה Build.
- לוחצים על הרכיב המיובא בקטע Flows (תהליכים).
- בקטע Pages, לוחצים על Start Page.
- לוחצים על המסלול 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 משמש כדי לספק פרטים על מבצעים ספציפיים למשתמשים על סמך המידע שסופק על ידי ה-webhook של get_offers_details.
פרטי המבצעים והדילים
הגנרטור Offers and deals details משמש כדי לספק פרטים על מבצעים ודילים כלליים על סמך המידע שסופק על ידי webhook של get_offers_details.
המשתמש יכול לשאול על מבצעים בקטגוריה מסוימת או לבקש פרטים נוספים על מבצעים ספציפיים.
שאלות נפוצות בנושא מבצעים ודילים
הגנרטור Offers and deals FAQ משמש לטיפול בשאלות נפוצות שקשורות למבצעים ולדילים.
- יש מבצעים מיוחדים ללקוחות חדשים?
- איך אפשר לקבל התראות על מבצעים קרובים?
- יש מבצעים שזמינים רק בחנות הפיזית או רק באינטרנט?
- באיזו תדירות נוספים מבצעים חדשים לפלטפורמה?
שאלות נפוצות בנושא הנחות וקודי הטבה
ה-Discount and promo code FAQ משמש לטיפול בשאלות נפוצות שקשורות להנחות ולקודי שוברים.
- אפשר להשתמש בקוד הנחה יותר מפעם אחת?
- אפשר להשתמש בכמה הנחות בהזמנה אחת?
- איך מממשים קוד הנחה בקופה?
- מה קורה אם שכחתי להזין קוד הנחה בזמן התשלום?
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. מידע נוסף זמין במאמר הגדרת Webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
פרטי המבצעים
ה-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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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 "קבלת פרטים של קוד שובר" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_offers_and_deals:get_coupon_code_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת הודעה
ה-webhook של prebuilt_components_offers_and_deals:send_message משמש את הרכיב כדי לשלוח הודעה עם פרטי ההצעה לערוץ שהמשתמש בחר.
פרמטרים של בקשות 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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-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.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.