הגדרת ערוץ האימייל ל-OAuth עם Microsoft Office 365

במאמר הזה נסביר איך להגדיר ערוץ אימייל ב-Contact Center AI Platform (פלטפורמת CCAI) כדי לתמוך ב-Microsoft OAuth.

דרישות מוקדמות

  1. חשבון Azure עם מינוי פעיל. צריך שיהיה לחשבון גישת ניהול ל-Microsoft Entra, ולכן הוא צריך להיות מוגדר כאחד מהתפקידים הבאים:

    • מנהל אפליקציות
    • מפַתח האפליקציה
    • אדמין של אפליקציות בענן

  2. דייר (tenant) ב-Microsoft Entra. הוראות ליצירת דייר מופיעות במדריך למתחילים של מיקרוסופט.

מוודאים שחשבון האימייל מאפשר IMAP ו-SMTP

פלטפורמת CCAI משתמשת ב-IMAP וב-SMTP כדי לשלוח ולקבל אימיילים מ-Microsoft. מכיוון שאפשר לקשר חשבון מיקרוסופט לתוכנות שונות, חשוב לוודא שתוכנות משניות אחרות לא חוסמות את IMAP או SMTP. בשלבים הבאים מוסבר איפה בדרך כלל בודקים ב-Microsoft.

  1. בחלונית הניווט הימנית, עוברים אל משתמשים > משתמשים פעילים.

  2. בוחרים משתמש לאימות.

  3. לוחצים על שליחה בדואר. אם מוצגת ההודעה "למשתמש הזה אין רישיון ל-Exchange Online", צריך לתת למשתמש רישיון מתאים לשימוש ב-Exchange. ללא רישיון מתאים, פלטפורמת CCAI לא תוכל לשלוח או לקבל אימיילים עבור חשבון המשתמש הזה.

  4. אחרי שמוסיפים רישיון מתאים, בוחרים באפשרות ניהול אפליקציות אימייל בכרטיסייה אימייל. מוודאים שהאפשרויות IMAP ו-Authenticated SMTP מסומנות.

  5. לוחצים על Save.

  6. עוברים אל תיבות דואר בחלונית הניווט הימנית.

  7. בוחרים את חשבון המשתמש שרוצים לבדוק.

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

רישום אפליקציה

  1. נכנסים למרכז הניהול של Microsoft Entra. אם יש לכם כמה דיירים, אתם יכולים להשתמש במסנן Directories + Subscriptions כדי לעבור לדייר הנכון.

  2. עוברים אל Identity > Applications > App registrations > New registration.

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

  4. מציינים את סוג החשבון שיכול להשתמש באפליקציה או בקהל הכניסה. יש תמיכה בכמה סוגי חשבונות:

    1. חשבונות רק בספרייה הארגונית הזו: בוחרים באפשרות הזו אם מפתחים אפליקציה לשימוש רק על ידי משתמשים (או אורחים) בדייר יחיד. האפליקציה הזו נקראת לפעמים אפליקציה של קו עסקי (LOB).

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

    3. חשבונות בכל ספרייה ארגונית וחשבונות מיקרוסופט אישיים: בוחרים באפשרות הזו אם רוצים שמשתמשים בכל דייר יוכלו להשתמש באפליקציה הזו, וגם משתמשים שיש להם חשבונות מיקרוסופט אישיים.

    4. חשבונות מיקרוסופט אישיים: בוחרים באפשרות הזו אם רוצים ליצור אפליקציה רק למשתמשים שיש להם חשבונות מיקרוסופט אישיים. כולל חשבונות Microsoft,‏ Skype,‏ Xbox,‏ Live ו-Hotmail.

  5. ב-Redirect URI, בוחרים באפשרות Web ומזינים את כתובת האתר https://{tenant}.ccaiplatform.com/v1/email_accounts/oauth_callback. מחליפים את {tenant} בשם הדייר שלכם ב-CCAI Platform.

  6. לוחצים על Register כדי להשלים את הרישום הראשוני של האפליקציה.

  7. אחרי שתשלימו את ההרשמה, יוצג המסך סקירה כללית. חשוב לשים לב למידע הבא, שתצטרכו להזין כשתוכלו להשלים את התהליך ב-CCAI Platform:

    • מזהה האפליקציה (אפליקציית הלקוח)
    • מזהה הספרייה (הדייר)

הפעלת האפליקציה

  1. נכנסים למרכז הניהול של Microsoft Entra.

  2. עוברים אל Identity > Applications > Enterprise Applications ובוחרים את האפליקציה.

  3. עוברים אל מאפיינים.

  4. מעבירים את המתג האם התוצאה גלויה למשתמשים? למצב כן.

הוספת פרטי כניסה לאפליקציה

יוצרים סוד לקוח לשימוש בפלטפורמת CCAI Platform.

  1. נכנסים למרכז הניהול של Microsoft Entra.

  2. עוברים אל Identity > Applications > App registrations ובוחרים את האפליקציה.

  3. עוברים אל Certificates & secrets > Client secrets > New client secret. תיפתח חלונית שבה תוכלו לתת שם לסוד.

  4. מוסיפים תיאור לסוד הלקוח.

  5. בוחרים תאריך תפוגה לסוד או מציינים משך חיים בהתאמה אישית. תוקף הסוד של הלקוח מוגבל לשנתיים (24 חודשים) או פחות, אבל מיקרוסופט ממליצה להגדיר ערך תפוגה של פחות מ-12 חודשים.

  6. לוחצים על הוספה. רושמים את הערך של הסוד. תצטרכו אותו כדי להשלים את התהליך ב-CCAI Platform.

הוספת הרשאות API

ממשק Graph API מאפשר לטוקנים של גישה לעבוד עם IMAP, שנדרש להפעלה של ערוץ האימייל בפלטפורמת CCAI.

  1. נכנסים למרכז הניהול של Microsoft Entra.

  2. עוברים אל Identity > Applications > App registrations ובוחרים את האפליקציה.

  3. בוחרים באפשרות הרשאות ל-API > הוספת הרשאה.

  4. בוחרים באפשרות Microsoft Graph.

  5. לוחצים על הרשאות שהוקצו. משתמשים בסרגל החיפוש Select permissions כדי לבצע את החיפושים הבאים ולסמן את התיבות לצד התוצאות המתאימות:

    • ‫IMAP: מסמנים את התיבה IMAP.AccessAsUser.All
    • ‫offline: בדיקת offline_access
    • ‫openid: בדיקה openid
    • smtp: SMTP.Send

  6. לחץ על Add permissions.

הוספת פרטי כניסה ל-CCAI Platform

אחרי שמסיימים את ההגדרה של מיקרוסופט, משתמשים במידע מתהליך ההגדרה כדי להשלים את החיבור בין שתי התוכנות ב-CCAI Platform. עוברים אל הגדרות > ניהול חשבון אימייל > אימייל SO ומזינים את הפרטים הבאים:

סוג הגישה: משאירים את השדה ריק.

כתובת ה-URL של ההרשאה: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize. ‫{tenant_id} הוא מזהה הספרייה (הדייר) מאפליקציית Microsoft.

Token URL: https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. ‫{tenant_id} הוא מזהה הספרייה (הדייר) מאפליקציית Microsoft.

Client ID: מזהה האפליקציה (לקוח) מאפליקציית מיקרוסופט.

סוד לקוח: הערך של סוד הלקוח מהאפליקציה של מיקרוסופט.

היקף: מזינים את הערכים הבאים. לא צריך להפריד ביניהם בפסיקים, אבל הם חייבים להופיע כולם.

  • openid email offline_access
  • https://outlook.office.com/IMAP.AccessAsUser.All
  • https://outlook.office.com/SMTP.Send

מדינה: משאירים את השדה ריק.

סוג הגישה: משאירים את השדה ריק.

‫Grant Type: Authorization Code

מבטלים את הסימון של האפשרות 'הכללת סוג ההרשאה כחלק מכתובת ה-URL להרשאה ומכתובת ה-URL של האסימון'.

מסמנים את התיבה 'הכללת כתובת ה-URL של ההפניה לכתובת URL אחרת כחלק מכתובת ה-URL לאישור ומכתובת ה-URL של הטוקן'.

לוחצים על Save.