קביעת תצורה של נכס צ'אט

סקירה כללית

השתמש בערוצים דיגיטליים ב-Control Hub כדי ליצור ולהגדיר נכס צ'אט עבור אינטרנט (צ'אט חי), נייד (הודעות בתוך האפליקציה) והודעות דחיפה. ההגדרות הזמינות לתצורה תלויות בשירות שנבחר ב- Assign to ובשאלה אם תבחר אינטרנט, נייד או שניהם.

מאמר זה מתאר את תהליך תצורת הנכסים המלא, כולל יכולות נתמכות, העברת הודעות, אישורי ספק דחיפה, הרשאת JSON Web Token (JWT), מפתחות אינטרנט JSON (JWK), פרוטוקולי הובלה, רישום רב משתמשים ותצורה ספציפית לשירות לאחר יצירת הנכס.

יכולות נתמכות

טבלה 1. יכולות נתמכות לפי שירות
יכולת	Webex Connect	מרכז הקשר של Webex	מרכז הקשר של Webex ארגוני
צ'אט חי באינטרנט	נתמך	נתמך	נתמך
הודעות בתוך האפליקציה לנייד	נתמך	נתמך	נתמך
אינטרנט ונייד בנכס יחיד	נתמך	לא נתמך	לא נתמך
נייד - הודעות דחיפה של אנדרואיד	נתמך	נתמך	נתמך
נייד - הודעות דחיפה של iOS	נתמך	נתמך	נתמך
התראות דחיפה באינטרנט	נתמך (כרום ופיירפוקס)	לא נתמך	לא נתמך
JWT - נייד	נתמך	נתמך ונדרש	נתמך ונדרש
JWT - אינטרנט	נתמך	לא נתמך	לא נתמך
רישומים מרובי משתמשים	נתמך	נתמך	נתמך
תיבת דואר נכנס בצד השרת	נתמך	לא ישים	לא ישים
זרם נתונים	נתמך	לא ישים	לא ישים

לפני שתתחיל

היכנס אל Control Hub כמנהל מלא או כמנהל מרכז אנשי קשר שיכול לנהל נכסים דיגיטליים.
ודא ששירותים Webex Connect דיגיטליים, מרכז הקשר Webex או מרכז הקשר ארגוני מסופקים עבור הארגון. ללא הזכאות, נכסים דיגיטליים אינם זמינים.
זהה את נקודת הכניסה ואת הזרימה של מרכז הקשר שיקבלו שיחות צ'אט חדשות.
אם הפריסה משתמשת בהודעות דחיפה לנייד, הכינו את אישורי Firebase, Huawei או Apple הנדרשים על ידי הפלטפורמה שנבחרה.
אם אתה מתכנן להשתמש באישור JWT, הכין את ה- JWK הציבורי המשמש לאימות האסימונים שהונפקו על ידי הקצה המהימן שלך.

קביעת תצורה של נכס הצ'אט

כדי להגדיר נכס צ'אט:

1	היכנס לרכ זת הבקרה.
2	עבור אל שירותים > נכסים דיגיטליים.
3	בחר צור נכס.
4	תחת קביעת תצורה של פרטי נכס, הזן את הערכים הבאים: שם (חובה): הזן שם נכס. תיאור: הזן תיאור מקרה שימוש אופציונלי. ערוץ (חובה): בחר צ'אט. לא ניתן לשנות את הערוץ לאחר יצירת המשאב. הקצאה ל (חובה): בחרWebex Connect, מרכז הקשר של Webex או מרכז הקשר של Webex ארגוני. האפשרויות הזמינות תלויות בזכויות הארגון.
5	בהודעות, בחר את הפלטפורמה והגדר את התצורה של צ'אט חיי/הודעות בתוך האפליקציה וכל התראות דחיפה נדרשות. האפשרויות המוצגות תלויות בפלטפורמה שנבחרה. הגדרות ההתראות של Android ו- iOS זמינות כאשר נבחר נייד. Web Push זמין כאשר נבחר Web עבור נכס שהוקצה לוWebex Connect.

קביעת תצורה של הודעות

בהודעות, בחר את הפלטפורמה והגדר את יכולות ההודעות עבור הנכס.

כדי לקבוע את התצורה של הודעות:

פרוטוקולי התחבורה הראשוניים והמשניים חייבים להיות שונים. אם ה- SDK אינו יכול ליצור חיבור באמצעות הפרוטוקול הראשי, הוא משתמש בפרוטוקול המשני כחלופה.

1	פלטפורמה: עבורWebex Connect, בחר אינטרנט, נייד או שניהם. עבור נייד, בחר אנדרואיד, iOS או שניהם. עבור מרכז הקשר של Webex או מרכז הקשר של Webex ארגוני, בחר אינטרנט או נייד.
2	צ'אט חיי/הודעות בתוך האפליקציה: עבורWebex Connect, זה זמין לאינטרנט ולנייד. עבור מרכז הקשר של Webex או Webex Contact Center Enterprise, האינטרנט מספק צ'אט חי ונייד מספק הודעות בתוך האפליקציה.
3	פרוטוקול תחבורה ראשי: בחר MQTT או שקע אינטרנט.
4	פרוטוקול תחבורה משני: בחר את הפרוטוקול שלא נבחר כראשי.

הגדר התראות דחיפה

הפעל אפשר התראות ד חיפה כאשר היישום חייב לקבל התראות דרך ספק דחיפה מוגדר. קטעי ההודעות המוצגים תלויים בפלטפורמה שנבחרה.

האפשרויות הבאות של ספק הדחיפה זמינות:

אנדרואיד: העברת הודעות ענן Firebase (FCM), Huawei או שניהם. חל על מרכז Webex Connect הקשר של Webex ומרכז הקשר של Webex ארגוני.
iOS: FCM, שירות הודעות דחיפה של Apple (APNS) או אימות מבוסס אסימון עבור APNS. חל על מרכז Webex Connect הקשר של Webex ומרכז הקשר של Webex ארגוני.
אינטרנט: העברת הודעות ענן Firebase. חל Webex Connect רק על.

בחר את הפלטפורמה והגדר את הספק המתאים בנושא המתאים.

השג את חשבון השירות של Firebase JSON

Webex משתמשת בקובץ JSON של חשבון שירות Firebase כדי לאמת בקשות שרת ל- Firebase Cloud Messaging. השתמש בפרויקט Firebase המשויך ליישום שלך.

כדי לקבל ולהעלות את חשבון השירות של Firebase JSON:

אבטחה: חשבון השירות Firebase JSON מכיל אישורים רגישים. אחסן אותו בצורה מאובטחת והעלה רק את הקובץ עבור פרויקט Firebase המיועד.

לקבלת הוראות תצורה של Firebase Cloud Messaging, ראה שליחת הודעה באמצעות ממשק ה- API של FCM HTTP v1.

1	פתח את מסוף Firebase ובחר את פרויקט Firebase המשמש את היישום שלך.
2	פתח את הגדרות הפרויי קט > חשבונות שירות.
3	בחר צור מפתח פרטי חדש ואשר את ההורדה.
4	אחסן את קובץ ה- JSON שהורדת בצורה מאובטחת. הקובץ מכיל אישורי מפתח פרטי.
5	ברכזת הבקרה, העלה את קובץ ה- JSON בהעלאת חשבון שירות Firebase JSON עבור תצורת ההתראות הרלוונטית של Android, iOS או אינטרנט.

הגדר התראות דחיפה של אנדרואיד

סעיף ההתראות של Android מוצג כאשר נבחרים הודעות דחיפה לנייד, אנדרואיד ואפשר התראות דחיפה. בחר ספק אחד לפחות; ניתן להגדיר את Firebase ו- Huawei בנפרד או יחד. תצורה זו זמינה עבורWebex Connect, מרכז הקשר של Webex ונכסים ניידים ארגוניים של מרכז הקשר של Webex.

תיעוד ספק: Huawei - התקנה ובדיקה של ערכת דחיפה

1	בחר נייד, אנדרואיד ואפשר התראות דחיפה. סעיף ההודעות של Android מוצג.
2	בחר העברת הודעות ענן Firebase והעלה את קובץ ה- JSON הנדרש של חשבון שירות Firebase מפרויקט Firebase.
3	אם האפליקציה תומכת במכשירים המשתמשים בשירותי Huawei Mobile, בחר Huawei והזן את המזהה בתוך האפליקציה ואת הסוד בתוך האפליקציה מ- AppGallery Connect. חריג של Huawei: ניתן לדלג על תצורת Huawei כאשר האפליקציה אינה תומכת במכשירים ללא שירותי Google Play. ההנחיות הנוכ Webex Connect חיות תומכות ב- EMUI 10.x ואילך.

הגדר התראות דחיפה של iOS

סעיף ההתראות של iOS מוצג כאשר נבחרים הודעות דחיפה לנייד, iOS ואפשר התראות דחיפה. בחר ספק דחיפה אחד. תצורה זו זמינה עבורWebex Connect, מרכז הקשר של Webex ונכסים ניידים ארגוניים של מרכז הקשר של Webex.

לקבלת הוראות תצורה של APNs מבוססי אישורים, ראה יצירת חיבור מבוסס אי שורים ל- APNs.

לקבלת הוראות תצורה של APNs מבוססי אסימון, ראה יצירת חיבור מבוסס אסימון ל- APNs.

1	בחר נייד, iOS ואפשר התראות דחיפה. סעיף ההודעות של iOS מוצג.
2	בחר ספק דחיפה אחד.
3	עבור העברת הודעות ענן של Firebase, העלה את קובץ JSON של חשבון שירות Firebase שהורד מפרו יקט Firebase.
4	עבור שירות הודעות דחיפה של Apple (APNS), הזן את סיסמת האישור, בחר ארגז חול או ייצור, העלה את אישור APNS, הזן שם ואמת את הת צורה. נתמך רק בתבנית האישור .p12.
5	לאימות APNS מבוסס אסימון, הזן את מזהה המפתח, מזהה הצוות ואת מזהה חבילת האפליקציה או הח בילה, בחר ארגז חול או ייצור והעלה את קובץ המפתח הפרטי של APNS. בחירת Gateway: השתמש ב- Sandbox עבור אפליקציית פיתוח ובייצור עבור אפליקציה מוכנה לייצור. אחסן את המפתח הפרטי של APNS בצורה מאובטחת; Apple מתירה לאח זר את קובץ המפתח .p8 שהורד פעם אחת בלבד.
6	החלף את אישור ספק Apple לפני שתוקפו יפוג כדי למנוע הפרעה למסירה דחופה.

הגדר התראות דחיפה באינטרנט

התראות דחיפת אינטרנט זמינות רק עבור נכסים שהוקצו להם Webex Connect כאשר האינטרנט נבחר. כרום ופיירפוקס נתמכים. Safari Web Push אינה נתמכת כרגע.

הודעות דחיפה באינטרנט אינן נתמכות עבור נכסים שהוקצו למרכז הקשר של Webex או ל- Webex Contact Center Enterprise.

כדי להגדיר התראות דחיפה באינטרנט:

1	ודא שהמשאב מוקצה Webex Connect ל- Web נבחר.
2	השתמש ב- Chrome או Firefox כדי לגשת לאתר ולקבל התראות דחיפה באינטרנט.
3	כתובת אתר אינטרנט (חובה): הזן את כתובת האתר של האתר שיקבל הודעות דחיפה באינטרנט.
4	סמל הודעה (חובה): הזן את הנתיב לסמל ההודעה. הסמל חייב להיות 80 x 80 פיקסלים.
5	הגדר את התצורה של העברת הודעות ענן של Firebase (FCM) עבור יישום האינטרנט שלך על-ידי ביצוע התיעוד של Fire base.
6	חשבון שירות Firebase JSON (חובה): העלה את קובץ JSON של חשבון שירות Firebase המכיל את המפתח הפרטי הנדרש לשימוש בממשק ה- API של Firebase Cloud Messaging HTTP v1.

קבע את התצורה של הרשאת אסימון אינטרנט JSON

הרשאת JWT מחייבת אישור תקשורת SDK באמצעות אסימון אינטרנט תקף JSON. עבור נכסים חדשים, סוג ההצפנה הוא אסימטרי.

תמיכת JWT היא כדלקמן:

Webex Connect: נתמך עבור מכשירים ניידים ואינטרנט באותו נכס.
מרכז הקשר של Webex ומרכז הקשר של Webex ארגוני - אינטרנט: לא נתמך.
מרכז הקשר של Webex ומרכז הקשר של Webex ארגוני - נייד: נתמך ונדרש עבור תצורת הנכס הנייד.

הגדר את ההגדרות הבאות:

סוג הצפנה: אסימטרי לנכסים חדשים.
תפוגת אסימון (חובה): הזן כמה זמן ה- JWT נשאר תקף לפני שנדרש אסימון זהות משתמש חדש. טווח תקף: 5-360 דקות. ברירת מחדל: 60 דקות.
מפתחות אינטרנט JSON (חובה): העלה את ה- JWK הציבורי המשמש לאימות אסימונים. ניתן להוסיף מפתח שני לסיבוב. מקסימום: שני מפתחות.

הוסף והכין את מפתח האינטרנט הציבורי JSON כמתואר בנושאי הילד.

הכן את ה- JWK הציבורי

הקובץ שהועלה חייב להכיל את מפתח אימות ה- RSA הציבורי. Webex מאמת את מאפייני JWK הבאים.

מאפייני JWK מוגדרים ב- RFC 7517, סעיף 4. מאפיינים ספציפיים לאלגוריתם מוגדרים ב- RFC 7518.

טבלה 2. נכסים ציבוריים של JWK
שם הנכס	תיאור
אצה	מזהה את האלגוריתם הקריפטוגרפי המשמש עם המפתח. הערך הנדרש הוא RS256, המציין RSASSA-PKCS1- באמצעות SHA-256. v1_5
ה	המעריך עבור המפתח הציבורי RSA, המיוצג כערך מקודד Base64URLuint.
key_ops	מציין את הפעולה שלשמה מיועד המפתח. הערך הנתמך הוא אימות, המציין שהמפתח משמש לאימות חתימות דיגיטליות. ראה RFC 7517, סעיף 4.3.
קיטי	מזהה את משפחת האלגוריתם הקריפטוגרפי המשמשת עם המפתח. הערך חייב להיות RSA. ראה RFC 7517, סעיף 4.1.
n	המודול עבור המפתח הציבורי RSA, המיוצג כערך מקודד Base64URLuint.
שימוש	מציין את השימוש המיועד במפתח הציבורי. הערך חייב להיות sig, המציין כי המפתח מיועד לאימות חתימה. ראה RFC 7517, סעיף 4.2.
ילד	מזהה את המפתח ומשמש להתאמת מפתח ספציפי, כגון במהלך סיבוב מפתח. ראה RFC 7517, סעיף 4.5.

העלה רק את מפתח האימות הציבורי. שמור את מפתח החתימה הפרטי המתאים במערכת המהימנה שמנפיקה JWTs.

הוספת מפתח אינטרנט JSON

כדי להוסיף מפתח אינטרנט ציבורי של JSON:

1	בחר הוסף מפתח.
2	הזן שם מפתח אינטרנט JSON.
3	הזן את מנפיק מפתח האינטרנט של JSON. ערך זה חייב להתאים למנפיק המשמש את הקצה המהימן כאשר הוא יוצר את ה- JWT.
4	העלה את קובץ ה- JWK הציבורי.
5	בחר שמור.

קביעת תצורה של רישומים מרובי משתמשים

אפשר לאפשר רישומי משתמשים מרובים באותו מכשיר כאשר משתמשים מרובים יכולים להירשם באותו מכשיר פיזי.

הודעות דחיפה מועברות למשתמשים רשומים פעילים ולא פעילים כאחד.
צ'אט חי או הודעות בתוך האפליקציה מועברות למשתמש הפעיל כרגע. הודעות עבור משתמשים לא פעילים עומדות בתור עד שהמשתמש יהפוך לפעיל שוב.

הגדר Webex Connect הגדרות נוספות

ההגדרות המתקדמות הבאות חלות רק על Webex Connect נכסים ואינן חלות על הנכסים הארגוניים של מרכז הקשר Webex או מרכז הקשר של Webex.

התקן יחיד למשתמש: מגביל משתמש למכשיר רשום אחד. ההרשמה במכשיר חדש מפסיקה את המסירה לדחיפה למכשיר הישן.
תיבת דואר נכנס בצד השרת: מאחסן עותק בצד השרת של נתוני תיבת הדואר הנכנס לאחזור מאוחר יותר.
זרם נתונים: שולח נתוני אירועים רלוונטיים לאינטגר Webex Connect ציה שנבחרה עבור הודעות שנשלחו דרך ממשק ה- API של הודעות.

שמור כדי ליצור את המשאב

לאחר שתגדיר את ההודעות הרלוונטיות, הרשאת JWT, רישום רב משתמשים ו Webex Connect הגדרות, שמור את התצורה כדי ליצור את נכס הצ'אט.

בחר ש מור כדי ליצור את המשאב.

המתן לאישור שהנכס נוצר בהצלחה.

שילוב שירות מלא

לאחר יצירת נכס הצ'אט, השלם את השילוב עבור השירות שנבחר ב- As sign to. בצע את הנוהל הרלוונטי עבורWebex Connect, מרכז הקשר Webex או מרכז הקשר של Webex ארגוני.

אינטגרציה Webex Connect מלאה

עבור נכס שהוקצה ל-Webex Connect, השלם את מיפוי השירות ותצורת הזרימה ב-Webex Connect. אין צורך באישור צומת.

ניתן להשתמש בצומת התחלה, אירוע מותאם אישית או Webhook מותאם אישית כדי ללכוד אירועים נכנסים ולהפעיל זרימה. לקבלת מידע נוסף, ראה צ ומת התחל, אירוע מותאם אישית ו - Webhook מותאם אישית.

1	היכנס אלWebex Connect.
2	השלם את תצורת מיפוי השירות והתצורה הזרימה הרלוונטית עבור נכס הצ'אט.
3	רשום את מזהה האפליקציה ומפתח הלקוח שנוצר.
4	הורד את קובץ התצורה של SDK עבור כל פלטפורמה שנבחרה.

שילוב מלא של מרכז הקשר של Webex

עבור נכס שהוקצה למרכז הקשר של Webex, מיפו את הנכס לנקודת כניסה של מרכז אנשי קשר ולאחר מכן השלם את ההרשאה לצומת מרכז הקשר של Webex.

ניתן למפות נכס לנקודת כניסה אחת בלבד. השלם את מיפוי נקודת הכניסה והזרימה לפני פרסום חוויית הלקוח.

1	פתח את תצ ורת מרכז הקשר ברכזת הבקרה.
2	צור או פתח את נקודת הכניסה שמקבלת שיחות צ'אט.
3	במי פוי זרימה, בחר את נכס הצ'אט ואת זרימת הזנת הלקוח הנדרשת.
4	שמור את נקודת הכניסה וודא את מיפוי הנכס והזרימה.
5	השלם את ההרשאה לצומת מרכז הקשר של Webex ב. Webex Connect לקבלת הוראות, ראה צ מתים לשילוב משימות Webex CC ואישורי צומת.
6	לפריסת אינטרנט, הגדר את התצורה של יישומון צ'אט חי וקבל את קוד הטמעת האתר ב- Control Hub.

שילוב ארגוני מלא של מרכז הקשר של Webex

עבור נכס שהוקצה ל- Webex Contact Center Enterprise, השלם את ההרשאה של צומת CCE Webex Connect לפני הגדרת זרימת הניתוב.

1	היכנס אלWebex Connect.
2	אישור צומת CCE מלא. לקבלת הוראות, ראה צ מתים לשילוב CCE ואישורי צומת.
3	הגדר את הצמתים המתאימים לשילוב CCE ואת זרימת הניתוב עבור נכס הצ'אט. לקבלת דוגמאות לזרימה, ראה תצורות זרימה.
4	שמור ובדוק את הזרימה.

לקבלת הנחיות תצורה נוספות, ראה שיטות עבודה מומלצות והנחיות ו שאלות נפוצות.

חריגים ומגבלות

זכור את החריגים והמגבלות הבאים:

אשר את בחירת הערוץ, הפלטפורמה, ההקצאה והניתוב לפני יצירת הנכס. לא ניתן לשנות את הערוץ לאחר היצירה, ושינויי הפלטפורמה מוגבלים על ידי עומס העבודה.
עבור מרכז הקשר של Webex ו- Webex Contact Center Enterprise, נכס יחיד אינו יכול להשתמש באינטרנט ובנייד יחד. צור נכסים נפרדים כאשר שניהם נדרשים.
התראות דחיפה באינטרנט זמינות רק עבורWebex Connect. דחיפת האינטרנט של Safari, דחיפת האינטרנט של מרכז אנשי הקשר של Webex ו-Webex דחיפת אינטרנט ארגונית של מרכז אנשי הקשר אינם נתמכים.
הרשאת JWT אינה נתמכת עבור נכסי אינטרנט שהוקצו למרכז הקשר של Webex או למרכז הקשר של Webex ארגוני.
עבור מרכז הקשר של Webex ו- Webex Contact Center Enterprise, בצע תצורת נקודת כניסה, זרימה, יישומון וקוד הטבעה במקטע מרכז אנשי הקשר ברכזת הבקרה.
עבורWebex Connect, השלם את תצורת השירות והזרימה בWebex Connect.
אל תמחק נכס צ'אט לאחר מיפוי לשירות מבלי להסיר או לעדכן תחילה את המיפוי במורד הזרם. לא ניתן לשחזר נכס שנמחק ויכול להשאיר מיפוי קיים בלתי שמיש.
לאחר היצירה, שמור את מזהה האפליקציה, מפתח לקוח וקבצי התצורה של SDK שנוצרו הנדרשים לאתחול ה- SDK המתאים.

Cisco AI Assistant

תודה על המשוב.