Servicio de Almacenamiento Simple (S3)
El Servicio de Almacenamiento Simple o S3 es un servicio de almacenamiento de datos ofrecido por muchas empresas de la nube, como AWS (conocido como buckets de S3). S3 almacena distintos tipos de datos y es reconocido por su integración sencilla y sus funciones automáticas de gestión de datos, lo que te evita la molestia de administrar tu base de datos por tu cuenta.
none
_2qbal3lzkb98Integración con OneChat
Abre tu panel de S3 y crea un nuevo bucket.
Asegúrate de que, al crear el bucket, tenga permisos de lectura/escritura y que sea un bucket público
.
Desde el menú lateral "App Keys", puedes agregar una nueva application key; necesitas contar con permisos de lectura y escritura.
Después de crear la clave, guarda o copia los detalles.
Dentro del panel de OneChat, haz clic en Integration y luego en la opción S3 storage.
Ingresa los detalles correspondientes a tu bucket en los campos y haz clic en guardar; tu almacenamiento S3 quedará integrado con OneChat para su uso.
Existe una restricción global para subir archivos de más de 5 MB.
_xzkni3suvsacImplementación de S3 dentro de OneChat
El almacenamiento S3 reemplaza al servidor de almacenamiento predeterminado de OneChat; por lo tanto, cada archivo (imagen, video, PDF, archivos multimedia, etc.) que subas se cargará directamente en tu bucket de S3 en lugar del servidor de OneChat.
Esto ayuda a mantener tus datos resguardados en caso de que OneChat tenga una interrupción del servicio y garantiza que tus flujos sigan funcionando correctamente.
Un ejemplo de implementación sería crear un nodo Send Message y subir una imagen usando la función Rich Media.
Después de completar la carga, guarda el flujo y publícalo.
Haz clic nuevamente en el nodo y revisa la URL de la imagen que acabas de subir.
La URL de la imagen habrá cambiado del URI del servidor predeterminado de OneChat a la URL de tu bucket de S3.
De esta manera, después de la integración, todos tus archivos se subirán directamente a tu bucket.
_6xhrbasvimc2Tutorial de S3
TODO_VIDEO[0f87a428f9]: reemplazar este video con un recurso oficial de OneChat.
Swt73_5U
Cómo conectar tu almacenamiento S3 de Google Cloud
Esta guía te mostrará cómo conectar tu almacenamiento S3 de Google Cloud a OneChat. Esto te permite cargar archivos directamente desde tus flujos de OneChat a tus buckets de almacenamiento de Google Cloud.
Requisitos previos
- Una cuenta de OneChat
- Un proyecto de Google Cloud con un bucket de almacenamiento S3
Pasos
1. Localiza la integración de S3 Storage en OneChat
- Ve al menú lateral izquierdo en OneChat.
- Haz clic en "Integrations."
- Selecciona "Data File Storage."
- Elige "S3 Storage" de la lista de integraciones.
1. Reúne las credenciales de S3 Storage
- La página de descripción general mostrará varios parámetros necesarios para la conexión:
Endpoint: esta es una URL genérica y permanece constante ( https://storage.googleapis.com ).
- Bucket Name: el nombre que asignaste a tu bucket de S3.
- Region: la ubicación geográfica donde se encuentra tu bucket (por ejemplo, Europe para cumplimiento de GDPR).
- Access Key: un identificador único utilizado para el acceso a la API (debe crearse en Google Cloud).
- Secret Key: una clave confidencial utilizada para el acceso a la API (debe crearse en Google Cloud).
1. Crea un bucket de Google Cloud Storage (si es necesario)
- Accede a tu proyecto de Google Cloud.
- Haz clic en el menú de hamburguesa (menú de navegación) en la esquina superior izquierda.
- Busca "Cloud Storage" y selecciona "Buckets."
- Haz clic en el botón "Create Bucket."
- Asigna un nombre a tu bucket (por ejemplo, "onechat-demo").
- Elige una región (por ejemplo, Europe para cumplimiento de GDPR).
- Selecciona el control de acceso "Fine Grain" por ahora.
- Elige "Object Versioning" para protección de datos (opcional).
- Selecciona "Google Managed Encryption Key" para el cifrado de datos.
- Desmarca "Enforced Public Access prevention on this bucket" (requerido para el acceso de OneChat).
- Confirma la creación del bucket.
1. Genera la Access Key y la Secret Key
- Haz clic en el menú de hamburguesa (menú de navegación) en la esquina superior izquierda.
- Ve a "IAM & Admin" y luego a "Service Accounts".
- Selecciona la cuenta de servicio que deseas usar para el acceso de OneChat.
- Asegúrate de que los siguientes permisos estén habilitados para la cuenta de servicio:
Storage Object Admin
- Storage Object Creator
- Storage Object User
- Si no puedes administrar los permisos, accede a ellos desde "IAM" -> Esto significa que los permisos se heredan del usuario administrador conectado. Si navegas a Identity and Access Management (IAM), deberías poder configurar los permisos requeridos. Ve a "Edit Principal" y luego a "Add another Rule." Busca "Storage Object Admin", "Storage Object Creator", "Storage Object User" para encontrar los permisos específicos de almacenamiento que necesitas.
- Ve a "Cloud Storage Settings" -> "Interoperability."
- Crea una nueva clave y copia la "Access Key" y la "Secret Key."
1. Conecta S3 Storage a OneChat
- Regresa a la página de integración de S3 Storage en OneChat.
- Pega la URL del endpoint copiada ( https://storage.googleapis.com ).
- Ingresa el nombre de tu bucket.
- Selecciona la región correspondiente en el menú desplegable.
- Pega la access key y la secret key copiadas en sus campos respectivos.
- Haz clic en "Save."
Debería aparecer un estado "Verified" si la conexión fue exitosa.
Ahora puedes utilizar tu almacenamiento S3 de Google Cloud dentro de tus flujos de OneChat. Los archivos cargados a través de tus flujos se guardarán directamente en el bucket de S3 designado.
Video tutorial para conectar tu almacenamiento S3 de Google Cloud
TODO_VIDEO[eece012892]: reemplazar este video con un recurso oficial de OneChat.