Cómo configurar Amazon S3 (opcional)
Para quién es: quien administra la cuenta
Para qué sirve
Los archivos multimedia (imágenes, videos, audios, documentos) que se envían y reciben se guardan en un almacenamiento. Amazon S3 es opcional: si no cargás credenciales, TalkAI los guarda en el disco del servidor y todo funciona igual. Cargá S3 solo si querés que los archivos vivan en tu propio bucket.
Paso 1: Crear una cuenta de AWS
- Andá a aws.amazon.com y clickeá Crear una cuenta de AWS.
- Completá el formulario con tus datos.
- Elegí el plan Basic Support (gratuito).
Paso 2: Crear un bucket de S3
- Ingresá a la consola de AWS: console.aws.amazon.com.
- Buscá S3 y clickeá en el servicio.
- Clickeá Crear bucket.
- Configurá:
talkai-media (debe ser único globalmente).
- Región: por ejemplo us-east-1.
- Bloquear todo el acceso público: dejalo activado (los archivos se sirven con URLs firmadas).
- Clickeá Crear bucket.
Paso 3: Configurar CORS en el bucket
- En S3, entrá a tu bucket y abrí la pestaña Permisos.
- En CORS (Cross-origin resource sharing), clickeá Editar.
- Pegá esta configuración y guardá:
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT"],
"AllowedOrigins": ["*"],
"ExposeHeaders": []
}
]
Paso 4: Crear un usuario IAM con permisos limitados
No uses las credenciales root de AWS. Creá un usuario específico:
- Andá a IAM > Usuarios > Crear usuario (por ejemplo
talkai-s3). - En permisos, elegí Adjuntar políticas directamente y creá una política personalizada en la pestaña JSON:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject"
],
"Resource": "arn:aws:s3:::TU-BUCKET-NAME/*"
}
]
}
- Reemplazá
TU-BUCKET-NAMEpor el nombre real de tu bucket. - Guardá la política y adjuntala al usuario.
Paso 5: Obtener las Access Keys
- Entrá al usuario que creaste y abrí Credenciales de seguridad.
- En Claves de acceso, clickeá Crear clave de acceso y elegí Aplicación que se ejecuta fuera de AWS.
- Copiá el Access Key ID y el Secret Access Key. El secreto se muestra una sola vez.
Paso 6: Cargar los datos en TalkAI
- En TalkAI, andá a Configuración > APIs Externas.
- Abrí la sección AWS y completá Access Key ID, Secret Access Key, nombre del bucket y región.
- Clickeá Guardar.
Verificación
Desde una conversación del Inbox probá enviar una imagen, o pedile a un contacto que te mande una foto. Debería verse en el chat.
Errores frecuentes
| Problema | Solución |
|---|---|
| "Access Denied" al subir | La política IAM debe incluir s3:PutObject para tu bucket |
| Las imágenes no se ven | La política debe incluir s3:GetObject |
| "NoSuchBucket" | Revisá que el nombre del bucket sea correcto, sin espacios |
| Los archivos no se descargan | Revisá la configuración CORS del bucket |