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

# Sesi & Siklus Koneksi

> Cara GOWA menyimpan sesi WhatsApp, menyambung kembali setelah restart, serta dampak logout dan penghapusan.

**Sesi** adalah identitas kriptografis yang diterbitkan WhatsApp saat Anda memasangkan slot perangkat. GOWA menyimpannya dalam database, sehingga slot tetap tertaut setelah restart hingga logout dilakukan dari GOWA atau ponsel.

## Siklus koneksi

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

| Event | Tindakan GOWA |
| - | - |
| Server dimulai | Memuat semua slot dan, sekitar 2 detik setelah startup, menyambungkan kembali slot yang memiliki sesi tersimpan. |
| Koneksi terputus | whatsmeow menyambungkan kembali secara otomatis. Pemeriksaan latar belakang juga berjalan setiap 5 menit dan menyambungkan kembali klien yang terputus. |
| Sambungkan ulang secara manual | `POST /devices/{device_id}/reconnect` atau `GET /app/reconnect`. |
| Logout | `POST /devices/{device_id}/logout` atau `GET /app/logout`. Melepas tautan dari WhatsApp, menghapus kunci sesi, dan mempertahankan slot. |
| Tautan dilepas dari ponsel | Sama seperti logout: slot tetap ada dan harus dipasangkan ulang. |
| Penghapusan | `DELETE /devices/{device_id}`. Melakukan logout, lalu menghapus slot beserta data chat-nya. |

Periksa slot kapan saja:

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

`is_connected` menunjukkan status socket; `is_logged_in` menunjukkan apakah sesi valid. Keduanya harus bernilai `true` agar dapat mengirim.

## Lokasi penyimpanan sesi

| Pengaturan | Default | Isi |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | Penyimpanan perangkat whatsmeow: kunci identitas, sesi, dan kontak. SQLite atau PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | kosong (menggunakan `DB_URI`) | Database terpisah opsional untuk cache kunci enkripsi. Hindari penyimpanan dalam memori pada produksi; restart akan menghilangkan status sesi. |
| (tetap) | `file:storages/chatstorage.db` | Registri perangkat, riwayat chat dan pesan, pengiriman terjadwal, serta tautan Chatwoot. |

Siapa pun yang memiliki file ini dapat bertindak sebagai akun yang tertaut. GOWA membuat direktori penyimpanan lokal dengan mode `0700` serta melindungi file database sesi lokal dan file pendamping SQLite dengan mode `0600`. Enkripsi cadangan dan pertahankan izin tersebut saat memulihkan data. Jangan letakkan penyimpanan sesi di direktori publik `statics/`.

### Mencadangkan dan memulihkan

Hentikan GOWA (atau buat snapshot volume), lalu salin `storages/`. Jika menggunakan PostgreSQL untuk `DB_URI`, cadangkan database tersebut **dan** `storages/chatstorage.db` secara bersamaan. Memulihkan keduanya akan mengembalikan semua slot tanpa perlu memasangkan ulang.

Jangan jalankan dua instance GOWA dengan data sesi yang sama. WhatsApp akan melihat dua klien dengan satu identitas dan memutuskan salah satunya.

Slot mempertahankan URL webhook per perangkat, kunci penandatanganan, dan filter event saat Anda logout lalu memasangkannya kembali. Menghapus slot juga menghapus konfigurasinya. Berlangganan `device.logged_out`, `device.temporary_ban`, dan `device.reachout_timelock` untuk membedakan pembatasan akun dari koneksi jaringan yang terputus. Lihat [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md).

Untuk sesi PostgreSQL terkelola, lihat [panduan penyiapan Neon](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md). Mengubah `DB_URI` tidak memigrasikan sesi yang sudah ada. Registri dan riwayat chat tetap berada di SQLite lokal, sehingga `storages/` juga harus disimpan secara persisten.

## Presence

| Pengaturan | Default | Dampak |
| - | - | - |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `unavailable` | Presence yang dikirim setelah terhubung: `available`, `unavailable`, atau `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `true` | Secara berkala menandai akun sebagai `available` untuk waktu singkat, lalu kembali menjadi `unavailable`. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `24h` | Jeda antar-pulse. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `5m` | Durasi setiap pulse berada dalam status `available`. |

Atur presence secara manual dengan `POST /send/presence` (`{"type": "available"}` atau `"unavailable"`).

## Pemecahan masalah

| Gejala | Kemungkinan penyebab | Solusi |
| - | - | - |
| `is_logged_in: false` setelah restart | Tautan sesi dilepas dari ponsel, atau `storages/` tidak disimpan secara persisten. | Mount `/app/storages` sebagai volume; pasangkan ulang. |
| Slot terus terputus | Proses lain menggunakan sesi yang sama, atau ponsel sudah offline selama sekitar 14 hari. | Jalankan satu instance; buka WhatsApp di ponsel. |
| QR kedaluwarsa sebelum dipindai | `qr_duration` telah terlewati. | Panggil endpoint login lagi, atau gunakan kode pemasangan. |
| Pengiriman gagal dengan "not logged in" | Slot ada, tetapi belum dipasangkan. | Periksa `/devices/{device_id}/status`; pasangkan ulang. |


## Related topics

- [Ambil status koneksi](https://gowa-docs.mintlify.site/id/api-reference/app/ambil-status-koneksi.md)
- [Referensi Konfigurasi](https://gowa-docs.mintlify.site/id/configuration.md)
- [Praktik Terbaik untuk Produksi](https://gowa-docs.mintlify.site/id/advanced/best-practices.md)
- [Ambil status koneksi perangkat](https://gowa-docs.mintlify.site/id/api-reference/device/ambil-status-koneksi-perangkat.md)
- [Autentikasi](https://gowa-docs.mintlify.site/id/authentication.md)


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