Configurare il canale email per OAuth con Gmail

Questa pagina spiega come utilizzare Google Cloud per creare le credenziali OAuth per configurare il canale email di Contact Center AI Platform (CCAI Platform).

Prima di iniziare

Assicurati di avere:

Inoltre, verifica che la fatturazione sia attivata per il tuo Google Cloud progetto. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti.

Creare le credenziali OAuth

Puoi utilizzare Google Cloud per creare le credenziali OAuth, ovvero l'ID client e il client secret. Se non hai ancora configurato una schermata per il consenso, devi farlo prima di poter creare le credenziali OAuth. Per saperne di più su OAuth, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Per creare le credenziali OAuth e configurare la schermata per il consenso:

  1. Nella Google Cloud console, vai alla dashboard del selettore di progetti e seleziona il progetto che vuoi utilizzare per creare le credenziali OAuth.

    Dashboard del selettore di progetti

  2. Vai alla pagina API e servizi e, nel menu di navigazione, fai clic su Credenziali.

    Credenziali

  3. Se non hai ancora configurato la schermata per il consenso per questo Google Cloud progetto, viene visualizzato il pulsante Configura schermata per il consenso. In questo caso, configura la schermata per il consenso utilizzando la seguente procedura. In caso contrario, vai al passaggio 4.

    1. Fai clic su Configura schermata per il consenso. Viene visualizzata la pagina Schermata per il consenso OAuth.

    2. A seconda del caso d'uso, seleziona Interno o Esterno e poi fai clic su Crea. Viene visualizzato il riquadro Schermata per il consenso OAuth.

    3. Inserisci le informazioni nella pagina Informazioni sull'app seguendo le istruzioni sullo schermo e poi fai clic su Salva e continua. Viene visualizzato il riquadro Ambiti.

    4. Fai clic su Aggiungi o rimuovi ambiti. Viene visualizzato il riquadro Aggiorna gli ambiti selezionati.

    5. Seleziona l'ambito o gli ambiti appropriati per il tuo caso d'uso e poi fai clic su Aggiorna.

    6. Fai clic su Salva e continua. Viene visualizzato il riquadro Utenti di test.

    7. Se vuoi aggiungere utenti per testare l'accesso alla tua app, fai clic su Aggiungi utenti. Viene visualizzato il riquadro Aggiungi utenti.

    8. Nel campo vuoto, aggiungi uno o più indirizzi email di account Google e poi fai clic su Aggiungi.

    9. Fai clic su Salva e continua. Viene visualizzato il riquadro Riepilogo.

    10. Esamina le informazioni della schermata per il consenso OAuth e poi fai clic su Torna alla dashboard.

    11. Se vuoi pubblicare subito l'app in produzione, fai clic su Pubblica app e poi su Conferma nella finestra di dialogo di conferma. La schermata per il consenso è configurata.

  4. Nel menu di navigazione, fai clic su Credenziali.

  5. Fai clic su Crea credenziali e poi su ID client OAuth.

  6. Nel campo Tipo di applicazione, fai clic su Applicazione web.

  7. Nel campo Nome, inserisci un nome per il client.

  8. Nell'area Origini JavaScript autorizzate, fai clic su Aggiungi IRI.

  9. Nel campo URI, inserisci https://TENANT_NAME.ccaiplatform.com, sostituendo TENANT_NAME con il nome del tenant.

  10. Nell'area URI di reindirizzamento autorizzati, fai clic su Aggiungi URI.

  11. Nel campo URI, inserisci https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback, sostituendo TENANT_NAME con il nome del tenant.

  12. Fai clic su Crea. Viene visualizzata la finestra di dialogo Client OAuth creato.

  13. Fai clic su Scarica JSON per scaricare sul computer un file JSON contenente l'ID client e il client secret, quindi fai clic su Ok.

Ottenere l'ID client e il client secret

Dopo aver creato le credenziali OAuth, puoi ottenere l'ID client e il client secret in qualsiasi momento.

Per ottenere l'ID client e il client secret:

  1. Nella Google Cloud console, vai alla pagina API e servizi. Nel menu di navigazione, fai clic su Credenziali.

    Credenziali

  2. Nell'area ID client OAuth 2.0, fai clic sul client per il quale vuoi ottenere l'ID client e il client secret. L'ID client e il client secret vengono visualizzati nell'area Informazioni aggiuntive.

Configurare le impostazioni SSO per il canale email

Utilizza l'ID client e il client secret che hai creato in Creare le credenziali OAuth per configurare le impostazioni Single Sign-On (SSO) per il canale email.

Per configurare le impostazioni SSO:

  1. Nel portale CCAI Platform, fai clic su Menu e poi su Impostazioni > Impostazioni sviluppatore.

  2. Vai al riquadro Gestione account email e poi fai clic su Gestisci account email.

  3. Nella pagina Gestione account email, fai clic su SSO email.

  4. Nel riquadro SSO email, configura le impostazioni come mostrato nel seguente elenco:

    • URL di autorizzazione. Inserisci https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent.

    • URL token. Inserisci https://oauth2.googleapis.com/token.

    • ID client. Inserisci l'ID client che hai creato in Creare le credenziali OAuth. Se non hai salvato l'ID client, consulta Ottenere l'ID client e il client secret.

    • Client secret. Inserisci il client secret che hai creato in Creare le credenziali OAuth. Se non hai salvato il tuo client secret, consulta Ottenere l'ID client e il client secret.

    • Ambito. Inserisci https://mail.google.com/.

    • Stato. Lascia vuoto questo campo.

    • Tipo di accesso. Inserisci offline.

    • Tipo di concessione. Inserisci Authorization Code.

    • Deseleziona la casella di controllo Include the Grant Type as part of the Authorization URL and Token URL (Includi il tipo di concessione come parte dell'URL di autorizzazione e dell'URL token).

    • Seleziona la casella di controllo Include the Redirect URL as part of the Authorization URL and Token URL (Includi l'URL di reindirizzamento come parte dell'URL di autorizzazione e dell'URL token) e poi fai clic su Salva. Il canale email è configurato per OAuth.