Configurer un espace de stockage externe pour les e-mails

La configuration d'un espace de stockage externe est obligatoire pour le canal de messagerie. Vous pouvez utiliser Cloud Storage ou Amazon S3 comme stockage externe.

Configurer Cloud Storage

Pour configurer Cloud Storage pour les e-mails, consultez Cloud Storage.

Assurez-vous que votre clé de compte de service JSON contient les champs suivants :

  • type: "service_account"

  • project_id

  • private_key_id

  • private_key

  • client_email

  • client_id

  • auth_uri

  • token_uri

  • auth_provider_x509_cert_url

  • Client_x509_cert_url

Configurer le stockage Amazon S3

Lorsque vous configurez l'authentification pour Amazon S3, Contact Center AI Platform (CCAI Platform) assume un rôle IAM (Identity and Access Management) que vous créez dans votre compte AWS. Ce rôle accorde à CCAI Platform les autorisations requises pour accéder à votre bucket Amazon S3.

La clé de compte de service JSON pour cette méthode d'authentification nécessite les champs suivants :

  • region : région AWS où se trouve votre bucket Amazon S3, par exemple "us-east-1".

  • role_arn : nom de ressource Amazon (ARN) du rôle IAM assumé par la plate-forme CCAI. Cet ARN identifie de manière unique le rôle qui a été configuré avec les règles d'accès appropriées.

  • external_id : identifiant que vous fournissez lors de la création de la stratégie de confiance pour le rôle. CCAI Platform transmet cet ID lorsqu'elle demande à assumer le rôle, ce qui garantit que seule l'entité prévue peut le faire.

Pour créer une clé de compte de service JSON Amazon S3, procédez comme suit :

  1. Connectez-vous à votre compte AWS.

  2. Accédez au tableau de bord IAM.

  3. Dans le tableau de bord IAM, sélectionnez Rôles, puis Créer un rôle.

  4. Pour configurer la relation d'approbation, procédez comme suit :

    1. Sélectionnez Un autre compte AWS comme entité de confiance.

    2. Saisissez l'ID de compte de l'entité qui assumera le rôle.

    3. Facultatif : Vous pouvez ajouter un ID externe pour renforcer la sécurité.

  5. Définissez les autorisations et associez une stratégie qui accorde au rôle les autorisations nécessaires pour votre bucket Amazon S3. Google recommande d'utiliser une stratégie avec le moindre privilège nécessaire (par exemple, un accès en lecture et en écriture à un bucket spécifique) plutôt qu'un accès complet à Amazon S3. Voici les autorisations Amazon S3 requises :

    • "s3:ListBucket",

    • "s3:GetObject"

    • "s3:PutObject",

    • "s3:DeleteObject"

  6. Suivez les instructions restantes pour créer le rôle. Vous recevrez un ARN de rôle.

  7. Pour créer le fichier JSON, utilisez l'ARN du rôle et un ID externe (le cas échéant), comme dans l'exemple suivant :

    {
  "region": "YOUR-AWS-REGION",
  "role_arn": "YOUR_ROLE_ARN",
  "external_id": "YOUR_EXTERNAL_ID"
}

Configurer le stockage des e-mails

Si vous utilisez Google Cloud comme serveur de données, assurez-vous que votre rôle Cloud Storage est défini sur Administrateur de l'espace de stockage pour éviter les erreurs lors de la configuration. Pour en savoir plus, consultez Rôles IAM pour Cloud Storage.

Pour configurer le stockage de vos e-mails, procédez comme suit :

  1. Sur le portail de la plate-forme CCAI, cliquez sur Settings> Developer Settings (Paramètres > Paramètres du développeur). Si le menu Paramètres ne s'affiche pas, cliquez sur Menu.

  2. Accédez à la section Email Account Management (Gestion des comptes de messagerie), puis cliquez sur Manage Email Account (Gérer le compte de messagerie).

  3. Dans la section Gestion des données, sélectionnez une durée de stockage des données.

  4. Dans la section Serveur de données, sélectionnez Google Cloud ou Amazon S3. Les mêmes informations sont requises pour les deux options :

    • Nom du bucket : saisissez le nom exact de votre bucket de stockage.

    • Clé de compte de service (fichier JSON) : importez le fichier de clé JSON pour votre compte de serviceGoogle Cloud ou Amazon S3.

    • Chemin du dossier : ce chemin est généré automatiquement. Lorsque vous associez un compte de messagerie, le système crée automatiquement un dossier dans le bucket que vous avez spécifié.

  5. Cliquez sur Tester la connexion pour vérifier que les identifiants et les détails du bucket sont corrects.

  6. Cliquez sur Enregistrer.

Le système est configuré pour stocker les données des comptes de messagerie associés. Le comportement suivant est attendu :

  • Synchronisation automatique des données : le système synchronise automatiquement les données des e-mails, y compris les métadonnées et les pièces jointes, de vos serveurs de messagerie vers le bucket de stockage configuré toutes les 45 secondes.

  • Surveillance de la connexion : le système surveille en permanence la connexion à votre espace de stockage et à vos serveurs de messagerie. Si une connexion ne peut pas être rétablie pendant plus de 30 minutes, un e-mail de notification automatique est envoyé aux administrateurs de votre instance. Le système dispose également d'une logique de nouvelle tentative automatique pour rétablir une connexion défaillante.

Règles de conservation des e-mails

La durée de stockage que vous définissez dans la section Gestion des données correspond à la durée pendant laquelle un e-mail est conservé dans votre bucket de stockage. Passé ce délai, l'e-mail est supprimé de l'espace de stockage. Si vous répondez à un fil de discussion par e-mail après la durée de stockage définie (par exemple, si la durée de stockage est définie sur 60 jours et que vous répondez le 61e jour), l'intégralité du fil de discussion par e-mail est récupérée à partir de votre serveur IMAP, y compris les pièces jointes. Toutefois, les e-mails datant de plus de trois ans ne sont pas visibles.