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

# Sesiones y ciclo de vida de la conexión

> Cómo GOWA almacena las sesiones WhatsApp, se conecta después de reiniciar, y qué hacen para cerrar sesión y eliminar.

Una **sesión** es la identidad criptográfica que WhatsApp emite al emparejar una ranura de dispositivo. GOWA lo mantiene en su base de datos, por lo que una ranura permanece vinculada entre reinicios hasta que se cierre la sesión en GOWA o desde el teléfono.

## Ciclo de vida

```mermaid theme={null}
flowchart LR
  A[POST /devices] --> B[disconnected]
  B -->|login: QR / pairing code| C[connected]
  C -->|scan or code accepted| D[logged_in]
  D -->|network drop| E[connecting]
  E --> D
  D -->|logout from GOWA or phone| B
  B -->|DELETE /devices/id| F[removed]
```

| Evento | Qué hace GOWA |
| - | - |
| Inicio del servidor | Carga cada ranura y, unos 2 segundos después del arranque, vuelve a conectar los que tienen una sesión almacenada. |
| Conexión perdida | Whatsmeow se conecta automáticamente. Una comprobación de fondo también se ejecuta cada 5 minutos y conecta a un cliente soltado. |
| Reconexión manual | `POST /devices/{device_id}/reconnect` o `GET /app/reconnect`. |
| Cerrar sesión | `POST /devices/{device_id}/logout` o `GET /app/logout`. Desenlaces de WhatsApp, elimina las claves de sesión, mantiene la ranura. |
| Desvinculado del teléfono | Igual que cerrar sesión: la ranura permanece y debe emparejarse de nuevo. |
| Eliminar | `DELETE /devices/{device_id}`. Sale, luego elimina la ranura y sus datos de chat. |

Marque una franja horaria en cualquier momento:

```bash theme={null}
curl -u admin:changeme http://localhost:3000/devices/my-device/status
```

`is_connected` refleja el socket; `is_logged_in` refleja si la sesión es válida. Ambos deben ser `true` para enviar.

## Donde se almacenan las sesiones

| Ajustes | Por defecto | Contenido |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | whatsmeow device store: claves de identidad, sesiones, contactos. SQLite o PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | vacío (usa `DB_URI`) | Base de datos opcional separada para la caché de claves de cifrado. Evite el almacenamiento en memoria en producción; un reinicio perdería el estado de sesión. |
| (arreglado) | `file:storages/chatstorage.db` | Registro de dispositivos, historial de chat y mensajes, envíos programados, enlaces de Chatwoot. |

Cualquiera con estos archivos puede actuar como las cuentas vinculadas. GOWA crea directorios de almacenamiento local con el modo `0700` y protege los archivos de base de datos de sesión local y los sidecars SQLite con el modo `0600`. Mantén las copias de seguridad cifradas y preserva esos permisos al restaurar. No coloques el almacenamiento de sesión bajo el directorio público `statics/`.

### Respaldar y restaurar

Detener GOWA (o instantánear el volumen), luego copiar `storages/`. Con PostgreSQL para `DB_URI`, haz una copia de seguridad de esa base de datos **y** `storages/chatstorage.db` juntos. Restaurar ambos trae cada ranura de vuelta sin emparejar de nuevo.

No ejecute dos instancias de GOWA contra los mismos datos de sesión. WhatsApp ve dos clientes con una identidad y desconecta uno de ellos.

Una ranura mantiene su URL de webhook por dispositivo, firmando la clave y filtros de eventos al cerrar sesión y emparejar de nuevo. Eliminar la ranura elimina su configuración. Suscríbase a `device.logged_out`, `device.temporary_ban`, y `device.reachout_timelock` para distinguir las restricciones de la cuenta de una desconexión de red. Vea [Webhooks](https://gowa-docs.mintlify.site/es/concepts/webhooks.md).

Para sesiones de PostgreSQL administradas, vea la [guía de configuración de Neon](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md). Cambiar `DB_URI` no migra sesiones existentes. El historial de registro y chat permanece en SQLite local, así que persiste `storages/` también.

## Presencia

| Ajustes | Por defecto | Efecto |
| - | - | - |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `unavailable` | Presencia enviada después de conectar: `available`, `unavailable` o `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `true` | Periodically marks the account `available` for a short window, then `unavailable` again. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `24h` | Tiempo entre pulsaciones. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `5m` | Cuánto tiempo permanece cada pulso `available`. |

Establece la presencia manualmente con `POST /send/presence` (`{"type": "available"}` o `"unavailable"`).

## Solución de problemas

| Síntomas | Probablemente causa | Fijar |
| - | - | - |
| `is_logged_in: false` después de reiniciar | La sesión fue desvinculada del teléfono, o `storages/` no persistía. | Monta `/app/storages` como un volumen; empareja de nuevo. |
| La ranura sigue desconectándose | Otro proceso utiliza la misma sesión, o el teléfono ha estado fuera de línea durante unos 14 días. | Ejecuta una sola instancia; abre WhatsApp en el teléfono. |
| QR expira antes de escanear | `qr_duration` transcurrido. | Llame de nuevo al punto final de inicio de sesión o utilice un código de emparejamiento. |
| Envíos fallidos con "no conectado" | El espacio existe pero no está emparejado. | Verifique `/devices/{device_id}/status`; empareja de nuevo. |


## Related topics

- [Obtener estado de conexión](https://gowa-docs.mintlify.site/es/api-reference/app/obtener-estado-de-conexión.md)
- [Obtener estado de conexión del dispositivo](https://gowa-docs.mintlify.site/es/api-reference/device/obtener-estado-de-conexión-del-dispositivo.md)
- [Selección de dispositivo y dispositivo múltiple](https://gowa-docs.mintlify.site/es/concepts/multidevice.md)
- [Obtener métricas de salud del servidor](https://gowa-docs.mintlify.site/es/api-reference/app/obtener-métricas-de-salud-del-servidor.md)
- [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)


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