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

# Сессии и жизненный цикл соединений

> Как GOWA хранит сессии WhatsApp, пересоединяется после перезапуска, а также что делают выходы и удаление.

**Сессия** — это криптографический идентификатор WhatsApp при паре слота устройства. GOWA хранит его в своей базе данных, так что слот остается привязанным к перезапускам до тех пор, пока он не выйдет из GOWA или с телефона.

## Жизненный цикл

```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]
```

| Событие | Что делает GOWA |
| - | - |
| Запуск сервера | Загружает каждый слот и примерно 2 секунды после загрузки, пересоединяет его с сохраненной сессией. |
| Соединение потеряно | Что такое "whatsmeow" подключается автоматически. Фоновая проверка также работает каждые 5 минут и пересоединяется с удаленным клиентом. |
| Ручное переподключение | `POST /devices/{device_id}/reconnect` или `GET /app/reconnect`. |
| Выйти | `POST /devices/{device_id}/logout` или `GET /app/logout`. Разблокируйте ссылки из WhatsApp, удаляет ключи сессии, сохранит слот. |
| Отвязать от телефона | То же, что и выйти: слот остается и должен быть сопряжен снова. |
| Удаление | `DELETE /devices/{device_id}`. Выход, затем удаляет слот и данные чата. |

Проверьте ячейку в любое время:

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

`is_connected` отражает socket; `is_logged_in` отражает правильность сеанса. Оба файла должны быть `true` для отправки.

## Где хранятся сессии

| Настройка | По умолчанию | Содержание |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | whatsmeow магазин устройства: идентификационные ключи, сессии, контакты. SQLite или PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | пустой (используется `DB_URI`) | Необязательная отдельная база данных для кэша ключей шифрования. Избегайте хранения в памяти; перезагрузка потеряет состояние сеанса. |
| (исправлено) | `file:storages/chatstorage.db` | Журнал устройств, чат и история сообщений, запланированные отправки, ссылки на Chatwoot. |

Любой пользователь с этими файлами может выполнять роль связанных учетных записей. GOWA создает локальные хранилища каталогов с режимом `0700` и защищает локальные файлы базы данных и SQLite с режимом `0600`. Сохранять резервные копии в зашифрованном виде и сохранять эти разрешения при восстановлении. Не помещайте хранилище сессий в публичный каталог `statics/`.

### Резервное копирование и восстановление

Остановите GOWA (или сделайте снимок тома), затем скопируйте `storages/`. С PostgreSQL для `DB_URI` сделайте резервную копию этой базы данных **и** `storages/chatstorage.db` вместе. Восстановление обоих слотов возвращает обратно без сопряжения снова.

Не запускайте два GOWA экземпляра с одинаковыми данными сессий. WhatsApp видит двух клиентов с одной идентификацией и разъединяет одну из них.

Слот сохраняет URL вебхука, ключ подписи и фильтры событий устройства при выходе из аккаунта и повторном сопряжении. При удалении слота его конфигурация удаляется. Подпишитесь на `device.logged_out`, `device.temporary_ban` и `device.reachout_timelock`, чтобы отличать ограничения аккаунта от разрыва сетевого соединения. См. [Вебхуки](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md).

Управляемые сеансы PostgreSQL смотрите [Руководство по Неоновой установке](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md). Изменение `DB_URI` не переносит существующие сеансы. История реестра и чата остается в локальном SQLite, так что сохраняйте и `storages/`.

## Наличие

| Настройка | По умолчанию | Эффект |
| - | - | - |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `unavailable` | Присутствие отправлено после подключения: `available`, `unavailable` или `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `true` | Периодически устанавливает для учётной записи статус `available` на короткое время, затем снова меняет его на `unavailable`. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `24h` | Время между пульсами. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `5m` | Как долго каждый пульс остается `available`. |

Установите присутствие вручную с помощью `POST /send/presence` (`{"type": "available"}` или `"unavailable"`).

## Устранение проблем

| Симптом | Вероятная причина | Исправить |
| - | - | - |
| `is_logged_in: false` после перезапуска | Сеанс был отвязан от телефона, либо содержимое `storages/` не было сохранено. | Монтируйте `/app/storages` в качестве тома; снова пари снова. |
| Слот продолжает отключаться | Другой процесс использует ту же сессию или телефон был в автономном режиме около 14 дней. | Запустите один экземпляр; откройте WhatsApp на телефоне. |
| QR истекает до сканирования | Прошло `qr_duration`. | Снова вызовите конечную точку входа или используйте код сопряжения. |
| Отправлять не удалось с "не вошли в систему" | Ячейка существует, но не в паре. | Проверьте `/devices/{device_id}/status`; снова пар. |


## Related topics

- [События WebSocket](https://gowa-docs.mintlify.site/ru/api-reference/websocket.md)
- [Мульти-устройство и выбор устройства](https://gowa-docs.mintlify.site/ru/concepts/multidevice.md)
- [Проверка подлинности](https://gowa-docs.mintlify.site/ru/authentication.md)
- [MCP сервер](https://gowa-docs.mintlify.site/ru/integrations/mcp.md)
- [Ссылка на конфигурацию](https://gowa-docs.mintlify.site/ru/configuration.md)


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