Configura el almacenamiento externo para el correo electrónico

La configuración del almacenamiento externo es un requisito para el canal de correo electrónico. Puedes usar Cloud Storage o Amazon S3 como almacenamiento externo.

Configura Cloud Storage

Para configurar Cloud Storage para el correo electrónico, consulta Cloud Storage.

Asegúrate de que la clave JSON de tu cuenta de servicio contenga los siguientes 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

Configura el almacenamiento de Amazon S3

Cuando configuras la autenticación para Amazon S3, Contact Center AI Platform (CCAI Platform) asume un rol de Identity and Access Management (IAM) que creas en tu cuenta de AWS. Este rol otorga a CCAI Platform los permisos necesarios para acceder a tu bucket de Amazon S3.

La clave de la cuenta de servicio JSON para este método de autenticación requiere los siguientes campos:

  • region: Es la región de AWS en la que se encuentra tu bucket de Amazon S3, por ejemplo, "us-east-1".

  • role_arn: Es el nombre de recurso de Amazon (ARN) del rol de IAM que asume CCAI Platform. Este ARN identifica de forma inequívoca el rol que se configuró con las políticas de acceso adecuadas.

  • external_id: Es un identificador que proporcionas cuando creas la política de confianza para el rol. CCAI Platform pasa este ID cuando solicita asumir el rol, lo que garantiza que solo la entidad prevista pueda hacerlo.

Para crear una clave de cuenta de servicio JSON de Amazon S3, sigue estos pasos:

  1. Accede a tu cuenta de AWS.

  2. Navega al panel de IAM.

  3. En el panel de IAM, selecciona Roles y, luego, Crear rol.

  4. Para configurar la relación de confianza, haz lo siguiente:

    1. Selecciona Otra cuenta de AWS como la entidad de confianza.

    2. Ingresa el ID de cuenta de la entidad que asumirá el rol.

    3. Opcional: Puedes agregar un ID externo para obtener una capa de seguridad adicional.

  5. Establece permisos y adjunta una política que otorgue al rol los permisos necesarios para tu bucket de Amazon S3. Google recomienda que uses una política con el privilegio mínimo necesario (por ejemplo, acceso de lectura y escritura a un bucket específico) en lugar de acceso completo a Amazon S3. A continuación, se indican los permisos de Amazon S3 necesarios:

    • "s3:ListBucket",

    • "s3:GetObject"

    • "s3:PutObject",

    • "s3:DeleteObject"

  6. Sigue las indicaciones restantes para crear el rol. Se te proporcionará un ARN de rol.

  7. Para crear el archivo JSON, usa el ARN del rol y un ID externo (si se usa), como en el siguiente ejemplo:

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

Configura el almacenamiento de correos electrónicos

Si usas Google Cloud como tu servidor de datos, asegúrate de que tu rol de Cloud Storage esté configurado como Administrador de almacenamiento para evitar errores durante la configuración. Para obtener más información, consulta Roles de IAM para Cloud Storage.

Para configurar el almacenamiento de correos electrónicos, sigue estos pasos:

  1. En el portal de CCAI Platform, haz clic en Configuración > Configuración para desarrolladores. Si no ves el menú Configuración, haz clic en Menú.

  2. Ve a la sección Administración de cuentas de correo electrónico y, luego, haz clic en Administrar cuenta de correo electrónico.

  3. En la sección Administración de datos, selecciona una duración para el almacenamiento de datos.

  4. En la sección Servidor de datos, selecciona Google Cloud o Amazon S3. Se requiere la misma información para ambas opciones:

    • Nombre del bucket: Ingresa el nombre exacto de tu bucket de almacenamiento.

    • Clave de cuenta de servicio (archivo JSON): Sube el archivo de clave JSON de tu cuenta de servicio deGoogle Cloud o Amazon S3.

    • Ruta de la carpeta: Esta ruta se genera automáticamente. Cuando vinculas una cuenta de correo electrónico, el sistema crea automáticamente una carpeta dentro del bucket especificado.

  5. Haz clic en Probar conexión para verificar que las credenciales y los detalles del bucket sean correctos.

  6. Haz clic en Guardar.

El sistema está configurado para almacenar datos de las cuentas de correo electrónico vinculadas. Puedes esperar el siguiente comportamiento:

  • Sincronización automática de datos: El sistema sincroniza automáticamente los datos de correo electrónico, incluidos los metadatos y los archivos adjuntos, desde tus servidores de correo electrónico hasta el bucket de almacenamiento configurado cada 45 segundos.

  • Supervisión de la conexión: El sistema supervisa de forma continua la conexión con tu almacenamiento de correo electrónico y los servidores de correo electrónico. Si no se puede restablecer una conexión durante más de 30 minutos, se envía una notificación automática por correo electrónico a los usuarios administradores de tu instancia. El sistema también tiene una lógica de reintento automático para restablecer una conexión fallida.

Política de retención de correos electrónicos

La duración del almacenamiento que estableces en la sección Administración de datos representa la cantidad de tiempo que se conserva un correo electrónico en tu bucket de almacenamiento. Después de ese tiempo, el correo electrónico se borra del almacenamiento. Si respondes un hilo de correos electrónicos después del tiempo de almacenamiento establecido (por ejemplo, el tiempo de almacenamiento se establece en 60 días y respondes el día 61), se recuperará todo el hilo de correos electrónicos de tu servidor IMAP, incluidos los archivos adjuntos. Sin embargo, no se pueden ver los correos electrónicos que tienen más de tres años.