> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de configuración

> Cada variable de entorno GOWA y bandera de línea de comandos, con valores predeterminados.

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.

> [!WARNING]
>
> 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

| Comando | Descripción |
| - | - |
| `whatsapp rest` | Iniciar el API REST, el tablero, WebSocket y el punto final MCP. Requerido desde v6; una simple `whatsapp` no inicia el servidor. |
| `whatsapp version` | Imprime la versión y sale. |
| `whatsapp --help` | Listar comandos y banderas. |

## Servidor

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `APP_PORT` | `--port`, `-p` | `3000` | Puerto HTTP. |
| `APP_HOST` | `--host`, `-H` | `0.0.0.0` | Enlazar dirección. |
| `APP_DEBUG` | `--debug`, `-d` | `false` | Registro detallado. |
| `APP_OS` | `--os` | `GOWA` | Nombre del dispositivo mostrado en la lista de **dispositivos enlazados** de WhatsApp. |
| `APP_BASIC_AUTH` | `--basic-auth`, `-b` | — | Completa los pares `user:pass`, separados por comas. Requerido para un oyente no-loopback a menos que se establezca la sobreescritura explícita sin autenticación. |
| `APP_ALLOW_UNAUTHENTICATED` | `--allow-unauthenticated` | `false` | Permitir un oyente no loopback sin autenticación básica. Úsalo sólo detrás de un proxy de autenticación con acceso directo restringido. |
| `APP_TRUSTED_ORIGINS` | `--trusted-origins` | — | Los orígenes exactos del navegador permiten mutar el estado y abrir WebSockets. El host de la solicitud y los orígenes específicos del CORS también son de confianza. |
| `APP_BASE_PATH` | `--base-path` | — | Sirva bajo un subcamino, por ejemplo, `/gowa`. `/health` permanece en la raíz. |
| `APP_TRUSTED_PROXIES` | `--trusted-proxies` | — | Intervalos IP proxy cuyos encabezados reenviados son de confianza, por ejemplo, `10.0.0.0/8`. |
| `APP_CORS_ALLOWED_ORIGINS` | `--cors-allowed-origins` | — (cualquier origen) | Orígenes CORS. Orígenes específicos también pasan las comprobaciones de origen del navegador. Un comodín no autoriza mutaciones o WebSockets. |

## Tablero

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `APP_UI_ENABLED` | `--ui-enabled` | `true` | Servir el tablero gowa-ui en `/`. |
| `APP_UI_AUTO_UPDATE` | `--ui-auto-update` | `true` | Descargue la última versión del tablero al inicio y de forma periódica. Deshabilite para los hosts con un caché `storages/ui` pre-seed. |
| `APP_UI_REPO` | `--ui-repo` | `aldinokemal/gowa-ui` | Repositorio GitHub desde donde descargar. |
| `APP_UI_ASSET_NAME` | `--ui-asset-name` | `gowa-ui.html` | Suelta el recurso para descargar. |
| `APP_UI_UPDATE_INTERVAL` | `--ui-update-interval` | `3h` | Intervalo entre comprobaciones de actualización. |
| `APP_UI_GITHUB_TOKEN` | — | — | Token de GitHub para un límite de tasa de API más alto. |
| `APP_UI_ASSET_SHA256` | `--ui-asset-sha256` | — | Sólo sirve un tablero con este SHA-256. |

## MCP

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `MCP_ENABLED` | `--mcp-enabled` | `true` | Servir el endpoint MCP en `/mcp`. |
| `MCP_OAUTH_ENABLED` | `--mcp-oauth-enabled` | `false` | Habilitar OAuth 2.1 para `/mcp`. Requiere `APP_BASIC_AUTH`. |
| `MCP_OAUTH_ISSUER_URL` | `--mcp-oauth-issuer-url` | — | URL pública HTTPS. Requerida con OAuth. |
| `MCP_OAUTH_RESOURCE_URL` | `--mcp-oauth-resource-url` | emisor + ruta base + `/mcp` | URL pública canónica. |
| `MCP_OAUTH_DB_URI` | `--mcp-oauth-db-uri` | `file:storages/oauth.db` | SQLite almacena para clientes OAuth y hash de token. |

Ver [Servidor MCP](https://gowa-docs.mintlify.site/es/integrations/mcp.md).

## Almacenamiento

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `DB_URI` | `--db-uri` | `file:storages/whatsapp.db` | Session store: SQLite (`file:...`) or PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | `--db-keys-uri` | igual que `DB_URI` | Tienda separada opcional para la caché de claves de cifrado. Evite almacenamientos en memoria en producción. |
| `CHAT_STORAGE_MAX_OPEN_CONNS` | — | `5` | Conexiones máximas SQLite para el almacenamiento del chat. Aumente si envía el tiempo de espera bajo una carga de entrada pesada. |

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

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `WHATSAPP_AUTO_REPLY` | `--autoreply` | — | Respuesta fija enviada a cada mensaje entrante. |
| `WHATSAPP_AUTO_MARK_READ` | `--auto-mark-read` | `false` | Marcar mensajes entrantes leídos. |
| `WHATSAPP_AUTO_DOWNLOAD_MEDIA` | `--auto-download-media` | `true` | Guardar medios entrantes en `statics/media`. |
| `WHATSAPP_IGNORE_STATUS_MEDIA` | `--ignore-status-media` | `false` | Omitir la descarga de medios de estado. |
| `WHATSAPP_AUTO_REJECT_CALL` | `--auto-reject-call` | `false` | Rechazar llamadas entrantes. |
| `WHATSAPP_ACCOUNT_VALIDATION` | `--account-validation` | `true` | Compruebe que los destinatarios están en WhatsApp antes de enviar. |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `--presence-on-connect` | `unavailable` | Presencia enviada en connect: `available`, `unavailable` o `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `--presence-pulse-enabled` | `true` | Periodically go online brevemente, luego offline nuevamente. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `--presence-pulse-interval` | `24h` | Tiempo entre pulsaciones. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `--presence-pulse-duration` | `5m` | Cuánto tiempo permanece cada pulso en línea. |
| `WHATSAPP_PROXY` | `--whatsapp-proxy` | — | Proxy para la conexión de WhatsApp: `socks5://`, `http://` o `https://`. `HTTP_PROXY` no se aplica a ella. |

## Webhooks

| Variable | Marca | Por defecto | Descripción |
| - | - | - | - |
| `WHATSAPP_WEBHOOK` | `--webhook`, `-w` | — | Webhook URL(s), separados por comas. |
| `WHATSAPP_WEBHOOK_SECRET` | `--webhook-secret` | aleatorio por proceso | Clave HMAC para `X-Hub-Signature-256`. Establece una clave generada estable. Vacía, `secret`, `super-secret-key`, y `your-private-key` producen una clave efemeral en su lugar. |
| `WHATSAPP_WEBHOOK_INSECURE_SKIP_VERIFY` | `--webhook-insecure-skip-verify` | `false` | Omitir verificación de TLS (sólo desarrollo). |
| `WHATSAPP_WEBHOOK_EVENTS` | `--webhook-events` | — (todo) | Lista de eventos permitidos, p. ej., `message,message.ack`. |
| `WHATSAPP_WEBHOOK_IGNORE_JIDS` | `--webhook-ignore-jids` | — | JID o comodín (`@g.us`, `@s.whatsapp.net`, `@lid`) no reenviado. |
| `WHATSAPP_WEBHOOK_DEVICE_MERGE_GLOBAL` | `--webhook-device-merge-global` | `false` | Enviar los eventos de un dispositivo a las URLs globales así como su propio webhook. |
| `WHATSAPP_WEBHOOK_ALL_DEVICE_RECEIPTS` | `--webhook-all-device-receipts` | `false` | Reenviar recibos desde los dispositivos conectados de contactos así como su dispositivo principal. Puede producir múltiples reconocimientos para un mensaje. |

Ver [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md).

## Chatwoot

| Variable | Marca | Por defecto |
| - | - | - |
| `CHATWOOT_ENABLED` | `--chatwoot-enabled` | `false` |
| `CHATWOOT_URL` | — | — |
| `CHATWOOT_API_TOKEN` | — | — |
| `CHATWOOT_ACCOUNT_ID` | — | — |
| `CHATWOOT_INBOX_ID` | — | — |
| `CHATWOOT_DEVICE_ID` | `--chatwoot-device-id` | — |
| `CHATWOOT_ALLOWED_HOSTS` | `--chatwoot-allowed-hosts` | — |
| `CHATWOOT_IMPORT_MESSAGES` | `--chatwoot-import-messages` | `false` |
| `CHATWOOT_DAYS_LIMIT_IMPORT_MESSAGES` | `--chatwoot-days-limit-import-messages` | `3` |
| `CHATWOOT_IMPORT_DB_URI` | `--chatwoot-import-db-uri` | — |
| `CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE` | `--chatwoot-import-placeholder-media-message` | `true` |
| `CHATWOOT_IMPORT_MEDIA_WITH_REST` | `--chatwoot-import-media-with-rest` | `false` |
| `CHATWOOT_AUTO_CREATE` | `--chatwoot-auto-create` | `false` |
| `CHATWOOT_INBOX_NAME` | `--chatwoot-inbox-name` | `WhatsApp` |
| `CHATWOOT_WEBHOOK_URL` | `--chatwoot-webhook-url` | — |
| `CHATWOOT_WEBHOOK_SECRET` | `--chatwoot-webhook-secret` | — |
| `CHATWOOT_WEBHOOK_ALLOW_UNSIGNED` | `--chatwoot-webhook-allow-unsigned` | `false` |
| `CHATWOOT_WEBHOOK_SIGNATURE_TOLERANCE` | `--chatwoot-webhook-signature-tolerance` | `5m` |
| `CHATWOOT_REOPEN_CONVERSATION` | `--chatwoot-reopen-conversation` | `true` |
| `CHATWOOT_CONVERSATION_PENDING` | `--chatwoot-conversation-pending` | `false` |
| `CHATWOOT_IGNORE_JIDS` | `--chatwoot-ignore-jids` | — |
| `CHATWOOT_SIGN_MSG` | `--chatwoot-sign-msg` | `false` |
| `CHATWOOT_SIGN_DELIMITER` | `--chatwoot-sign-delimiter` | `\n\n` |
| `CHATWOOT_FORWARD_EDITS` | `--chatwoot-forward-edits` | `true` |
| `CHATWOOT_FORWARD_DELETES` | `--chatwoot-forward-deletes` | `true` |
| `CHATWOOT_EVENTS` | `--chatwoot-events` | Sigue `WHATSAPP_WEBHOOK_EVENTS` cuando está vacío |
| `CHATWOOT_MESSAGE_READ` | `--chatwoot-message-read` | `false` |
| `CHATWOOT_MESSAGE_DELETE` | `--chatwoot-message-delete` | `false` |
| `CHATWOOT_REVOKE_ON_DELETE` | `--chatwoot-revoke-on-delete` | `false` |

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](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md#configuraci%C3%B3n) para el comportamiento y ejemplos.

## Límites fijos

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

| Límite | Valor |
| - | - |
| Cargar imagen | 20 MB |
| Carga de documentos | 50 MB |
| Carga de vídeo y cuerpo de petición HTTP | 100 MB |
| Descarga de medios entrantes | 500 MB |
| Tiempo de espera de solicitud | 45 s (`504 GATEWAY_TIMEOUT`) |
| Entrega de Webhook | 10 s por intento, 5 intentos |

## 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

```bash .env theme={null}
APP_PORT=3000
APP_OS=MyCompany
APP_BASIC_AUTH=admin:a-long-random-password
APP_TRUSTED_PROXIES=10.0.0.0/8
DB_URI=postgres://gowa:replace-with-password@db.example.com:5432/gowa?sslmode=verify-full
WHATSAPP_WEBHOOK=https://example.com/wa-hook
WHATSAPP_WEBHOOK_SECRET=another-long-random-secret
WHATSAPP_WEBHOOK_EVENTS=message,message.ack
WHATSAPP_AUTO_MARK_READ=false
```

Banderas equivalentes:

```bash theme={null}
./whatsapp rest --port=3000 --os=MyCompany \
  --basic-auth=admin:a-long-random-password \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=another-long-random-secret \
  --webhook-events=message,message.ack
```


## Related topics

- [Inicio rápido](https://gowa-docs.mintlify.site/es/quickstart.md)
- [Integración de Chatwoot](https://gowa-docs.mintlify.site/es/integrations/chatwoot.md)
- [Borrar la configuración de Chatwoot de un dispositivo](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/borrar-la-configuración-de-chatwoot-de-un-dispositivo.md)
- [Consigue la configuración de Chatwoot de un dispositivo](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/consigue-la-configuración-de-chatwoot-de-un-dispositivo.md)
- [Crear o actualizar la configuración de Chatwoot de un dispositivo](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/crear-o-actualizar-la-configuración-de-chatwoot-de-un-dispositivo.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.