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

# Mejores prácticas de producción

> Ejecutar GOWA de forma segura en producción: seguridad, almacenamiento, backups, proxy inverso, monitorización y envío de higiene.

## Seguridad

* **Establece `APP_BASIC_AUTH`** con una contraseña aleatoria larga. Un enlace no-loopback requiere credenciales a menos que `APP_ALLOW_UNAUTHENTICATED=true` deshabilite explícitamente esa comprobación. El bucle puede ejecutarse sin credenciales para el desarrollo local.
* **Establece explícitamente `WHATSAPP_WEBHOOK_SECRET`.** Sin él, GOWA genera una clave aleatoria que cambia al reiniciar. Verifique `X-Hub-Signature-256` sobre el cuerpo de la petición. Mantenga la verificación TLS saliente activada.
* **Terminar TLS** en un proxy inverso; GOWA habla en sí mismo HTTP.
* **Restringir `/statics`.** Los códigos QR y los medios descargados bajo `/statics/*` se sirven **sin** Basic Auth. Bloquea o protege esa ruta en el proxy si los medios son sensibles, y limpia `statics/media` regularmente.
* **No exponga `/chatwoot/webhook` sin `CHATWOOT_WEBHOOK_SECRET`** cuando Chatwoot esté habilitado.
* **Establece `APP_CORS_ALLOWED_ORIGINS`** si los navegadores llaman directamente a la API; comodín CORS no autoriza escrituras del navegador o `/ws`. Configure los orígenes específicos en `APP_TRUSTED_ORIGINS` o la lista permitida CORS. Vea [Authentication](https://gowa-docs.mintlify.site/es/api-reference/authentication.md).
* **Vincula privadamente** (`APP_HOST=127.0.0.1` o una red privada) cuando sólo los servicios locales necesitan acceso.
* No se han podido iniciar sesión con el límite de calificación en el proxy; GOWA no tiene [límite de tasas](https://gowa-docs.mintlify.site/es/advanced/rate-limiting.md).

## Almacenamiento y copias de seguridad

| Ruta | Contenido | ¿Respaldar? |
| - | - | - |
| `storages/whatsapp.db` (o `DB_URI`) | Sesiones y claves de WhatsApp | Sí. Perderlo significa volver a emparejar cada dispositivo. |
| `storages/chatstorage.db` | Chats, mensajes, programas y otro estado de GOWA | Sí |
| `storages/oauth.db` | Clientes de OAuth MCP y hash de token | Si se utiliza OAuth |
| `statics/` | Códigos QR, medios descargados y programados | Opcional |

* Utilice PostgreSQL para `DB_URI` si desea copias de seguridad administradas; el almacenamiento del chat siempre es SQLite.
* Copia de seguridad mientras GOWA se detiene, o utiliza las herramientas de copia de seguridad en línea de tu base de datos.
* Guarda copias de seguridad cifradas: la base de datos de sesión es equivalente a una cuenta registrada.
* **Ejecuta una instancia de GOWA por almacenamiento.** Dos procesos que comparten una sesión causan desconexiones y conflictos. GOWA no soporta escalado horizontal.

## Doctor

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* Anclar una etiqueta de versión en lugar de `latest`, y leer las notas de publicación antes de actualizar.
* El contenedor se ejecuta como un usuario no root (UID 20001); asegúrese de que los volúmenes montados son escribibles.
* La imagen establece `TZ=UTC`. Los programas utilizan la `timezone` que pasa, así que esto no los afecta.

## Invertir proxy

* Establece `APP_TRUSTED_PROXIES` en el rango de direcciones de tu proxy para que el cliente pueda leer correctamente.
* Permitir actualizaciones de WebSocket en `/ws`.
* Aumenta el límite de cuerpo a al menos 100 MB (`client_max_body_size 100m;` en nginx).
* Mantener los tiempos de espera de proxy por encima de 45 segundos de solicitud de GOWA.
* Para implementaciones de sub-ruta use `APP_BASE_PATH`; `/health` permanece en la raíz.

Vea [Installation](https://gowa-docs.mintlify.site/es/installation.md#beind-a-un-proxy-inverso) para un ejemplo de nginx.

## Monitoreo

* **Livedad:** `GET /health` devuelve `200 OK` cuando el proceso y el almacenamiento están arriba. No comprueba WhatsApp.
* **Conectividad de WhatsApp:** encuesta `GET /devices/{device_id}/status` y alerta cuando `is_logged_in` es `false`.
* **Eventos:** suscríbete a webhooks y alerta sobre el tráfico perdido para números ocupados.
* **Registros:** recolecta el contenedor stdout; usa `APP_DEBUG=true` sólo mientras se resuelven problemas.

GOWA se conecta automáticamente al iniciar y comprueba las conexiones cada 5 minutos. Un dispositivo que cierra la sesión del teléfono debe estar emparejado de nuevo.

`GET /app/metrics` devuelve métricas autenticadas de proceso, memoria, disco y dispositivo sin seleccionar un dispositivo. Ver [métricas del servidor](https://gowa-docs.mintlify.site/es/api-reference/metrics.md). Alerta en los webhooks `device.logged_out`, `device.temporary_ban`, y `device.reachout_timelock`.

## Receptores Webhook

* Responde `2xx` en 10 segundos; el proceso funciona de forma asincrónica.
* Deduplicar por dispositivo, tipo de evento y los identificadores del evento. Los identificadores de mensaje por sí solos no distinguen ediciones, reacciones o estados de recepción posteriores.
* Después de 5 intentos fallidos, el evento ha sido soltado. Usa `GET /chats` y `GET /chat/{jid}/messages` para ponerte al día después de una interrupción.

## Enviando higiene

* Envía mensajes a las personas que optaron o escribieron primero.
* Ritmo envía con retrasos y nervioso; evita idénticos textos a granel.
* Detenga en `WA_REACHOUT_TIMELOCK`.
* Mantenga `WHATSAPP_ACCOUNT_VALIDATION=true` para que los números no registrados fallen rápidamente.
* WhatsApp permite hasta cuatro dispositivos de acompañamiento vinculados por cuenta, y desvincula a los compañeros después de unos 14 días si el teléfono se mantiene sin conexión.


## Related topics

- [Sesiones y ciclo de vida de la conexión](https://gowa-docs.mintlify.site/es/concepts/sessions.md)
- [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)
- [Recibiendo mensajes](https://gowa-docs.mintlify.site/es/examples/receiving-messages.md)
- [Final de webhook de Chatwoot](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/final-de-webhook-de-chatwoot.md)
- [Grupos de Lista de Usuarios](https://gowa-docs.mintlify.site/es/api-reference/user/grupos-de-lista-de-usuarios.md)


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