Configurare il canale email per OAuth con Gmail

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

Prima di iniziare

Assicurati di disporre di quanto segue:

Inoltre, assicurati che la fatturazione sia abilitata per il tuo progetto Google Cloud . Per maggiori informazioni, consulta Verifica lo stato di fatturazione dei progetti.

Crea 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 console Google Cloud , vai alla dashboard del selettore di progetti e seleziona il progetto che vuoi utilizzare per creare le credenziali OAuth.

    Dashboard del selettore dei progetti

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

    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 di 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, quindi 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, quindi 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 dagli account Google e poi fai clic su Aggiungi.

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

    10. Rivedi le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.

    11. Se vuoi pubblicare subito la tua app in produzione, fai clic su Pubblica app, quindi 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 tuo 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 tuo tenant.

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

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

Ottieni 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 console Google Cloud , 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 cui 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 Crea credenziali OAuth per configurare le impostazioni Single Sign-On (SSO) per il canale email.

Per configurare le impostazioni SSO:

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

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

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

  4. Nel riquadro SSO via 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 del token. Inserisci https://oauth2.googleapis.com/token.

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

    • Client secret. Inserisci il client secret che hai creato in Crea credenziali OAuth. Se non hai salvato il 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 Includi il tipo di concessione come parte dell'URL di autorizzazione e dell'URL token.

    • Seleziona la casella di controllo Includi l'URL di reindirizzamento nell'URL di autorizzazione e nell'URL token, quindi fai clic su Salva. Il tuo canale email è configurato per OAuth.