הרכיב המוגדר מראש להרשמה לכרטיס אשראי מאפשר ללקוחות חדשים וקיימים להגיש בקשה לכרטיס אשראי חדש.
הרכיב מתחיל באיסוף מספר הטלפון של משתמש הקצה כדי לזהות אם מדובר בלקוח חדש או קיים. אם מדובר במשתמש חדש, הרכיב יאסוף את הפרטים הנדרשים, כולל ההכנסה החודשית וקטגוריית ההוצאות או ההטבות בכרטיס שהמשתמש מבקש. אחרי שכל המידע הנדרש נאסף, הרכיב קובע שיחה חוזרת ומספק למשתמש את מספר הבקשה.
אם מדובר בלקוח קיים, הרכיב יאחזר את פרטי המשתמש הרשום ויציג למשתמש הקצה את אפשרויות הכרטיסים הזמינות על סמך ההעדפות שלו והמידע שאוחזר, כולל דירוג האשראי שלו. אחרי שהלקוח בוחר אפשרות לכרטיס, הרכיב שולח קישור להשלמת תהליך ההרשמה דרך ערוצים רשומים, כולל וואטסאפ או SMS.
הרכיב הזה משתמש ברכיבים המוגדרים מראש איסוף מספרי טלפון ואיסוף מיקודים כדי לאסוף ולאמת את פרטי המשתמשים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מובנים, לרכיב המובנה הזה יש את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
השיחות לדוגמה הבאות ממחישות תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הדיאלוגים לדוגמה מדגימים את ההתנהגות כשהרכיב נקרא באמצעות טלפוניה, שמפעילה את כוונת ברירת המחדל לפתיחה ואת התגובה הראשונה של הנציג בתחילת השיחה.
משתמש חדש
הרכיב בודק אם המשתמש מתקשר באמצעות מספר טלפון רשום ומזהה שהוא משתמש חדש. הרכיב אוסף את קטגוריית הכרטיס שהמשתמש רוצה להירשם אליו, וגם מידע לזיהוי המשתמש, כולל מיקוד ומספר טלפון. הרכיב קובע שיחה חוזרת ונותן למשתמש את מספר הבקשה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם אתה לקוח קיים של הבנק שלנו? | |
| אני לא | |
| אנחנו שמחים שברצונך להגיש בקשה לכרטיס אשראי אצלנו. יש לנו מגוון רחב של כרטיסי אשראי שמתאימים לך. כדי שנוכל להציע לך את הכרטיסים הכי טובים, מה ההכנסה החודשית שלך בדולר ארה"ב? |
|
| 5,000 דולר | |
| אילו הוצאות או הטבות מעניינות אותך? יש לנו מגוון אפשרויות, כמו נסיעות, דלק וקניות. | |
| אני אוהב/ת לעשות קניות | |
| התשובה שבחרת שייכת לקטגוריית הקניות. אם רוצים להמשיך, אומרים "כן". | |
| כן | |
| הנציג אוסף את המיקוד של המשתמש באמצעות הרכיב המוגדר מראש איסוף מיקוד | |
| ציינת שהמיקוד הוא 10011, זה נכון? | |
| כן, זה נכון | |
| מעולה, סיימנו לאסוף את המיקוד. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש Telephone number collection | |
| הבנתי. המספר שציינת הוא +1 6502530000, נכון? | |
| כן | |
| מעולה, סיימנו לאסוף את מספר הטלפון. אחד מהנציגים שלנו יתקשר אליך בחזרה לגבי הכרטיסים הרלוונטיים על סמך הקריטריונים שלך. מספר הבקשה שלך הוא 993835. |
לקוח קיים
הרכיב מזהה לקוח רשום באמצעות מספר הטלפון שלו. הרכיב מבקש מידע כמו הקטגוריה וסוג הכרטיס שהמשתמש רוצה להוסיף. אחרי שהפרטים האלה מאומתים, הרכיב מבקש מהלקוח לבחור ערוץ שבו הוא רוצה להשלים את תהליך ההרשמה, ושולח את הקישור לערוץ הרשום של הלקוח.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| אנחנו שמחים שבחרת להמשיך להשתמש במוצרים ובשירותים שלנו. יש לנו מגוון רחב של כרטיסי אשראי שמתאימים לך. אילו הוצאות או הטבות מעניינות אותך? יש לנו מגוון אפשרויות, כמו נסיעות, דלק וקניות. |
|
| אני רוצה כרטיס שאוכל להשתמש בו בחופשה הבאה שלי | |
| התשובה שבחרת שייכת לקטגוריית הנסיעות. אם רוצים להמשיך, אומרים "כן". | |
| כן | |
| יש 3 סוגי כרטיסים שמתאימים לסוג הבקשה שלכם: כרטיס נסיעה פלטינה, כרטיס נסיעה זהב וכרטיס נסיעה קלאסי. רוצה לקבל מידע על כל הכרטיסים או על כרטיס ספציפי? לדוגמה, אם אתם מחפשים כרטיס קלאסי, אתם יכולים להגיד "כרטיס קלאסי". | |
| אפשר לקבל מידע על כרטיס הפלטינה? | |
| בטח, העמלה השנתית על כרטיס פלטינה לנסיעות היא 95 דולר. ההטבות כוללות: 10,000 מיילים במתנה בכל שנה, צבירת מיילים ללא הגבלה (פי 2) על כל הרכישות האחרות, קל לצבור מיילים וקל להשתמש בהם. אפשר למצוא מידע נוסף על ההטבות או הבונוסים באתר שלנו. רוצה להירשם לכרטיס הנסיעות פלטינה? |
|
| כן, אני רוצה לעשות את זה | |
| נשתף קישור עם השלבים של תהליך ההרשמה. רוצה שנשלח את פרטי הכרטיס האלה למספר הטלפון הנייד שלך ב-SMS או בוואטסאפ? | |
| אני מעדיף/ה SMS | |
| בסדר, אנחנו שולחים את הקישור למספר הטלפון הנייד הרשום שלך. הפעולה הזו יכולה להימשך כמה שניות. אפשר לבקש ממך לאשר שקיבלת את הקישור? (צריך לענות ב"כן" או "לא"). | |
| הבנתי | |
| מעולה, עכשיו אפשר לפתוח את הקישור ולבדוק את פרטי ההרשמה של הכרטיס. אחרי שהנתונים יושלמו, נתחיל בתהליך ההנפקה של הכרטיס החדש ונשלח אותו לכתובת הנוכחית שלך. |
הכחשת מידע
המשתמש מסרב לספק את המידע שנדרש כדי להירשם לכרטיס אשראי. הרכיב נסגר ומוצגת הודעת שגיאה.
| קלט של משתמשים | התשובה של הסוכן |
|---|---|
| האם אתה לקוח קיים של הבנק שלנו? | |
| לא, אני לא | |
| אנחנו שמחים שברצונך להגיש בקשה לכרטיס אשראי אצלנו. יש לנו מגוון רחב של כרטיסי אשראי שמתאימים לך. כדי שנוכל להציע לך את הכרטיסים הכי טובים, מה ההכנסה החודשית שלך בדולר ארה"ב? |
|
| אני לא רוצה למסור את המידע הזה | |
| תודה שהתקשרת. אנחנו מצטערים, אבל אין לנו אפשרות להמשיך בלי המידע שביקשנו. |
מוסכמות למתן שמות
הרכיב המוכן מראש הזה משתמש במוסכמות הבאות למתן שמות:
| תכונה | פורמט | דוגמה |
|---|---|---|
| Flow | [שם הרכיב] | רישום כרטיס אשראי |
| כוונה ספציפית לרכיב | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_cc_enroll_collect_cardtype |
| סוג ישות | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_cc_enroll_expense_category |
| תגובה לפעולה מאתר אחר (webhook) | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_credit_card_enrollment:get_available_card |
פרמטרים של קלט
פרמטרים של קלט הם פרמטרים שמשמשים להגדרת התנהגויות מסוימות של הרכיב. הפרמטרים ישמשו תנאי אחד או יותר בתהליך כדי לקבוע איך הרכיב צריך להתנהג. צריך להגדיר פרמטרים ברמת התהליך בדף ההתחלה של הרכיב, כמו שמתואר בהמשך. אפשר להגדיר פרמטרים ברמת הסשן באמצעות תהליך קריאה או בדף ההתחלה של הרכיב הזה.
הרכיב המוכן לשימוש הזה מקבל את הפרמטרים הבאים של קלט:
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.auth_level | (אופציונלי) מציין את רמת האימות הנוכחית של משתמש הקצה. | מספר שלם |
| $session.params.phone_number | (אופציונלי) מספר הטלפון של משתמש הקצה. אם הפרמטר הזה לא צוין, הרכיב יאסוף את מספר הטלפון ממשתמש הקצה. | מחרוזת |
| $flow.max_retry_count | מציין את מספר הניסיונות החוזרים שניתנים למשתמש הקצה. ערך ברירת המחדל הוא 3. |
מספר שלם |
| $flow.currency_name | מציינת את המטבע הצפוי כשנאספים פרטי ההכנסה החודשית. ערך ברירת המחדל הוא "USD". |
מחרוזת |
כדי להגדיר את הפרמטרים של הקלט לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף 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. |
מחרוזת |
הגדרה בסיסית
כדי להגדיר את הרכיב המוכן מראש:
- מייבאים את הרכיב שהוגדר מראש.
- מגדירים את ה-webhooks הגמישים שסופקו, באמצעות הגדרה שמתארת את השירותים החיצוניים שלכם. בהמשך מוסבר איך מגדירים webhook.
הגדרת תגובה לפעולה מאתר אחר (webhook)
כדי להשתמש ברכיב הזה, צריך להגדיר את ה-webhooks הגמישים שכלולים בו כדי לאחזר את המידע הדרוש מהשירותים החיצוניים.
קבלת פרטי החשבון
הרכיב משתמש ב-webhook prebuilt_components_credit_card_enrollment:get_account_details כדי לאחזר את פרטי החשבון של המשתמש, אם קיים חשבון.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| account_count | מספר החשבונות שמשויכים למספר הטלפון הרשום. | מספר שלם |
| credit_score | דירוג האשראי הרשום של המשתמש. | מספר שלם |
כדי להגדיר את ה-webhook של קבלת פרטי החשבון לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:get_account_details.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת מספר הכרטיסים
ה-webhook prebuilt_components_credit_card_enrollment:get_card_count משמש את הרכיב כדי לאחזר את מספר כרטיסי האשראי שמשויכים לחשבונות של משתמש רשום.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| card_count | המספר הכולל של כרטיסי האשראי בחשבונות של משתמש רשום. | מספר שלם |
כדי להגדיר את ה-webhook של Get card count לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:get_card_count.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת הכרטיסים הזמינים
ה-webhook prebuilt_components_credit_card_enrollment:get_available_card משמש את הרכיב כדי לאחזר את רשימת הכרטיסים שזמינים למשתמש בקטגוריה ספציפית, על סמך דירוג האשראי של המשתמש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.expense_category | קטגוריית ההוצאות שהמשתמש בחר להירשם אליה. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_cc_enroll_expense_category. כברירת מחדל, יש תמיכה ב-fuel, ב-shopping וב-travel. |
מחרוזת |
| $flow.credit_score | דירוג האשראי של המשתמש, שאוחזר על ידי הרכיב באמצעות ה-webhook Get account details. | מספר שלם |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| available_card_names | רשימת הכרטיסים שזמינים למשתמש, לדוגמה ["gold shopping card","classic shopping card"]. |
רשימה (מחרוזת) |
| cards_count | מספר הכרטיסים שזמינים למשתמש. | מספר שלם |
כדי להגדיר את ה-webhook "קבלת הכרטיסים הזמינים" לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:get_available_card.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
קבלת פרטי הכרטיס שנבחר
ה-webhook של prebuilt_components_credit_card_enrollment:get_selected_card משמש את הרכיב כדי לאחזר את העמלות השנתיות וההטבות של הכרטיס שנבחר.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $flow.card_type | סוג הכרטיס שהמשתמש בחר להוסיף. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_cc_enroll_card_type. כברירת מחדל, יש תמיכה ב-classic, ב-gold וב-platinum. |
מחרוזת |
| $flow.expense_category | קטגוריית ההוצאות שהמשתמש בחר להירשם אליה. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_cc_enroll_expense_category. כברירת מחדל, יש תמיכה ב-fuel, ב-shopping וב-travel. |
מחרוזת |
| $flow.credit_score | דירוג האשראי של המשתמש, שאוחזר על ידי הרכיב באמצעות ה-webhook Get account details. | מספר שלם |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| selected_card_benefits | מידע על ההטבות בכרטיס שנבחר. | מחרוזת |
| selected_card_annual_fee | העמלה השנתית של הכרטיס שנבחר. | מספר שלם |
| selected_card_name | השם של הכרטיס שנבחר. | מחרוזת |
כדי להגדיר את ה-webhook "קבלת פרטי הכרטיס שנבחר" לרכיב הזה, מרחיבים את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:get_selected_card.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת בקשת הרשמה
הרכיב משתמש ב-webhook prebuilt_components_credit_card_enrollment:submit_enroll כדי ליצור בקשה לרישום כרטיס על סמך ההעדפות ופרטי המשתמש החדש.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.zipcode | המיקוד שהמשתמש סיפק. | מחרוזת |
| $flow.monthly_salary | המשכורת החודשית שהמשתמש ציין. | מספר שלם |
| $flow.currency_name | המטבע של המשכורת החודשית, שמוגדר בפרמטרים של הקלט של הרכיב. פרמטרים של קלט | מחרוזת |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| request_number | מספר הבקשה לרישום הכרטיס שנרשם בהצלחה. | מספר שלם |
כדי להגדיר את ה-webhook של Submit enrollment request לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:submit_enroll.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
שליחת הודעה
הרכיב משתמש ב-webhook של prebuilt_components_credit_card_enrollment:send_message כדי לשלוח הודעה עם קישור להשלמת ההרשמה של כרטיס האשראי ללקוחות קיימים.
פרמטרים של בקשות API
הרכיב מספק את הפרמטרים הבאים כקלט לבקשת ה-API.
| שם הפרמטר | תיאור | פורמט הקלט |
|---|---|---|
| $session.params.phone_number | מספר הטלפון המקומי של המשתמש, ללא קוד המדינה, שמשמש לזיהוי המשתמש. | מחרוזת |
| $flow.channel | הערוץ שהמשתמש בחר לקבל בו את ההודעה. הערכים התקינים מוגדרים על ידי הישות המותאמת אישית prebuilt_components_cc_enroll_channel. כברירת מחדל, יש תמיכה ב-SMS וב-WhatsApp. |
מחרוזת |
| $flow.selected_card_name | רשימת הכרטיסים שהמשתמש בחר, לדוגמה ["gold shopping card","classic shopping card"]. |
רשימה (מחרוזת) |
פרמטרים של תגובה מה-API
הפרמטרים הבאים נשלפים מהתגובה מה-API כדי שהרכיב ישתמש בהם.
| שם הפרמטר | תיאור | פורמט הפלט |
|---|---|---|
| message_sent | מציין אם ההודעה נשלחה בהצלחה לערוץ שהמשתמש ציין. | בוליאני |
כדי להגדיר את ה-webhook של שליחת ההודעות לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט ב-Google Cloud.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על Webhooks.
- בוחרים את ה-webhook prebuilt_components_credit_card_enrollment:send_message.
- מחליפים את כתובת ה-URL בשדה Webhook URL ב-Dialogflow CX בנקודת הקצה של השירות שרוצים לשלב. בוחרים את השיטה המתאימה בתפריט הנפתח.
- בודקים ומעדכנים את גוף הבקשה כדי ליצור את פורמט הבקשה המתאים ל-webhook.
- בודקים ומעדכנים את Response configuration כדי לחלץ שדות ספציפיים מהתגובה של ה-webhook. אל תשנו את שמות הפרמטרים, כי הם נדרשים לרכיב כדי לגשת לערכי השדות שמוחזרים.
- בודקים ומעדכנים את הגדרות האימות לפי הצורך.
- לוחצים על Save.
הושלמה
עכשיו הנציג וה-webhooks שלו אמורים להיות מוגדרים ומוכנים לבדיקה.