אינטגרציית Salesforce
  • 13 Feb 2024
  • 6 דקות לקריאה
  • תורמים
  • אפל
    אור
  • PDF , מסמך PDF

אינטגרציית Salesforce

  • אפל
    אור
  • PDF , מסמך PDF

Article Summary

סקירה

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

  • אינטגרצית צד לקוח - שילוב חלון שיחה של קומבוקס ב Salesforce.
  • אינטגרצית צד שרת - תקשורת בין שרת קומבוקס לשרת Salesforce לצורך
    * חיפוש הלקוח של ב Salesforce לפי מזהה השיחה והעשרת המידע בקומבוקס
    * יצירת רשומות חדשות באופן אוטומטי ב Salesforce לפי הצורך כגון איש קשר, חשבון, פניה ועוד.

image.png

שלבי ההתקנה:

  1. יש להתקין את חבילת קומבוקס ב Salesforce
  2. יש לחבר את Salesforce לחשבון העסקי שלכם בקומבוקס.
  3. יש להגדיר הרשאות גישה לקומבוקס.
  4. יש להגדיר את מוקד השיחות.
  5. יש להוסיף את מוקד השיחות לקומבוקס.
  6. יש להפעיל את Salesforce בפלטפורמת קומבוקס.
  7. יש לוודא שהאינטגרציה עובדת כיאות.
  8. הגדרת סיילספורס בפלטפורמת קומבוקס.
    שימו לב: תהליך ההתקנה דורש הרשאות מנהל מערכת הן ל- Salesforce והן לקומבוקס.

התקנת החבילה

  1. בקונסולת Salesforce, יש לעבור להתקנה.

  2. ב- Quick Find, יש להזין AppExchange (התוצאות יוצגו מבלי ללחוץ על Enter).

  3. יש לבחור AppExchange Marketplace מהלינקים המסופקים.

  4. בחלון AppExchange, יש להזין CommBox לשדה ה- Search AppExchange וללחוץ על Enter.

  5. בתוצאות החיפוש, יש לבחור ב- CommBox Connector.

  6. בדף פרטי CommBox Connector, יש לבחור ב- Get It Now.

  7. אם תקבלו את ההתחברות למסך AppExchange, יש לבחור ב-Screen Open Login וללחוץ על Allow במסך Allow Access.
    image.png

  8. בסעיף Install in This Org, יש לבחור ב- Install Here.
    image.png

  9. במסך אישור פרטי התקנה, יש למלא את טופס ה- Tell us about yourself ולסמן את תיבת
    I have read and agree to the terms and conditions. ניתן לבחור בתיבה המאפשרת לספק ליצור עימכם קשר. המשיכו בלחיצה על Confirm and Install.
    image.png

  10. יש לבחור ב- Install for Admins Only ולאחר מכן ללחוץ על Install.
    שימו לב: בחירה זו חשובה מאוד- בחירת האופציה הלא נכונה תגרום לנציגים לקבל גישה לא מורשית.
    בזמן התקנת CommBox Connector (ייתכן כי תיקח כמה דקות), תוצג ההודעה הבאה: This app is taking a long time to install.
    image.png

  11. לאחר סיום ההתקנה, יש ללחוץ על Done.

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

  13. יש לסגור את דף פרטי CommBox Connector (אם עדיין פתוח).

  14. ב- Quick Find, יש להזין Installed ולאחר מכן ללחוץ על Installed Packages.
    image.png

  15. לאחר שדף Installed Packages נפתח, יש לאשר כי ה- CommBox Connector הותקן.

  16. לאחר ההתקנה, תמצאו סט הרשאות חדש בשם CommBox ADMIN. יש לעבור לשם על ידי בחירת Users> Permission Sets וללחוץ על CommBox ADMIN.
    image.png

  17. יש להקצות את ההרשאות למשתמשי האדמין (מנהלי המערכת) הנבחרים.
    (אפשרות אחרת היא לעבור ל- Users, לבחור במשתמש ולהוסיף לו את סט ההרשאות).
    בדף Permission Set, יש ללחוץ על Manage Assignments.
    image.png

  18. יש ללחוץ על Add Assignment בפינה הימנית העליונה.
    image.png

  19. יש לבחור במשתמשי האדמין (מנהלי המערכת) מהרשימה, לאחר מכן לבחור ב Next > Assign > Done.
    image.png

שלב אופציונלי:

הוספת אובייקט ה Transcript ב Layout לאובייקט ה Case
ב Object Manager, יש לבחור ב- Case Page Layout ולהוסיף Transcripts Related List למקרה (ניתן לגרירה- ראו צילום מסך להלן).
image.png

  1. שמור את השינויים.

חיבור Salesforce לחשבון החברה של קומבוקס

שימו לב: המונחים ברנד ושם חברה מתייחסים לאותה ישות עסקית המשמשת לזיהוי העסק ב- APIs והתקנות בפלטפורמות.
יש ליצור אפליקציה מחוברת.

  1. בקונסולת Salesforce, יש לעבור ל- GOTO > Setup > Apps > App Manager וללחוץ על New Connected App.
  2. יש להזין את המידע הבסיסי הבא בשדות המתאימים:
    א. שם אפליקציה מחוברת:
    Connected App Name: Commbox {{CORPRATE_NAME}}
    ב. שם API:
    API Name: commbox_{{CORPRATE_NAME}}
    ג. דוא"ל ליצירת קשר.
    ד. URL תמונת לוגו.
  3. בלשונית API (Enable OAuth Settings), יש להזין את הפרטים הבאים:
    א. יש לסמן את Enable OAuth Settings.
    ב. Callback URL: Https://{{CORPRATE_NAME}}.commbox.io/oauth/salesforce/callback
    ג. יש להוסיף את הדברים הבאים ל- Selected OAuth Scopes:
    - גישה לשירות ה- URL המזהה (ID, פרופיל, דוא"ל, כתובת, טלפון).
    - ניהול נתוני משתמש דרך APIs
    - ביצוע בקשות בכל זמן (רענון_טוקן, גישה_אופליין).

image.png

  1. בלשונית Canvas App Settings:
    א. Canvas: מסומן.
    ב. Canvas App URL:
    https://{{CORPRAT E_NAME}}.commbox.io/salesforce/signedrequest
    ג. Access Method: Signed Request (POST)
    ד. מיקומים: Visualforce Page, Open CTI

המסך אמור להיראות כך:

image.png

  1. לחצו על Save.
    לאחר לחיצה על Save, דף ה- Manage Connected Apps ייפתח. יש ללחוץ על לשונית
    API (Enable OAuth Settings) ולאחר מכן על Manage Consumer Details.
    image.png

  2. יש להעתיק את הקוד של הלקוח: Consumer Secret
    א. יש למלא אחר הוראות האימות בדוא"ל (או בכל אמצעי אחר שמנהל המערכת משתמש בו לאימות דו שלבי): לאחר קבל דוא"ל "אמת את זהותך ב- Salesforce " מ- Salesforce, יש להזין את קוד האימות וללחוץ על Verify.
    ב. יש להעתיק את קוד הלקוח למכשירכם.
    ג. יש ללחוץ על הלינק Back to Manage Connected Apps.

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

  1. יש לעבור אל GOTO > Setup > Apps > Connected Apps > Managed Connected Apps ולאחר מכן ללחוץ על Edit ליד אפליקציית "commbox_{{CORPRAT E_NAME}}".
    image.png

  2. בסעיף Permitted Users, יש לבחור ב- Admin approved users are pre-authorized.
    image.png

  3. לחצו על Save.

  4. יש לעבור שוב ל- GOTO > Setup > Apps > Connected Apps > Managed Connected Apps וללחוץ על אפליקציית "commbox_{{CORPRATE_NAME}}".

  5. יש לקבוע את הפרופילים הרלוונטיים וההרשאות הקבועות לארגונכם.

הקמת מוקד שיחות

יש להגדיר את שם האפליקציה המחוברת:

  1. בקונסולת Salesforce, יש לעבור אל GOTO > Setup > Call Center > Call Centers וללחוץ על כפתור Edit שלצד "CommBox".

  2. יש לעדכן את שדה CTI Adapter URL:
    https://{{SALESFORCE_DOMAIN_NAME}}.my.salesforce.com/apex/cmbx__CommboxDialer?app=commbox_{{CORPRATE_NAME}}

  3. יש ללחוץ על Save.

  4. בסעיף Call Center Users, יש ללחוץ על כפתור Manage Call Center Users על מנת להגדיר את הנציגים במוקד השיחות.
    image.png

  5. יש להוסיף משתמשים רלוונטיים למוקד השיחות (הרשאה לשימוש) על פי ההוראות בלינק הבא:
    https://help.salesforce.com/s/articleView?id=sf.cti_admin_manageagents.htm&type=5

  6. יש להגדיר את פעולות השיחות הנכנסות (מה יקרה כששיחה נכנסת ל- Salesforce) על פי ההוראות בלינק הבא:
    https://help.salesforce.com/s/articleView?id=sf.cti_admin_phonelayouts.htm&type=5

הוספת מוקד שיחות לאפליקציות

  1. בקונסולת Salesforce, יש לעבור אל GOTO > Setup > Apps > App Manager ולבחור באפליקציה המבוקשת מסוג "Lightning" (ברק).
  2. יש ללחוץ על כפתור ה- Edit ליד האפליקציה.
  3. תחת סעיף Utility items, יש ללחוץ על Add Utility Item ולבחור ב- Open CTI Softphone.
  4. תחת Utility Item Properties, יש לשנות את התווית ל- Commbox {{CORPRATE_NAME}} ולסמן את תיבת Start automatically (הפעלה אוטומטית), לאחר מכן, ללחוץ על Save.
    image.png

הפעלת Salesforce בקונסולת קומבוקס

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

  1. בפלטפורמת קומבוקס, יש לעבור להגדרות, ללחוץ על אייקון Salesforce CRM מסעיף החיבורים ולאחר מכן ללחוץ על התקן.
    image.png

image.png

  1. יש לבחור ב- חשבון סיילספורס חדש, בשדה חשבון סיילספורס. לאחר מכן תנותבו לסיילספורס להזנת פרטי המשתמש שלכם.
    image.png

  2. בסיילספורס יש להקליד את שם המשתמש ואישורי Salesforce (כמנהל).

  3. יש להזין את קוד הלקוח שהתקבל מ- Salesforce בסעיף 7 במסמך זה לתוך שדה Consumer Secret

  4. יש ללחוץ על Save.

  5. יש לחזור לדף ההגדרות > פרטיות ואבטחה לבחור בסעיף כללי.

  6. יש להפעיל את אפשר הצגת מערכת ניהול בתוך iFrame וללחוץ על שמור בתחתית המסך.
    image.png

הפעלת ערוץ

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

  1. בפלטפורמת קומבוקס, יש לעבור להגדרות וללחוץ על אייקון הצ'אט.
  2. יש לבחור בערוץ צ'אט ספציפי.
  3. יש לגלול לתחתית המסך ולבחור בקונקטור לSalesforce
  4. יש להדליק את הסעיפים השונים על מנת להפעיל את אינטגרצית סיילספורס בערוץ זה לפי הצרכים שלכם.

שימו לב: אם בחרתם לא להדליק את ה-'מתג עיקרי: חפש את הלקוח וצור רשומות בסיילספורס.' אנא צרו קשר עם מנהל הלקוח שלכם להתאמה אישית של האינטגרציה. (שאר האפשרויות תעבודנה רק בהינתן וישנם רשומות יעד בסיילספורס לצורך העברת תסריט השיחה, קבצים מצורפים וכו').
image.png

  1. עבור ערוצי צ'אט באינטרנט (צ'אט, צ'אט קולי, צ'אט וידאו) בלבד:
    א. יש לפתוח את קטגורית התחברות ולהגדיר את שדות החובה לערוץ זה: שם פרטי, שם משפחה, טלפון ודוא"ל. שימו לב שבעת שימוש בערוץ צ'אט, יש למלא את כל השדות כדי שהערוץ יעבוד
    image.png

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

  1. יש ללחוץ על שמור בתחתית העמוד.

בדיקת האינטגרציה

  1. בסיילספורס לחצו על כפתור הפתיחה של האפליקציה, יש לעבור לאפליקציה שבה הוספתם את מוקד השיחות: נניח במקרה שלנו Service Console
    image.png

  2. יש לחפש את לשונית CommBox {{CORPRATE_NAME}} בכותרת התחתונה:
    (לדוגמא commbox_talk במקרה שלנו)
    image.png

  3. יש ללחוץ כדי לראות את חלון השיחות של קומבוקס:
    image.png


האם מאמר זה היה מועיל?