Configura lo spazio di archiviazione esterno per le email

La configurazione dello spazio di archiviazione esterno è un requisito per il canale email. Puoi utilizzare Cloud Storage o Amazon S3 come spazio di archiviazione esterno.

Configurazione di Cloud Storage

Per configurare Cloud Storage per le email, consulta Cloud Storage.

Assicurati che la chiave JSON del account di servizio contenga i seguenti campi:

  • 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

Configura lo spazio di archiviazione Amazon S3

Quando configuri l'autenticazione per Amazon S3, Contact Center AI Platform (CCAI Platform) assume un ruolo Identity and Access Management (IAM) che crei nel tuo account AWS. Questo ruolo concede alla piattaforma CCAI le autorizzazioni necessarie per accedere al tuo bucket Amazon S3.

La chiave JSON del account di servizio per questo metodo di autenticazione richiede i seguenti campi:

  • region: la regione AWS in cui si trova il bucket Amazon S3, ad esempio "us-east-1".

  • role_arn: l'Amazon Resource Name (ARN) del ruolo IAM assunto dalla piattaforma CCAI. Questo ARN identifica in modo univoco il ruolo che è stato configurato con le policy di accesso appropriate.

  • external_id: un identificatore che fornisci durante la creazione della policy di attendibilità per il ruolo. La piattaforma CCAI trasmette questo ID quando richiede di assumere il ruolo, garantendo che solo l'entità prevista possa farlo.

Per creare una chiave JSON del account di servizio Amazon S3, segui questi passaggi:

  1. Accedi al tuo account AWS.

  2. Vai alla dashboard IAM.

  3. Nella dashboard IAM, seleziona Ruoli, quindi Crea ruolo.

  4. Per configurare la relazione di trust, segui questi passaggi:

    1. Seleziona Another AWS account (Un altro account AWS) come entità attendibile.

    2. Inserisci l'ID account dell'entità che assumerà il ruolo.

    3. (Facoltativo) Puoi aggiungere un ID esterno per un ulteriore livello di sicurezza.

  5. Imposta le autorizzazioni, collega una policy che conceda al ruolo le autorizzazioni necessarie per il tuo bucket Amazon S3. Google consiglia di utilizzare una policy con il privilegio minimo necessario (ad esempio, accesso in lettura e scrittura a un bucket specifico) anziché l'accesso completo ad Amazon S3. Di seguito sono riportate le autorizzazioni Amazon S3 richieste:

    • "s3:ListBucket",

    • "s3:GetObject",

    • "s3:PutObject",

    • "s3:DeleteObject"

  6. Segui i prompt rimanenti per creare il ruolo. Ti verrà fornito un ARN del ruolo.

  7. Per creare il file JSON, utilizza l'ARN del ruolo e un ID esterno (se utilizzato) come nell'esempio seguente:

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

Configura lo spazio di archiviazione delle email

Se utilizzi Google Cloud come server di dati, assicurati che il tuo ruolo Cloud Storage sia impostato su Amministratore Storage per evitare errori durante la configurazione. Per saperne di più, consulta Ruoli IAM per Cloud Storage.

Per configurare lo spazio di archiviazione delle email, segui questi passaggi:

  1. Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.

  2. Vai alla sezione Email Account Management (Gestione account email), quindi fai clic su Manage Email Account (Gestisci account email).

  3. Nella sezione Gestione dei dati, seleziona una durata di archiviazione dei dati.

  4. Nella sezione Server dati, seleziona Google Cloud o Amazon S3. Per entrambe le opzioni sono richieste le stesse informazioni:

    • Nome bucket: inserisci il nome esatto del bucket di archiviazione.

    • Chiave del service account (file JSON): carica il file della chiave JSON per il tuo account di servizio accountGoogle Cloud o Amazon S3.

    • Percorso cartella: questo percorso viene generato automaticamente. Quando colleghi un account email, il sistema crea automaticamente una cartella all'interno del bucket specificato.

  5. Fai clic su Verifica connessione per verificare che le credenziali e i dettagli del bucket siano corretti.

  6. Fai clic su Salva.

Il sistema è configurato per archiviare i dati delle email degli account collegati. Puoi aspettarti il seguente comportamento:

  • Sincronizzazione automatica dei dati: il sistema sincronizza automaticamente i dati delle email, inclusi i metadati e gli allegati, dai tuoi server di posta al bucket di archiviazione configurato ogni 45 secondi.

  • Monitoraggio della connessione: il sistema monitora costantemente la connessione allo spazio di archiviazione email e ai server email. Se non è possibile ristabilire una connessione per più di 30 minuti, viene inviata un'email di notifica automatica agli utenti amministratori della tua istanza. Il sistema dispone anche di una logica di nuovo tentativo automatico per ristabilire una connessione non riuscita.

Policy di conservazione delle email

La durata di archiviazione impostata nella sezione Gestione dei dati rappresenta il periodo di tempo in cui un'email viene conservata nel bucket di archiviazione. Trascorso questo periodo, l'email viene eliminata dallo spazio di archiviazione. Se rispondi a un thread di email dopo il tempo di archiviazione impostato (ad esempio, il tempo di archiviazione è impostato su 60 giorni e rispondi il giorno 61), l'intero thread di email viene recuperato dal server IMAP, inclusi eventuali allegati. Tuttavia, le email risalenti a più di tre anni prima non sono visibili.