Configurar o armazenamento externo para e-mails

A configuração do armazenamento externo é um requisito para o canal de e-mail. É possível usar o Cloud Storage ou o Amazon S3 como armazenamento externo.

Configurar o Cloud Storage

Para configurar o Cloud Storage para e-mail, consulte Cloud Storage.

Verifique se a chave JSON da conta de serviço contém os seguintes campos:

  • 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

Configurar o armazenamento do Amazon S3

Quando você configura a autenticação para o Amazon S3, a Contact Center AI Platform (CCAI Platform) assume um papel do Identity and Access Management (IAM) que você cria na sua conta da AWS. Esse papel concede à CCAI Platform as permissões necessárias para acessar o bucket do Amazon S3.

A chave JSON da conta de serviço para esse método de autenticação requer os seguintes campos:

  • region: a região da AWS em que o bucket do Amazon S3 está localizado. Por exemplo, "us-east-1".

  • role_arn: o nome do recurso da Amazon (ARN) do papel do IAM que a plataforma CCAI assume. Esse ARN identifica exclusivamente o papel que foi configurado com as políticas de acesso adequadas.

  • external_id: um identificador que você fornece ao criar a política de confiança para o papel. A CCAI Platform transmite esse ID quando solicita assumir o papel, garantindo que apenas a entidade pretendida possa fazer isso.

Para criar uma chave de conta de serviço JSON do Amazon S3, siga estas etapas:

  1. Faça login na sua conta da AWS.

  2. Acesse o Painel do IAM.

  3. No Painel do IAM, selecione Papéis e Criar papel.

  4. Para configurar a relação de confiança, faça o seguinte:

    1. Selecione Outra conta da AWS como a entidade confiável.

    2. Insira o ID da conta da entidade que vai assumir o papel.

    3. Opcional: é possível adicionar um ID externo para uma camada extra de segurança.

  5. Defina as permissões e anexe uma política que conceda ao papel as permissões necessárias para o bucket do Amazon S3. O Google recomenda que você use uma política com o privilégio mínimo necessário (por exemplo, acesso de leitura e gravação a um bucket específico) em vez de acesso total ao Amazon S3. Veja a seguir as permissões necessárias do Amazon S3:

    • "s3:ListBucket",

    • "s3:GetObject",

    • "s3:PutObject",

    • "s3:DeleteObject"

  6. Siga as instruções restantes para criar o papel. Você vai receber um ARN de papel.

  7. Para criar o arquivo JSON, use o ARN do papel e um ID externo (se usado), como no exemplo a seguir:

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

Configurar o armazenamento de e-mails

Se você estiver usando o Google Cloud como servidor de dados, verifique se o papel do Cloud Storage está definido como Administrador do Storage para evitar erros durante a configuração. Para mais informações, consulte Papéis do IAM para o Cloud Storage.

Para configurar o armazenamento de e-mails, siga estas etapas:

  1. No portal da plataforma CCAI, clique em Configurações > Configurações do desenvolvedor. Se o menu Configurações não aparecer, clique em Menu.

  2. Acesse a seção Gerenciamento de contas de e-mail e clique em Gerenciar conta de e-mail.

  3. Na seção Gerenciamento de dados, selecione uma duração de armazenamento de dados.

  4. Na seção Servidor de dados, selecione Google Cloud ou Amazon S3. As mesmas informações são necessárias para as duas opções:

    • Nome do bucket: insira o nome exato do bucket de armazenamento.

    • Chave da conta de serviço (arquivo JSON): faça upload do arquivo de chave JSON da sua conta de serviço doGoogle Cloud ou do Amazon S3.

    • Caminho da pasta: esse caminho é gerado automaticamente. Quando você vincula uma conta de e-mail, o sistema cria automaticamente uma pasta no bucket especificado.

  5. Clique em Testar conexão para verificar se as credenciais e os detalhes do bucket estão corretos.

  6. Clique em Salvar.

O sistema está configurado para armazenar dados de contas de e-mail vinculadas. O comportamento esperado é o seguinte:

  • Sincronização automática de dados: o sistema sincroniza automaticamente os dados de e-mail, incluindo metadados e anexos, dos servidores de e-mail para o bucket de armazenamento configurado a cada 45 segundos.

  • Monitoramento de conexão: o sistema monitora continuamente a conexão com o armazenamento e os servidores de e-mail. Se não for possível restabelecer uma conexão por mais de 30 minutos, um e-mail de notificação automatizado será enviado aos usuários administradores da sua instância. O sistema também tem uma lógica de nova tentativa automática para restabelecer uma conexão com falha.

Política de retenção de e-mails

A duração do armazenamento definida na seção Gerenciamento de dados representa o tempo que um e-mail é mantido no bucket de armazenamento. Depois disso, o e-mail é excluído do armazenamento. Se você responder a uma conversa por e-mail após o tempo de armazenamento definido (por exemplo, o tempo de armazenamento é definido como 60 dias e você responde no dia 61), toda a conversa por e-mail será recuperada do servidor IMAP, incluindo todos os anexos. No entanto, os e-mails com mais de três anos não ficam visíveis.