Saltar al contenido principal

Límites

El límite de cuerpo de petición HTTP es igual al límite de vídeo (100 MB), por lo que ninguna carga puede excederla. Consulta los valores en vivo con GET /app/info (max_image_size, max_file_size, max_video_size). Estos límites están compilados por defecto; no hay ninguna variable de entorno para ellos.

Dos maneras de proporcionar medios

Cada endpoint de medios acepta un archivo multiparte o una URL que GOWA obtiene del servidor:
Enviar uno u otro, no ambos. Las URLs de medios remotos deben usar HTTP o HTTPS y resolver con direcciones públicas. GOWA bloquea loopback, privados, enlaces-locales y otros destinos reservados, incluyendo redireccionamientos. Sube archivos locales como datos de varias partes en lugar de usar una URL interna.

Procesando

GOWA necesita FFmpeg y libwebp en el host (ambos están en la imagen Docker). /send/file envía documentos sin conversión. El procesamiento de imágenes comprueba las dimensiones de la cabecera antes de decodificar. La ventaja más larga aceptada es de 32.768 píxeles. Las imágenes no JPEG tienen un presupuesto de 40 millones de píxeles. Los JPEG tienen un techo de 80 millones de píxeles más un presupuesto de memoria decodificación de 320 MiB, por lo que algunos JPEG grandes progresivos o CMYK son rechazados por debajo del cierre de píxeles. Los envíos de imágenes originales pueden omitir miniaturas cuando la decodificación excede el presupuesto. Las imágenes interactivas de carrusel tienen límites separados, límites más pequeños en Mensajes interactivos.

Media entrante

Con WHATSAPP_AUTO_DOWNLOAD_MEDIA=true (por defecto), GOWA descarga medios de mensajes entrantes a statics/media/ y pone la ruta relativa en la carga útil del webhook:
Obtén en http://<host>:3000/statics/media/<file>. Establece WHATSAPP_IGNORE_STATUS_MEDIA=true para omitir los medios de las actualizaciones de estado. Con la descarga automática, el payload lleva una URL de WhatsApp CDN en su lugar. Descarga a través de GOWA, que descifra el archivo:
WhatsApp mantiene los medios en sus servidores durante un tiempo limitado. Descarga lo que necesitas rápidamente. En GOWA main después de v9.9.0, las descargas explícitas y reenvíos pueden pedir al teléfono que vuelva a cargar los medios caducados. El teléfono debe estar en línea y todavía tener el archivo. GOWA espera hasta 30 segundos para una respuesta. Esto también se aplica a las acciones MCP download_media y forward, y a Chatwoot history imports.

Almacenamiento y limpieza

Las rutas son relativas al directorio de procesos, normalmente src/ de origen o /app en Docker. Compone monta los directorios storages/ y statics/ en /app. No hay ajustes de retención de medios basados en la edad o punto final de limpieza. Una imagen puede tener copias en storages/ y statics/media/. Nunca elimine todo el directorio storages/ para recuperar espacio multimedia. Pausa GOWA y otros escritores, haz una copia de seguridad de los archivos requeridos, luego previsualiza los archivos para eliminarlos. Estos ejemplos de GNU se ejecutan desde el directorio de implementación y seleccionan archivos al menos 31 días completos.
Después de revisar cada ruta, reemplaza -print con -delete en los mismos comandos. Preservar archivos de base de datos, -wal y -shm de SQLite, archivos adjuntos programados y archivos personalizados. Reiniciar GOWA después. Las rutas eliminadas y las URL estáticas dejan de funcionar, y la eliminación de medios no limpia el historial de chat. WHATSAPP_AUTO_DOWNLOAD_MEDIA=false detiene las futuras descargas automáticas y las copias adicionales de imágenes. No elimina archivos antiguos ni impide las descargas explícitas mediante REST o MCP. Consulta la guía completa de almacenamiento y limpieza de archivos multimedia. /statics sigue siendo público. Almacenados HTML, SVG, scripts y otros documentos se sirven como archivos adjuntos con application/octet-stream y nosniff. Los bytes de imágenes soportados bajo rutas de previsualización de imágenes pueden renderizarse en línea. Estas protecciones de contenido no restringen quién puede descargar un archivo. Proteja los medios sensibles en el proxy inverso.

Solución de problemas