Saltar al contenido principal
GOWA lee la configuración desde tres lugares:
  • Marcas de línea de comandos en whatsapp rest (ejecuta ./whatsapp rest --help para la lista completa).
  • Variables de entorno.
  • Un archivo .env en el directorio de trabajo (src/.env cuando se ejecuta desde el código fuente; copia src/.env.example).
El archivo .env sólo rellena variables que no están ya definidas en el entorno.
En el código actual, las variables de entorno (incluyendo .env) se aplican después de que se analizan, así que una variable que se establece anula la bandera correspondiente. Configuración MCP OAuth, --allow-unauthenticated, --trusted-origins, --chatwoot-webhook-allow-unsigned, y --webhook-all-device-receipts son excepciones cuyas banderas explícitas ganan. Ajusta cada opción en un solo lugar. Por ejemplo, WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY=true anula --webhook-insecure-skip-verify=false.
Los booleanos aceptan true/false. Duraciones usan la sintaxis Go (30s, 5m, 3h). Los valores de la lista son separados por comas.

Comandos

Servidor

Tablero

MCP

Ver Servidor MCP.

Almacenamiento

Almacenamiento de chat (chats, mensajes, programas) siempre vive en storages/chatstorage.db y no es configurable. Las bases de datos SQLite para las sesiones, el almacenamiento del chat y OAuth se crean con permisos 0600. Los directorios que crea GOWA para estos archivos utilizan 0700. Los directorios existentes conservan sus permisos. Los cambios de permiso que no son soportados por el sistema de archivos se registran como advertencias. Para la sesión de PostgreSQL y almacenes de claves, un sslmode omitido o en blanco por defecto para verify-full para objetivos de marcado remoto. localhost, loopback IPs, y sockets Unix predeterminados a disable. Configuración explícita de URI, PGSSLMODE, y configuración de servicio siguen siendo efectivos. Una entrada PGSERVICE puede sobreescribir el host URI y el modo TLS. Para PostgreSQL administrado, proporcione sslmode=verify-full y la configuración CA requerida explícitamente.

Comportamiento de WhatsApp

Webhooks

Ver Webhooks.

Chatwoot

El filtro de eventos y la opción de revocación de una sola vía están disponibles en main de GOWA después de v9.9.0. Vea integración de Chatwoot para el comportamiento y ejemplos.

Límites fijos

Estos están compilados y no pueden ser cambiados por configuración:

Descargas de URL multimedia

Enviar solicitudes que obtengan medios, documentos o previsualizaciones de enlaces aceptan URLs HTTP y HTTPS. La URL pública obtiene rechazos de loopback, privados, link-local, metadatos, multicast, y destinos reservados. Las redirecciones y la dirección realmente marcada están marcadas. Estas descargas se conectan directamente y no usan HTTP_PROXY o HTTPS_PROXY. GOWA puede leer sus propias URLs /statics del disco. Las descargas de archivos adjuntos de Chatwoot pueden usar el destino configurado de Chatwoot o hosts permitidos, incluyendo un host interno cuando se confíe a través de esa integración. Esta excepción no se aplica a las URLs arbitrarias enviadas a la API de envío. Use subidas de archivos cuando la fuente es privada.

No usado

src/.env.example lista WHATSAPP_WEBHOOK_INCLUDE_OUTGOING y WHATSAPP_CHAT_STORAGE, pero el código actual tampoco lee. Establecerlos no tiene efecto.

Ejemplo

.env
Banderas equivalentes: