פרופילים של OAuth באימייל ופרטי כניסה של לקוח ב-Microsoft 365

פרופילים של OAuth לאימייל מאפשרים לכם לנהל את הגדרות ה-OAuth של חשבונות אימייל ב-Contact Center AI Platform (פלטפורמת CCAI). במקום להשתמש בהגדרת OAuth גלובלית אחת לכל חשבונות ה-IMAP עם OAuth, אפשר ליצור פרופילים נפרדים של OAuth לאימייל ולקשר כל חשבון אימייל לפרופיל שבו הוא צריך להשתמש.

ב-Microsoft 365, פרופילי OAuth של אימייל תומכים בסוג ההרשאה של פרטי הכניסה של הלקוח. סוג ההרשאה הזה מאמת ברמת האפליקציה, במקום להסתמך על כניסה של משתמש ספציפי. השיטה הזו שימושית במיוחד לתיבות דואר משותפות, כמו support@company.com, כי הגישה לא תלויה בסיסמה של משתמש אדמין אחד, בסשן ההסכמה או בסטטוס ההעסקה שלו.

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

קוד הרשאה לעומת פרטי כניסה של לקוח

פלטפורמת CCAI תומכת בסוגי ההרשאות של OAuth: קוד הרשאה ופרטי כניסה של לקוחה לחשבונות אימייל. בטבלה הבאה מוצגת השוואה בין סוגי ההרשאות האלה:

סוג המענק למי זה מתאים איך זה עובד
קוד הרשאה תיבות דואר ספציפיות למשתמשים אדמין או משתמש בתיבת דואר נכנסים דרך תהליך ההסכמה של Microsoft OAuth.
פרטי כניסה של לקוח תיבות דואר משותפות או תיבות דואר שמנוהלות על ידי אפליקציה ב-Microsoft 365 פלטפורמת CCAI משתמשת ברישום אפליקציה, בסוד לקוח ובהרשאות ברמת המופע כדי לבקש גישה ללא כניסה אינטראקטיבית של משתמש.

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

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

חשוב לוודא שיש לכם את הפריטים הבאים:

  • מופע של Microsoft 365.

  • גישת אדמין ל-Microsoft Entra.

  • חשבון אדמין ב-CCAI Platform עם הרשאה לנהל את הגדרות האימייל.

  • ‫PowerShell מותקן באופן מקומי.

  • מודול PowerShell‏ ExchangeOnlineManagement הותקן.

  • מזהה המופע של מיקרוסופט בספרייה שלכם.

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

יצירת רישום אפליקציה ב-Microsoft Entra

פלטפורמת CCAI משתמשת ברישום אפליקציה ב-Microsoft Entra כדי לבקש אסימוני OAuth לגישה לאימייל ב-Microsoft 365.

כדי לרשום אפליקציה ב-Microsoft Entra:

  1. ב-Microsoft Azure, עוברים אל Microsoft Entra ID > App registrations.

  2. בוחרים באפשרות New registration.

  3. מזינים שם ברור לאפליקציה, למשל CCAI Platform Email OAuth.

  4. משלימים את ההרשמה.

  5. מעתיקים את מה שכתוב בשדה Application (client) ID.

  6. מעתיקים את מזהה הספרייה (הדייר).

משתמשים בערכים האלה כשיוצרים פרופיל OAuth לאימייל.

יצירת סוד לקוח

כדי ליצור סוד לקוח, פועלים לפי השלבים הבאים:

  1. במסגרת רישום האפליקציה, עוברים אל Certificates & secrets.

  2. יוצרים סוד לקוח חדש.

  3. צריך להעתיק את ערך הסוד באופן מיידי.

לפני שיוצאים מהדף.

הוספת הרשאות ל-Microsoft API

האפליקציה צריכה הרשאה לגשת לאימייל ולשלוח אימייל דרך Exchange Online.

כדי להוסיף הרשאות ל-API של מיקרוסופט:

  1. ברישום האפליקציה, עוברים אל API permissions (הרשאות API).

  2. בוחרים באפשרות הוספת הרשאה.

  3. בוחרים באפשרות Office 365 Exchange Online.

  4. בוחרים באפשרות הרשאות לאפליקציה.

  5. מוסיפים את ההרשאות הנדרשות:

    • IMAP.AccessAsApp

    • SMTP.SendAsApp

  6. אם רוצים ש-CCAI Platform יציג תיבות דואר זמינות של Microsoft 365 בתפריט נפתח, צריך להוסיף את הרשאות האפליקציה של Microsoft Graph שנדרשות כדי להציג רשימה של משתמשים או תיבות דואר עבור המופע שלכם.

  7. בוחרים באפשרות Grant admin consent for your organization (מתן הסכמת אדמין לארגון).

לפני שממשיכים, צריך לוודא שההרשאות מופיעות כהרשאות שניתנו.

מתן גישה לאפליקציה לתיבת הדואר

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

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

  1. פותחים את PowerShell.

  2. התחברות ל-Exchange Online:

    Connect-ExchangeOnline -Organization TENANT_ID
    

    מחליפים את TENANT_ID במזהה הספרייה (הדייר) שלכם ב-Microsoft 365.

  3. רושמים את נציג השירות ב-Exchange:

    New-ServicePrincipal `
        -AppId APPLICATION_CLIENT_ID `
        -ObjectId OBJECT_ID
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫APPLICATION_CLIENT_ID: מזהה האפליקציה (הלקוח) מרישום האפליקציה ב-Microsoft Entra

    • ‫OBJECT_ID: מזהה האובייקט מתוך אפליקציות ארגוניות

  4. הענקת גישה לתיבת הדואר:

    Add-MailboxPermission `
        -Identity EMAIL_ADDRESS `
        -User SERVICE_PRINCIPAL_ID `
        -AccessRights FullAccess
    

    מחליפים את מה שכתוב בשדות הבאים:

    • EMAIL_ADDRESS: כתובת האימייל של תיבת הדואר שפלטפורמת CCAI צריכה לגשת אליה

    • ‫SERVICE_PRINCIPAL_ID: המזהה של נציג השירות

יצירת פרופיל OAuth לאימייל ב-CCAI Platform

כדי ליצור פרופיל OAuth לאימייל עבור הגדרת פרטי הכניסה של לקוח Microsoft 365:

  1. בפורטל של CCAI Platform, לוחצים על הגדרות > הגדרות למפתחים. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.

  2. עוברים לחלונית ניהול חשבון אימייל ולוחצים על ניהול חשבון אימייל. מופיע הדף Email Account Management.

  3. לוחצים על הכרטיסייה Email OAuth (אימות OAuth לאימייל).

  4. לוחצים על הוספת פרופיל.

  5. בשדה Name, מזינים שם לפרופיל.

  6. ברשימה Grant Type, בוחרים באפשרות Client Credentials.

  7. בשדה כתובת ה-URL של האסימון, מזינים את נקודת הקצה של אסימון Microsoft OAuth עבור המופע שלכם.

  8. בשדה מזהה לקוח, מזינים את מזהה האפליקציה (הלקוח) מ-Microsoft Entra.

  9. בשדה Client secret (סוד הלקוח), מזינים את הערך של סוד הלקוח מ-Microsoft Entra.

  10. בשדה קהל, מזינים את הקהל.

  11. בשדה Scope (היקף), מזינים את ההיקף.

  12. בשדה State (מדינה), מזינים את המדינה.

  13. בשדה סוג הגישה, מזינים את סוג הגישה.

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

כדי לקשר חשבון אימייל לפרופיל OAuth, פועלים לפי השלבים הבאים:

  1. בפורטל של CCAI Platform, לוחצים על הגדרות > הגדרות למפתחים. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.

  2. עוברים לחלונית ניהול חשבון אימייל ולוחצים על ניהול חשבון אימייל. מופיע הדף Email Account Management.

  3. לוחצים על הכרטיסייה רשימת חשבונות אימייל.

  4. בחשבון האימייל שרוצים לערוך, לוחצים על ואז על עריכת חשבון אימייל.

  5. ברשימה שירות אימייל, בוחרים באפשרות OAuth IMAP.

  6. ברשימה OAuth Profile, בוחרים את פרופיל ה-OAuth שיצרתם בהליך הקודם.

  7. לוחצים על קישור.

  8. ברשימה Email ID, בוחרים את תיבת הדואר.

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

הקישור מאשר שפלטפורמת CCAI יכולה לבצע אימות באמצעות פרופיל OAuth שנבחר. הבחירה של תיבת הדואר מציינת ל-CCAI Platform באיזו תיבת דואר חשבון האימייל צריך להשתמש.

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

פתרון בעיות

שגיאה רזולוציה
רשימת תיבות הדואר לא נטענת מוודאים שלאפליקציית מיקרוסופט יש את ההרשאות הנדרשות של Microsoft Graph והסכמת אדמין. אם התפריט הנפתח לא זמין, אפשר להזין את תיבת הדואר באופן ידני.
הקישור נכשל עם שגיאת אימות מוודאים שמספר הלקוח, הסוד של הלקוח, מזהה המכונה וכתובת ה-URL של האסימון נכונים. כדאי גם לוודא שתוקף הסוד של הלקוח לא פג.
אין אפשרות לשלוח או לקבל אימיילים בתיבת הדואר מוודאים שיש לאפליקציה הרשאות לתיבת הדואר ב-Exchange Online ושהחשבון האימייל מקושר לפרופיל הנכון של OAuth לאימייל.