הרכיב המוגדר מראש להרשמה לכרטיס אשראי מאפשר ללקוחות חדשים וקיימים להגיש בקשה לכרטיס אשראי חדש.
הרכיב מתחיל באיסוף מספר הטלפון של המשתמש כדי לזהות אם מדובר בלקוח חדש או קיים. אם מדובר במשתמש חדש, הרכיב אוסף את הפרטים הנדרשים, כולל ההכנסה החודשית וקטגוריית ההוצאות או ההטבות בכרטיס האשראי שהוא רוצה. אחרי שכל המידע הנדרש נאסף, הרכיב קובע שיחה חוזרת ומספק למשתמש את מספר הבקשה.
אם מדובר בלקוח קיים, הרכיב מאחזר את פרטי המשתמש הרשום ומציג לו אפשרויות זמינות של כרטיסי אשראי על סמך ההעדפות שלו והמידע שאוחזר, כולל דירוג האשראי שלו. אחרי שהלקוח בוחר באפשרות של כרטיס אשראי, הרכיב שולח קישור להשלמת תהליך ההרשמה באמצעות ערוצים רשומים, כולל וואטסאפ או SMS.
הרכיב הזה משתמש ברכיבים איסוף מספרי טלפון ואיסוף מספרי מיקוד כדי לאסוף ולאמת את פרטי המשתמשים.
מגבלות
בנוסף למגבלות הנפוצות של רכיבים מוגדרים מראש, הרכיב הזה כולל את המגבלות הבאות:
- הרכיב הזה לא מצפין נתונים.
דוגמאות לדו-שיח
בתיבות הדו-שיח לדוגמה מוצגים תרחישים נפוצים שהרכיב המוכן מראש הזה מטפל בהם. הם מדגימים את ההתנהגות כשהמשתמש מתקשר לרכיב באמצעות טלפוניה, מה שמפעיל את Default Welcome Intent ואת התגובה הראשונה של הנציג בתחילת השיחה.
משתמש חדש
- הרכיב בודק אם המשתמש מתקשר באמצעות מספר טלפון רשום כדי לזהות אם מדובר במשתמש חדש.
- הרכיב אוסף את קטגוריית כרטיס האשראי שהמשתמש רוצה לרשום, ומידע לזיהוי המשתמש, כולל המיקוד ומספר הטלפון.
- הרכיב קובע שיחה חוזרת ומספק את מספר הבקשה.
| הטקסט של המשתמש | התשובה של הסוכן |
|---|---|
| האם אתה לקוח קיים של הבנק שלנו? | |
| אני לא | |
| אנחנו שמחים שברצונך להגיש בקשה לכרטיס אשראי אצלנו. יש לנו מגוון רחב של כרטיסי אשראי שמתאימים לך. כדי שנוכל להציע לך את כרטיסי האשראי הכי טובים, אפשר לשאול מה ההכנסה החודשית שלך בדולר ארה"ב? |
|
| 5,000 דולר | |
| אילו הוצאות או הטבות מעניינות אותך? יש לנו מגוון אפשרויות, כמו נסיעות, דלק וקניות. | |
| אני אוהב/ת לעשות קניות | |
| התשובה שבחרת שייכת לקטגוריית הקניות. אם רוצים להמשיך, אומרים "כן". | |
| כן | |
| הנציג אוסף את המיקוד של המשתמש באמצעות הרכיב המוגדר מראש Zip code collection. | |
| ציינת שהמיקוד הוא 10011, נכון? | |
| כן, זה נכון | |
| מעולה, סיימנו לאסוף את המיקוד. | |
| הנציג אוסף את מספר הטלפון של המשתמש באמצעות הרכיב המוגדר מראש Telephone number collection. | |
| הבנתי. המספר שציינת הוא +16502530000, נכון? | |
| כן | |
| מעולה, סיימנו לאסוף את מספר הטלפון. אחד מהנציגים שלנו יתקשר אליך בחזרה לגבי הכרטיסים הקשורים על סמך הקריטריונים שלך. מספר הבקשה שלך הוא 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.
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה יצירה.
- לוחצים על הרכיב המיובא בקטע 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 "קבלת מספר כרטיסי האשראי" לרכיב הזה, צריך להרחיב את ההוראות.
- פותחים את מסוף 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 שלו מוגדרים עכשיו ומוכנים לבדיקה.