Profils OAuth de messagerie et identifiants client Microsoft 365

Les profils OAuth pour les e-mails vous permettent de gérer les paramètres OAuth des comptes de messagerie dans Contact Center AI Platform (CCAI Platform). Au lieu d'utiliser une seule configuration OAuth globale pour tous les comptes OAuth IMAP, vous pouvez créer des profils OAuth pour les e-mails distincts et associer chaque compte de messagerie au profil qu'il doit utiliser.

Pour Microsoft 365, les profils OAuth pour les e-mails sont compatibles avec le type d'attribution des identifiants client. Ce type d'attribution s'authentifie au niveau de l'application au lieu de s'appuyer sur la connexion d'un utilisateur individuel. Il est particulièrement utile pour les boîtes aux lettres partagées, telles que support@company.com, car l'accès ne dépend pas du mot de passe, de la session de consentement ni du statut d'emploi d'un seul utilisateur administrateur.

Cette page explique comment configurer des profils OAuth pour les e-mails pour Microsoft 365 à l'aide d'identifiants client.

Code d'autorisation ou identifiants client

CCAI Platform est compatible avec les types d'attribution OAuth du code d'autorisation et des identifiants client pour les comptes de messagerie. Le tableau suivant compare ces types d'attribution :

Type de subvention Application idéale Fonctionnement
Code d'autorisation Boîtes aux lettres spécifiques à l'utilisateur Un administrateur ou un utilisateur de boîte aux lettres se connecte via le flux de consentement Microsoft OAuth consentement.
Identifiants client Boîtes aux lettres Microsoft 365 partagées ou gérées par une application CCAI Platform utilise un enregistrement d'application, un code secret du client et des autorisations au niveau de l'instance pour demander l'accès sans connexion interactive de l'utilisateur.

Chaque profil OAuth pour les e-mails utilise un seul type d'attribution. Si votre organisation a besoin de différents types d'attribution, fournisseurs ou configurations de boîte aux lettres, créez des profils OAuth pour les e-mails distincts et associez chaque compte de messagerie au profil approprié.

Avant de commencer

Assurez-vous de disposer des éléments suivants :

  • Une instance Microsoft 365.

  • Un accès administrateur Microsoft Entra.

  • Un compte administrateur CCAI Platform autorisé à gérer les paramètres de messagerie.

  • PowerShell installé en local.

  • Le module PowerShell ExchangeOnlineManagement installé.

  • L'ID d'instance Microsoft de votre annuaire.

Vous devez également savoir à quelle(s) boîte(s) aux lettres CCAI Platform doit accéder.

Créer un enregistrement d'application Microsoft Entra

CCAI Platform utilise l'enregistrement d'application Microsoft Entra pour demander des jetons OAuth pour l'accès aux e-mails Microsoft 365.

Pour créer un enregistrement d'application Microsoft Entra, procédez comme suit :

  1. Dans Microsoft Azure, accédez à Microsoft Entra ID > Inscription d'applications.

  2. Sélectionnez Nouvelle inscription.

  3. Saisissez un nom clair pour l'application, par exemple "CCAI Platform Email OAuth".

  4. Terminez l'enregistrement.

  5. Copiez l'ID (client) de l'application.

  6. Copiez l'ID d'annuaire (locataire).

Utilisez ces valeurs lorsque vous créez un profil OAuth pour les e-mails.

Créer un code secret du client

Pour créer un code secret du client, procédez comme suit :

  1. Dans l'enregistrement de l'application, accédez à Certificats et codes secrets.

  2. Créez un code secret de client.

  3. Copiez immédiatement la valeur du code secret.

Ajouter des autorisations d'API Microsoft

L'application a besoin d'une autorisation pour accéder aux e-mails et les envoyer via Exchange Online.

Pour ajouter des autorisations d'API Microsoft, procédez comme suit :

  1. Dans l'enregistrement de l'application, accédez à Autorisations d'API.

  2. Sélectionnez Ajouter une autorisation.

  3. Sélectionnez Office 365 Exchange Online.

  4. Sélectionnez Autorisations de l'application.

  5. Ajoutez les autorisations requises :

    • IMAP.AccessAsApp

    • SMTP.SendAsApp

  6. Si vous souhaitez que CCAI Platform affiche les boîtes aux lettres Microsoft 365 disponibles dans une liste déroulante, ajoutez les autorisations d'application Microsoft Graph requises pour lister les utilisateurs ou les boîtes aux lettres de votre instance.

  7. Sélectionnez Accorder le consentement administrateur pour votre organisation.

Vérifiez que les autorisations sont accordées avant de continuer.

Accorder l'accès de l'application à la boîte aux lettres

Une fois que l'application dispose des autorisations au niveau de l'instance, accordez-lui l'accès à la boîte aux lettres spécifique à laquelle CCAI Platform doit se connecter.

Pour accorder l'accès de l'application à la boîte aux lettres, procédez comme suit :

  1. Ouvrez PowerShell.

  2. Connectez-vous à Exchange Online :

    Connect-ExchangeOnline -Organization TENANT_ID
    

    Remplacez TENANT_ID par l'ID d'annuaire (locataire) de votre Microsoft 365.

  3. Enregistrez le compte de service dans Exchange :

    New-ServicePrincipal `
        -AppId APPLICATION_CLIENT_ID `
        -ObjectId OBJECT_ID
    

    Remplacez les éléments suivants :

    • APPLICATION_CLIENT_ID: ID (client) de l'application provenant de l'enregistrement de votre application Microsoft Entra

    • OBJECT_ID: ID d'objet provenant d'Applications d'entreprise

  4. Accordez l'accès à la boîte aux lettres :

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

    Remplacez les éléments suivants :

    • EMAIL_ADDRESS: adresse e-mail de la boîte aux lettres à laquelle CCAI Platform doit accéder

    • SERVICE_PRINCIPAL_ID : ID du compte de service

Créer un profil OAuth pour les e-mails dans CCAI Platform

Pour créer un profil OAuth pour les e-mails pour la configuration des identifiants client Microsoft 365, procédez comme suit :

  1. Dans le portail CCAI Platform, cliquez sur Settings > Developer Settings (Paramètres > Paramètres du développeur). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.

  2. Accédez au volet Email Account Management (Gestion des comptes de messagerie), puis cliquez sur Manage Email Account (Gérer le compte de messagerie). La page Email Account Management (Gestion des comptes de messagerie) s'affiche.

  3. Cliquez sur l'onglet Email OAuth.

  4. Cliquez sur Add Profile (Ajouter un profil).

  5. Dans le champ Name (Nom), saisissez un nom de profil.

  6. Dans la liste Grant Type (Type d'octroi), sélectionnez Client Credentials (Identifiants client).

  7. Dans le champ Token URL (URL du jeton), saisissez le point de terminaison du jeton Microsoft OAuth pour votre instance.

  8. Dans le champ Client ID (ID client), saisissez l'ID (client) de l'application provenant de Microsoft Entra.

  9. Dans le champ Client secret (Code secret du client), saisissez la valeur du code secret du client provenant de Microsoft Entra.

  10. Dans le champ Audience (Audience), saisissez l'audience.

  11. Dans le champ Scope (Champ d'application), saisissez le champ d'application.

  12. Dans le champ State (État), saisissez l'état.

  13. Dans le champ Access Type (Type d'accès), saisissez le type d'accès.

  14. Cliquez sur Save (Enregistrer).

Pour associer un compte de messagerie au profil OAuth, procédez comme suit :

  1. Dans le portail CCAI Platform, cliquez sur Settings > Developer Settings (Paramètres > Paramètres du développeur). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.

  2. Accédez au volet Email Account Management (Gestion des comptes de messagerie), puis cliquez sur Manage Email Account (Gérer le compte de messagerie). La page Email Account Management (Gestion des comptes de messagerie) s'affiche.

  3. Cliquez sur l'onglet Email account list (Liste des comptes de messagerie).

  4. Pour le compte de messagerie que vous souhaitez modifier, cliquez sur , puis sur Edit email account (Modifier le compte de messagerie).

  5. Dans la liste Email service (Service de messagerie), sélectionnez OAuth IMAP.

  6. Dans la liste OAuth Profile (Profil OAuth), sélectionnez le profil OAuth que vous avez créé lors de la procédure précédente.

  7. Cliquez sur Link (Associer).

  8. Dans la liste Email ID (ID de l'e-mail), sélectionnez votre boîte aux lettres.

  9. Cliquez sur Save (Enregistrer).

L'association confirme que CCAI Platform peut s'authentifier avec le profil OAuth sélectionné. La sélection de la boîte aux lettres indique à CCAI Platform quelle boîte aux lettres le compte de messagerie doit utiliser.

Si CCAI Platform ne parvient pas à récupérer la liste des boîtes aux lettres auprès de Microsoft, le formulaire revient à la saisie manuelle de l'adresse e-mail. Saisissez manuellement l'adresse de la boîte aux lettres, puis enregistrez le compte.

Dépannage

Problème Solution
La liste des boîtes aux lettres ne se charge pas Vérifiez que l'application Microsoft dispose des autorisations Microsoft Graph requises et du consentement de l'administrateur. Vous pouvez saisir manuellement la boîte aux lettres si la liste déroulante n'est pas disponible.
L'association échoue avec une erreur d'authentification Vérifiez que l'ID client, le code secret du client, l'ID d'instance et l'URL du jeton sont corrects. Vérifiez également que le code secret du client n'a pas expiré.
La boîte aux lettres ne peut pas envoyer ni recevoir d'e-mails Vérifiez que l'application dispose des autorisations de boîte aux lettres dans Exchange Online et que le compte de messagerie est associé au profil OAuth pour les e-mails approprié.