שילוב של צ'אט Salesforce

השילוב הזה של צ'אט משתמש ברכיב אינטרנט של Salesforce Lightning (LWC) כדי להשתלב עם מודולים של ממשק המשתמש של Agent Assist לשיחות צ'אט.

הנה סקירה כללית של השילוב עם Chat:

ארכיטקטורה של שילוב הצ'אט של Agent Assist עם Salesforce

לפני שמתחילים

כדי לשלב מודולים של ממשק המשתמש של Agent Assist עם Salesforce, קודם צריך להגדיר את המשאבים הנדרשים.

שלב 1: הגדרת פרויקט פיתוח ב-Salesforce

כדי להתחיל לשלב מודולים של ממשק המשתמש של Agent Assist, פועלים לפי השלבים הבאים.

  1. מריצים את הקוד הבא כדי לשכפל את מאגר השילוב של Agent Assist ולפתוח את הפרויקט:

    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    cd salesforce/aa-lwc
    
  2. מריצים את הפקודות הבאות כדי להוריד את קובצי JavaScript של מודולי ממשק המשתמש, שאותם פורסים בהמשך כמשאבים סטטיים. ב-Salesforce נדרשים משאבים סטטיים כדי לטעון JavaScript של צד שלישי. בנוסף, יש מגבלה של 5MB על קובצי משאבים סטטיים, ולכן קובצי JavaScript מועלים כקובץ ZIP.

    npm run generate-static-resources
    npm install
    

שלב 2: הגדרת סביבת Salesforce

אתם יכולים לשלב מודולים של ממשק המשתמש של Agent Assist בסביבה ספציפית, כמו סביבת ייצור או סביבת פיתוח. ב-Salesforce, הסביבות האלה נקראות ארגונים (orgs).

הגדרת הארגון במסוף Salesforce

כדי להגדיר את הארגון לשילוב של Agent Assist, פועלים לפי השלבים הבאים במסוף Salesforce.

  1. לוחצים על הגדרה > הגדרה. בתיבה Quick Find (חיפוש מהיר), מזינים Omni-Channel Settings (הגדרות של Omni-Channel) ולוחצים על Omni-Channel Settings (הגדרות של Omni-Channel).
    1. בוחרים באפשרות הפעלה של Omni-Channel.
    2. בוחרים באפשרות כניסה אוטומטית של נציגים למוקד אומני-צ'אנל בחלון או בכרטיסייה החדשים.
    3. לוחצים על Save.
  2. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מזינים קהילות ולוחצים על חוויות דיגיטליות > הגדרות.
    1. בוחרים באפשרות הפעלת סביבות עבודה של Experience.
    2. לוחצים על Save.

הגדרת הארגון באמצעות Salesforce CLI

כדי להגדיר את הארגון לשילוב של Agent Assist באמצעות Salesforce CLI, צריך לפעול לפי השלבים הבאים.

  1. מריצים את הקוד הבא ומאמתים את ה-CLI באמצעות פרטי הכניסה ל-Salesforce שבהם אתם משתמשים בדרך כלל.

    npm run login
    
  2. מריצים את הקוד הבא כדי לפרוס את ה-LWC בארגון.

    npm run deploy
    

שלב 3: יצירת אפליקציית לקוח חיצונית

רכיב ה-LWC של Salesforce משתמש בתהליך OAuth 2.0 של פרטי כניסה של לקוח כדי לאמת אתכם. אפליקציית לקוח חיצונית מאפשרת את תהליך פרטי הכניסה של הלקוח. משתמשים בטוקן הצרכן ובסוד הצרכן של האפליקציה כדי להגדיר את Salesforce LWC לאימות משתמשים ב-Salesforce.

  1. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מקלידים מנהל אפליקציות חיצוניות ללקוח.
    1. לוחצים על External Client App Manager (ניהול אפליקציות חיצוניות ללקוח) > New External Client App (אפליקציה חדשה ללקוח חיצוני) > Create (יצירה), ואז מזינים את הפרטים הבאים.
      • שם האפליקציה של הלקוח החיצוני: lwc auth
      • שם ה-API: lwc_auth
      • אימייל ליצירת קשר: your_email@example.com
      • ‫API (הפעלת הגדרות OAuth) > הפעלת OAuth: נבחר
      • ‫API (הפעלת הגדרות OAuth) > כתובת URL של קריאה חוזרת (callback): https://login.salesforce.com/services/oauth2/callback
      • ‫API (הפעלת הגדרות OAuth) > היקפי הרשאות OAuth שנבחרו: גישה לשירות של כתובת ה-URL של הזהות
      • API (Enable OAuth Settings) > Enable Client Credentials Flow: Selected
    2. לוחצים על יצירה.
  2. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מקלידים מנהל אפליקציות חיצוניות ללקוח.
    1. לוחצים על השם של אפליקציית הלקוח החיצונית > עריכה.
    2. עוברים אל OAuth Policies > OAuth Flows and External Client App Enhancements.
    3. מוודאים שהאפשרות Enable Client Credentials Flow מסומנת.
    4. בשדה Run As (הרצה בתור), מזינים את שם המשתמש שלכם להתחברות.
    5. לוחצים על Save.
  3. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מקלידים מנהל אפליקציות חיצוניות ללקוח.
    1. לוחצים על השם של אפליקציית הלקוח החיצונית > עריכה.
    2. עוברים אל הגדרות OAuth > הגדרות אפליקציה > מפתח וסוד צרכן.
    3. מזינים את קוד האימות שנשלח לאימייל.
    4. מעתיקים את טוקן הצרכן ואת הסוד לשימוש עם טוקן הצרכן למקום בטוח. תצטרכו אותם בשלב מאוחר יותר.

הגדרה של CORS ושל כללי מדיניות בנושא אבטחת תוכן

  1. לוחצים על הגדרה > הגדרה.
  2. בתיבה חיפוש מהיר, מזינים CORS ואז לוחצים על עריכה.
    1. בוחרים באפשרות הפעלה של CORS לנקודות קצה של OAuth.
    2. לוחצים על Save.
  3. לוחצים על הגדרה > הגדרה.
  4. בתיבה חיפוש מהיר, מזינים כתובות URL מהימנות ולוחצים על כתובת URL מהימנה חדשה.
  5. מזינים את הפרטים הבאים:
    • שם ה-API: ui_connector
    • ‫URL: מזינים את כתובת ה-URL של נקודת הקצה של שירות Cloud Run של מחבר ממשק המשתמש שפרסתם עם העורף של שילוב Agent Assist. אפשר למצוא את כתובת ה-URL הזו במסוף Cloud Run. לדוגמה: https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • הנחיות CSP: מסמנים את כל תיבות הסימון.
    • לוחצים על שמירה ויצירת מסנן חדש.
  6. מזינים את הפרטים הבאים:
    • שם ה-API: ui_connector_wss
    • כתובת URL: מזינים את כתובת ה-URL של Secure WebSockets עבור נקודת הקצה של שירות UI Connector: wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • הנחיות CSP: מסמנים את כל תיבות הסימון.
    • לוחצים על שמירה ויצירת מסנן חדש.
  7. מזינים את הפרטים הבאים:
    • שם ה-API: salesforce_domain
    • כתובת URL: מזינים את כתובת ה-URL של הדומיין ב-Salesforce בפורמט הבא: https://YOUR_SUBDOMAIN.my.salesforce.com.
    • הנחיות CSP: מסמנים את כל תיבות הסימון.
    • לוחצים על Save.

שלב 4: הגדרת לקוח הצ'אט

כדי להשתמש במודולים של ממשק המשתמש של Agent Assist עם Salesforce, צריך לקוח צ'אט בשולחן העבודה של הנציג.

הגדרת צ'אט משופר

כדי להגדיר את הצ'אט, פועלים לפי השלבים הבאים.

  1. לוחצים על הגדרה > הגדרה. מזינים חיפוש Quick Find (חיפוש מהיר) של Queues (תורים) ואז לוחצים על New (חדש).
    1. מזינים את הפרטים הבאים:
      • תווית: Messaging Queue
      • שם התור: Messaging_Queue
      • הגדרת ניתוב: Messaging_Routing_Configuration
    2. לוחצים על Supported Objects (אובייקטים נתמכים) ואז מוסיפים את Messaging User (משתמש העברת הודעות) ואת Messaging Session (סשן העברת הודעות).
    3. לוחצים על Queue Members (חברים בתור) ומוסיפים את User: Your Login User (משתמש: המשתמש שאיתו נכנסתם).
    4. לוחצים על Save.
  2. לוחצים על הגדרה > הגדרה. בתיבה Quick Find, מזינים Permission Sets.
    1. לוחצים על Messaging Agents Permission Set (ערכת הרשאות של סוכני הודעות).
    2. לוחצים על גישה לסטטוסים של נוכחות בשירות > עריכה.
    3. בוחרים בסטטוסים עסוק/ה ומחובר/ת – שליחת הודעות.
    4. לוחצים על הוספה > שמירה.
  3. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מזינים משתמשים ואז לוחצים על משתמשים.
    1. לוחצים על שם המשתמש ומוודאים שהאפשרות Service Cloud User (משתמש Service Cloud) מופעלת.
    2. בדף, מחפשים את האפשרות Permission Set License Assignments (הקצאות רישיונות של קבוצות הרשאות).
    3. לוחצים על עריכת הקצאות ואז בוחרים באפשרות Enhanced Chat User.
    4. לוחצים על Save.
    5. בדף, מחפשים את האפשרות Permission Set Assignments (הקצאות של קבוצות הרשאות).
    6. לוחצים על עריכת הקצאות ואז בוחרים באפשרות הגדרת הרשאות של סוכן העברת הודעות.
    7. לוחצים על הוספה > שמירה.
  4. לוחצים על הגדרה > הגדרה. בתיבה חיפוש מהיר, מזינים הגדרות של העברת הודעות ולוחצים על ערוץ חדש.
    1. בוחרים באפשרות התכתבות משופרת ב-Chat.
    2. מזינים את השם: Messaging Channel.
    3. לוחצים על Save.
    4. מגדירים את סוג הניתוב לתור אוניברסלי ואת התור לתור של הודעות.
    5. לוחצים על שמירה ועוברים אל הגדרות הצ'אט.
    6. לוחצים על השם של ערוץ ההודעות ואז על הפעלה.
    7. אחרי הקריאה, מאשרים את התנאים וההגבלות.
  5. לוחצים על הגדרה > הגדרה. בתיבה Quick Find (חיפוש מהיר), מזינים Embedded Service Deployments (פריסות של שירותים מוטמעים) ולוחצים על New Deployment (פריסה חדשה).
    1. לוחצים על גרסה משופרת של Chat > הבא > אינטרנט > הבא.
    2. ממלאים את הפרטים הבאים:
      • Name (שם): Messaging Embedded Service Deployment
      • שם המפתח: Messaging_Embedded_Service_Deployment
      • דומיין: example.com
      • ערוץ: ערוץ העברת הודעות
    3. לוחצים על Save. מחכים שהפריסה תסתיים.
    4. בהגדרות של פריסת שירות מוטמע, לוחצים על פרסום.
    5. לוחצים על רענון ואז על בדיקת העברת הודעות.

בדיקת גרסה משופרת של Chat

כדי לבדוק את הצ'אטבוט, פועלים לפי השלבים הבאים.

  1. לוחצים על בדיקת העברת הודעות.
  2. אחרי שהכרטיסייה החדשה נטענת, לוחצים על בועת הדיבור כדי להתחיל שיחה חדשה לבדיקה.
  3. שולחים הודעה, למשל בדיקה.
  4. עוברים לכרטיסייה של Salesforce בדפדפן.
  5. לוחצים על התפריט מרכז האפליקציות ואז על מסוף השירות.
  6. לוחצים על כל הערוצים.
  7. משנים את הסטטוס למחובר – העברת הודעות.
  8. מאשרים את ההודעה הנכנסת. תיפתח כרטיסייה חדשה במסוף השירות עם השיחה. אתם לא יכולים לראות את תמליל הצ'אט.
  9. לוחצים על הגדרות ובוחרים באפשרות עריכת הדף.
  10. בתפריט רכיבים, גוררים את הרכיב שיחה משופרת אל הקטע שיחה.
  11. לוחצים על שמירה > הפעלה > הקצאה כברירת מחדל של הארגון > מחשב > חזרה .
  12. יש לרענן את הדף.
  13. לוחצים על כל הערוצים.
  14. משנים את הסטטוס למחובר – העברת הודעות.
  15. עונים להודעת הבדיקה כדי לוודא שההודעות פועלות.

אם נתקלתם בבעיה ואתם צריכים מידע נוסף, תוכלו לעיין במדריך המקיף להגדרת צ'אט משופר ב-Salesforce.

שלב 5: התקנת רכיב האינטרנט של Salesforce Lightning

כדי להוסיף את Salesforce LWC לדף של סשן העברת הודעות באמצעות Lightning Experience Editor: ממשיכים עם שיחת הבדיקה משלב 4.

  1. לוחצים על הגדרות ובוחרים באפשרות עריכת הדף.
  2. מהרשימה רכיבים, גוררים את agentAssistContainerModule אל הדף.

  3. לוחצים על הרכיב שהצבתם בשלב הקודם.

  4. כדי להוסיף פרטי הגדרה, ממלאים את השדות בטופס באופן הבא.

    • נקודת קצה: כתובת ה-URL של הקצה העורפי של שילוב הסוכן, כמו כתובת URL ממסוף Cloud Run, למשל: https://UI_CONNECTOR_ENDPOINT.GCP_REGION.run.app
    • ‫channel: מציינים שהערוץ הוא chat.
    • ‫platform: מציינים שהפלטפורמה היא messaging.
    • ‫conversationProfile: שם המשאב של פרופיל השיחה של Agent Assist (דוגמה: projects/GCP_PROJECT_ID/locations/GCP_REGION/conversationProfiles/CONVERSATION_PROFILE_ID)
    • ‫consumerKey: טוקן הצרכן של אפליקציית הלקוח החיצונית משלב 3.
    • ‫consumerSecret: סוד הצרכן של אפליקציית הלקוח החיצונית משלב 3.
    • ‫containerHeight: הגובה של מאגר Agent Assist.