> ## 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秒で、保存されたセッションと再接続されます。 |
| 接続が切断されました | バックグラウンドチェックはまた、5分ごとに実行され、ドロップされたクライアントを再接続します。 |
| 手動で再接続 | `POST /devices/{device_id}/reconnect` または `GET /app/reconnect` 。 |
| ログアウト | `POST /devices/{device_id}/logout` or `GET /app/logout` WhatsAppからリンクを解除し、セッションキーを削除し、スロットを保持します。 |
| 端末からのリンクを解除しました | ログアウトと同じ: スロットは維持され、再びペアリングする必要があります。 |
| 削除 | `DELETE /devices/{device_id}`. ログアウトし、スロットとそのチャットデータを削除します。 |

いつでもスロットをチェックします。

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

`is_connected` はソケットを反映します。`is_logged_in` はセッションが有効かどうかを反映します。どちらも送信するには`true`でなければなりません。

## セッションが保存されている場所

| 設定 | デフォルト | 内容 |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | whatsmeowデバイスストア: IDキー、セッション、連絡先。 SQLiteまたはPostgreSQL(`postgres://...`)。 |
| `DB_KEYS_URI` | 空（`DB_URI`を使用） | 暗号化キーキャッシュ用のオプションの別データベースです。本番環境でのインメモリストレージは避けてください。再起動するとセッション状態が失われます。 |
| （固定） | `file:storages/chatstorage.db` | デバイスレジストリ、チャットやメッセージの履歴、スケジュールされた送信、Chatwootリンク。 |

これらのファイルを持っている誰でもリンクされたアカウントとして機能することができます。 GOWAは、`0700`モードのローカルストレージディレクトリを作成し、`0600`モードのローカルセッションデータベースファイルとSQLiteサイドカーを保護します。 バックアップを暗号化し、復元時にそれらの権限を保持します。セッションストレージを公開の `statics/` ディレクトリの下に配置しないでください。

### バックアップと復元

GOWA を停止するか、ボリュームのスナップショットを取得してから、`storages/` をコピーしてください。`DB_URI` に PostgreSQL を使用している場合は、そのデータベース**と** `storages/chatstorage.db` をまとめてバックアップしてください。両方を復元すると、再ペアリングせずにすべてのスロットを復元できます。

同じセッションデータに対して2つのGOWAインスタンスを実行しないでください。 WhatsAppは、1つのアイデンティティを持つ2つのクライアントを見て、それらの1つを切断します。

スロットは、デバイス毎の webhook URL、署名キー、およびイベントフィルタをログアウトして再度ペアリングするときに保持します。 スロットを削除すると設定は削除されます。`device.logged_out`, `device.temporary_ban`, `device.reachout_timelock` は、ネットワーク切断とアカウントの制限を区別します。 [Webhooks](https://gowa-docs.mintlify.site/ja/concepts/webhooks.md) を参照してください。

管理対象の PostgreSQL セッションについては、[Neon setup guide](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md) を参照してください。`DB_URI` を変更すると、既存のセッションは移行されません。 レジストリとチャットの履歴はローカルの SQLite に残っているので、 `storages/` も保持されます。

## Presence

| 設定 | デフォルト | 効果 |
| - | - | - |
| `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

- [サーバーメトリック](https://gowa-docs.mintlify.site/ja/api-reference/metrics.md)
- [認証](https://gowa-docs.mintlify.site/ja/authentication.md)
- [ニュースレターのライブ更新を購読する](https://gowa-docs.mintlify.site/ja/api-reference/newsletter/ニュースレターのライブ更新を購読する.md)
- [デバイスのライブ更新サブスクリプションを一覧表示する](https://gowa-docs.mintlify.site/ja/api-reference/newsletter/デバイスのライブ更新サブスクリプションを一覧表示する.md)
- [Production Best Practices](https://gowa-docs.mintlify.site/ja/advanced/best-practices.md)


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