Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Profili OAuth email e credenziali client Microsoft 365

I profili OAuth per email consentono di gestire le impostazioni OAuth per gli account email in Contact Center AI Platform (CCAI Platform). Anziché utilizzare una singola configurazione OAuth globale per tutti gli account IMAP OAuth, puoi creare profili OAuth per email separati e collegare ogni account email al profilo che deve utilizzare.

Per Microsoft 365, i profili OAuth per email supportano il tipo di concessione delle credenziali client. Questo tipo di concessione esegue l'autenticazione a livello di applicazione anziché basarsi sull'accesso di un singolo utente. È particolarmente utile per le caselle di posta condivise, ad esempio support@company.com, perché l'accesso non dipende dalla password, dalla sessione di consenso o dallo stato lavorativo di un utente amministratore.

Questa pagina mostra come configurare i profili OAuth per email per Microsoft 365 utilizzando le credenziali client.

Codice di autorizzazione rispetto alle credenziali client

CCAI Platform supporta i tipi di autorizzazione con OAuth del codice di autorizzazione e delle credenziali client per gli account email. La seguente tabella mette a confronto questi tipi di concessione:

Tipo di autorizzazione	Ideale per	Come funziona
Codice di autorizzazione	Caselle di posta specifiche dell'utente	Un amministratore o un utente della casella di posta accede tramite il flusso di consenso OAuth di Microsoft.
Credenziali client	Caselle di posta di Microsoft 365 condivise o gestite dall'applicazione	CCAI Platform utilizza una registrazione dell'app, un client secret e autorizzazioni a livello di istanza per richiedere l'accesso senza l'accesso interattivo dell'utente.

Ogni profilo OAuth per email utilizza un tipo di concessione. Se la tua organizzazione ha bisogno di tipi di concessione, provider o configurazioni delle caselle di posta diversi, crea profili OAuth per email separati e collega ogni account email al profilo appropriato.

Prima di iniziare

Assicurati di avere quanto segue:

Un'istanza di Microsoft 365.
Accesso amministratore a Microsoft Entra.
Un account amministratore di CCAI Platform con l'autorizzazione a gestire le impostazioni email.
PowerShell installato localmente.
Il modulo PowerShell ExchangeOnlineManagement installato.
L'ID istanza Microsoft per la tua directory.

Devi anche sapere a quali caselle di posta deve accedere CCAI Platform.

Creare una registrazione dell'app Microsoft Entra

CCAI Platform utilizza la registrazione dell'app Microsoft Entra per richiedere i token OAuth per l'accesso email a Microsoft 365.

Per creare una registrazione dell'app Microsoft Entra:

In Microsoft Azure, vai a Microsoft Entra ID > Registrazioni app.
Seleziona Nuova registrazione.
Inserisci un nome chiaro per l'app, ad esempio CCAI Platform Email OAuth.
Completa la registrazione.
Copia l'ID applicazione (client).
Copia l'ID directory (tenant).

Utilizza questi valori quando crei un profilo OAuth per email.

Creare un client secret

Per creare un client secret:

Nella registrazione dell'app, vai a Certificati e secret.
Crea un nuovo client secret.
Copia immediatamente il valore del secret.

Aggiungere le autorizzazioni API Microsoft

L'app deve disporre dell'autorizzazione per accedere e inviare email tramite Exchange Online.

Per aggiungere le autorizzazioni API Microsoft:

Nella registrazione dell'app, vai ad Autorizzazioni API.
Seleziona Aggiungi un'autorizzazione.
Seleziona Office 365 Exchange Online.
Scegli Autorizzazioni applicazione.
Aggiungi le autorizzazioni richieste:
- IMAP.AccessAsApp
- SMTP.SendAsApp
Se vuoi che CCAI Platform mostri le caselle di posta di Microsoft 365 disponibili in un elenco a discesa, aggiungi le autorizzazioni dell'applicazione Microsoft Graph necessarie per elencare gli utenti o le caselle di posta per la tua istanza.
Seleziona Concedi il consenso amministratore per la tua organizzazione.

Prima di continuare, verifica che le autorizzazioni siano state concesse.

Concedere all'app l'accesso alla casella di posta

Dopo che l'app ha le autorizzazioni a livello di istanza, concedile l'accesso alla casella di posta specifica a cui deve connettersi CCAI Platform.

Per concedere all'app l'accesso alla casella di posta:

Apri PowerShell.
Connettiti a Exchange Online:
```
Connect-ExchangeOnline -Organization TENANT_ID
```
Sostituisci TENANT_ID con l'ID directory (tenant) di Microsoft 365.
Registra l'entità servizio in Exchange:
```
New-ServicePrincipal `
    -AppId APPLICATION_CLIENT_ID `
    -ObjectId OBJECT_ID
```
Sostituisci quanto segue:
- APPLICATION_CLIENT_ID: l'ID applicazione (client) della registrazione dell'app Microsoft Entra
- OBJECT_ID: l'ID oggetto di Applicazioni aziendali
Concedi l'accesso alla casella di posta:
```
Add-MailboxPermission `
    -Identity EMAIL_ADDRESS `
    -User SERVICE_PRINCIPAL_ID `
    -AccessRights FullAccess
```
Sostituisci quanto segue:
- EMAIL_ADDRESS: l'indirizzo email della casella di posta a cui deve accedere CCAI Platform
- SERVICE_PRINCIPAL_ID: l'ID entità servizio
Nota: per ottenere l'ID entità servizio (o visualizzare le entità servizio registrate), esegui Get-ServicePrincipal | fl in PowerShell.

Creare un profilo OAuth per email in CCAI Platform

Per creare un profilo OAuth per email per la configurazione delle credenziali client di Microsoft 365:

Nel portale di CCAI Platform, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Vai al riquadro Gestione account email e fai clic su Gestisci account email. Viene visualizzata la pagina Gestione account email.
Fai clic sulla scheda OAuth per email.
Fai clic su Aggiungi profilo.
Nel campo Nome, inserisci un nome per il profilo.
Nell'elenco Tipo di autorizzazione, seleziona Credenziali client.
Nel campo URL token, inserisci l'endpoint del token OAuth di Microsoft per la tua istanza.
Nel campo ID client, inserisci l'ID applicazione (client) di Microsoft Entra.
Nel campo Client secret, inserisci il valore del client secret di Microsoft Entra.
Nel campo Pubblico, inserisci il pubblico.
Nel campo Ambito, inserisci l'ambito.
Nel campo Stato, inserisci lo stato.
Nel campo Tipo di accesso, inserisci il tipo di accesso.
Fai clic su Salva.

Collegare un account email al profilo OAuth

Per collegare un account email al profilo OAuth:

Nel portale di CCAI Platform, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Vai al riquadro Gestione account email e fai clic su Gestisci account email. Viene visualizzata la pagina Gestione account email.
Fai clic sulla scheda Elenco account email.
Per l'account email che vuoi modificare, fai clic su e poi su Modifica account email.
Nell'elenco Servizio email, seleziona IMAP OAuth.
Nell'elenco Profilo OAuth, seleziona il profilo OAuth che hai creato nella procedura precedente.
Fai clic su Collega.
Nell'elenco ID email, seleziona la tua casella di posta.
Fai clic su Salva.

Il collegamento conferma che CCAI Platform può eseguire l'autenticazione con il profilo OAuth selezionato. La selezione della casella di posta indica a CCAI Platform quale casella di posta deve utilizzare l'account email.

Se CCAI Platform non riesce a recuperare l'elenco delle caselle di posta da Microsoft, il modulo torna all'inserimento manuale dell'indirizzo email. Inserisci manualmente l'indirizzo della casella di posta, quindi salva l'account.

Risoluzione dei problemi

Problema	Risoluzione
L'elenco delle caselle di posta non viene caricato	Verifica che l'app Microsoft disponga delle autorizzazioni Microsoft Graph richieste e del consenso amministratore. Se l'elenco a discesa non è disponibile, puoi inserire manualmente la casella di posta.
Il collegamento non riesce a causa di un errore di autenticazione	Verifica che l'ID client, il client secret, l'ID istanza e l'URL del token siano corretti. Verifica anche che il client secret non sia scaduto.
La casella di posta non può inviare o ricevere email	Verifica che l'app disponga delle autorizzazioni per la casella di posta in Exchange Online e che l'account email sia collegato al profilo OAuth per email corretto.