Skip to main content
La Evolution API soporta la integración con Amazon S3 o Minio para almacenar archivos multimedia de WhatsApp, como imágenes, audios y documentos. Esta integración permite que los archivos sean almacenados de forma segura y accesible, con enlaces generados automáticamente e incluidos en los webhooks enviados por la API.

​
Configuración de Variables de Entorno

Para habilitar el almacenamiento S3 o Minio, debe definir las variables de entorno adecuadas en el archivo .env de la Evolution API. A continuación se encuentran las variables necesarias y sus funciones:

​
Variables de Configuración para S3

​
Explicación de las Variables

  • S3_ENABLED: Activa (true) o desactiva (false) el uso de S3 o Minio para almacenamiento de archivos.
  • S3_ACCESS_KEY: Clave de acceso proporcionada por el proveedor del servicio (AWS o Minio).
  • S3_SECRET_KEY: Clave secreta correspondiente a la clave de acceso, usada para autenticación.
  • S3_BUCKET: Nombre del bucket donde se almacenarán los archivos.
  • S3_PORT: Puerto utilizado para la conexión. Normalmente 443 para conexiones SSL.
  • S3_ENDPOINT: Endpoint del servicio S3 o Minio. Para Amazon S3, es necesario incluir la región en el formato region: s3.[region].amazonaws.com, por ejemplo, s3.eu-west-3.amazonaws.com.
  • S3_USE_SSL: Define si la conexión debe usar SSL (true o false).
  • S3_REGION: La región del bucket S3 (por defecto es us-east-1).

​
Ejemplos de Configuración

​
Amazon S3

Al utilizar Amazon S3, es esencial especificar el endpoint correctamente, incluyendo la región. Aquí hay un ejemplo:

​
Minio

Para Minio, el endpoint puede ser el dominio personalizado del servicio:

​
Cómo Funciona el Almacenamiento de Multimedia

Cuando el almacenamiento S3 o Minio está configurado correctamente, todos los archivos multimedia recibidos de WhatsApp (como imágenes, videos, audios, etc.) se envían automáticamente al bucket configurado. La URL pública del archivo almacenado se genera e incluye en el webhook de la Evolution API.

​
Webhook con mediaUrl

Cuando un archivo multimedia es recibido y almacenado, el webhook enviado por la Evolution API incluirá el mediaUrl en el cuerpo del mensaje. Esto permite que su aplicación acceda directamente al archivo almacenado en S3 o Minio.

​
Ejemplo de Webhook

Aquí hay un ejemplo de cómo puede aparecer el webhook con mediaUrl:

​
Consideraciones Finales

Integrar la Evolution API con Amazon S3 o Minio para el almacenamiento de archivos multimedia ofrece una solución escalable y segura para gestionar contenidos multimedia de WhatsApp. Al configurar las variables de entorno correctamente, garantiza que todos los archivos multimedia sean almacenados y accesibles según sea necesario, proporcionando mayor control sobre los datos y la capacidad de integrarlos fácilmente en sus aplicaciones.
Para más detalles sobre las variables de entorno y otras configuraciones avanzadas, consulte la sección de variables de entorno.