Configurer votre canal de messagerie pour OAuth avec Gmail

Cette page explique comment utiliser Google Cloud pour créer des identifiants OAuth afin de configurer votre canal de messagerie Contact Center AI Platform (CCAI Platform).

Avant de commencer

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

Assurez-vous également que la facturation est activée pour votre projet Google Cloud . Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets.

Créer des identifiants OAuth

Vous pouvez utiliser Google Cloud pour créer des identifiants OAuth (ID client et code secret du client). Si vous n'avez pas encore configuré d'écran de consentement, vous devez le faire avant de pouvoir créer des identifiants OAuth. Pour en savoir plus sur OAuth, consultez Utiliser OAuth 2.0 pour accéder aux API Google.

Pour créer des identifiants OAuth et configurer l'écran de consentement :

  1. Dans la console Google Cloud , accédez au tableau de bord du sélecteur de projet et sélectionnez le projet que vous souhaitez utiliser pour créer des identifiants OAuth.

    Tableau de bord du sélecteur de projet

  2. Accédez à la page API et services, puis cliquez sur Identifiants dans le menu de navigation.

    Identifiants

  3. Si vous n'avez pas encore configuré l'écran de consentement pour ce projet Google Cloud, le bouton Configurer l'écran de consentement s'affiche. Dans ce cas, configurez votre écran de consentement en suivant la procédure ci-dessous. Sinon, passez à l'étape 4.

    1. Cliquez sur Configurer l'écran d'autorisation. La page Écran de consentement OAuth s'affiche.

    2. Selon votre cas d'utilisation, sélectionnez Interne ou Externe, puis cliquez sur Créer. Le volet Écran de consentement OAuth s'affiche.

    3. Saisissez les informations sur la page Informations sur l'application en suivant les instructions à l'écran, puis cliquez sur Enregistrer et continuer. Le volet Champs d'application s'affiche.

    4. Cliquez sur Ajouter ou supprimer des niveaux d'accès. Le volet Mettre à jour les champs d'application sélectionnés s'affiche.

    5. Sélectionnez le ou les niveaux d'accès appropriés à votre cas d'utilisation, puis cliquez sur Mettre à jour.

    6. Cliquez sur Enregistrer et continuer. Le volet Utilisateurs de test s'affiche.

    7. Si vous souhaitez ajouter des utilisateurs pour tester l'accès à votre application, cliquez sur Ajouter des utilisateurs. Le volet Ajouter des utilisateurs s'affiche.

    8. Dans le champ vide, ajoutez une ou plusieurs adresses e-mail de comptes Google, puis cliquez sur Ajouter.

    9. Cliquez sur Enregistrer et continuer. Le volet Récapitulatif s'affiche.

    10. Vérifiez les informations de votre écran de consentement OAuth, puis cliquez sur Retour au tableau de bord.

    11. Si vous souhaitez publier votre application en version de production maintenant, cliquez sur Publier l'application, puis sur Confirmer dans la boîte de dialogue de confirmation. Votre écran d'autorisation est configuré.

  4. Dans le menu de navigation, cliquez sur Identifiants.

  5. Cliquez sur Créer des identifiants, puis sur ID client OAuth.

  6. Dans le champ Type d'application, cliquez sur Application Web.

  7. Dans le champ Nom, saisissez le nom de votre client.

  8. Dans la section Origines JavaScript autorisées, cliquez sur Ajouter un IRI.

  9. Dans le champ URI, saisissez https://TENANT_NAME.ccaiplatform.com en remplaçant TENANT_NAME par le nom de votre locataire.

  10. Dans la section URI de redirection autorisés, cliquez sur Ajouter un URI.

  11. Dans le champ URI, saisissez https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback en remplaçant TENANT_NAME par le nom de votre locataire.

  12. Cliquez sur Créer. La boîte de dialogue Client OAuth créé s'affiche.

  13. Cliquez sur Télécharger au format JSON pour télécharger sur votre ordinateur un fichier JSON contenant votre ID client et votre code secret du client, puis cliquez sur OK.

Obtenir votre ID client et votre code secret du client

Une fois que vous avez créé des identifiants OAuth, vous pouvez obtenir votre ID client et votre code secret du client à tout moment.

Pour obtenir votre ID client et votre code secret du client, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page API et services. Dans le menu de navigation, cliquez sur Identifiants.

    Identifiants

  2. Dans la section ID clients OAuth 2.0, cliquez sur le client pour lequel vous souhaitez obtenir l'ID client et le code secret du client. Votre ID client et votre code secret du client sont affichés dans la section Informations supplémentaires.

Configurer les paramètres SSO pour le canal de messagerie

Utilisez l'ID client et le code secret du client que vous avez créés dans Créer des identifiants OAuth pour configurer les paramètres d'authentification unique (SSO) pour le canal d'e-mail.

Pour configurer les paramètres SSO :

  1. Dans le portail CCAI Platform, cliquez sur Menu, puis sur Paramètres> Paramètres du développeur.

  2. Accédez au volet Gestion du compte de messagerie, puis cliquez sur Gérer le compte de messagerie.

  3. Sur la page Gestion des comptes de messagerie, cliquez sur SSO par e-mail.

  4. Dans le volet Authentification unique par e-mail, configurez les paramètres comme indiqué dans la liste suivante :

    • URL d'autorisation Saisissez https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent.

    • URL du jeton : Saisissez https://oauth2.googleapis.com/token.

    • ID client. Saisissez l'ID client que vous avez créé dans Créer des identifiants OAuth. Si vous n'avez pas enregistré votre ID client, consultez Obtenir votre ID client et votre code secret client.

    • Code secret du client. Saisissez le code secret du client que vous avez créé dans Créer des identifiants OAuth. Si vous n'avez pas enregistré votre code secret du client, consultez Obtenir votre ID client et votre code secret client.

    • Champ d'application : Saisissez https://mail.google.com/.

    • State. Laissez ce champ vide.

    • Type d'accès : Saisissez offline.

    • Type d'autorisation. Saisissez Authorization Code.

    • Décochez la case Inclure le type d'attribution dans l'URL d'autorisation et l'URL du jeton.

    • Cochez la case Inclure l'URL de redirection dans l'URL d'autorisation et l'URL du jeton, puis cliquez sur Enregistrer. Votre canal de messagerie est configuré pour OAuth.