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

# Oturumlar ve Bağlantı Yaşam Döngüsü

> GOWA’nın WhatsApp oturumlarını nasıl sakladığı, yeniden başlatmalardan sonra nasıl bağlandığı ve oturum kapatma ile kaldırmanın ne yaptığı.

**Oturum**, bir cihaz yuvasını eşleştirdiğinizde WhatsApp’ın verdiği kriptografik kimliktir. GOWA bunu veritabanında saklar; böylece GOWA’dan veya telefondan oturum kapatılana kadar yuva, yeniden başlatmalar arasında bağlı kalır.

## Yaşam döngüsü

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

| Olay | GOWA’nın yaptığı işlem |
| - | - |
| Sunucu başlangıcı | Tüm yuvaları yükler ve açılıştan yaklaşık 2 saniye sonra, saklanan bir oturumu olanları yeniden bağlar. |
| Bağlantı kaybı | whatsmeow otomatik olarak yeniden bağlanır. Ayrıca her 5 dakikada bir arka plan denetimi çalışır ve bağlantısı kesilen istemciyi yeniden bağlar. |
| Elle yeniden bağlanma | `POST /devices/{device_id}/reconnect` veya `GET /app/reconnect`. |
| Oturumu kapatma | `POST /devices/{device_id}/logout` veya `GET /app/logout`. WhatsApp bağlantısını kaldırır, oturum anahtarlarını siler, yuvayı korur. |
| Telefondan bağlantının kaldırılması | Oturumu kapatmayla aynıdır: yuva kalır ve yeniden eşleştirilmesi gerekir. |
| Kaldırma | `DELETE /devices/{device_id}`. Oturumu kapatır, ardından yuvayı ve sohbet verilerini siler. |

Bir yuvayı istediğiniz zaman kontrol edin:

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

`is_connected` soketin durumunu; `is_logged_in` ise oturumun geçerli olup olmadığını yansıtır. Göndermek için ikisi de `true` olmalıdır.

## Oturumların saklandığı yer

| Ayar | Varsayılan | İçerik |
| - | - | - |
| `DB_URI` | `file:storages/whatsapp.db` | whatsmeow cihaz deposu: kimlik anahtarları, oturumlar, kişiler. SQLite veya PostgreSQL (`postgres://...`). |
| `DB_KEYS_URI` | boş (`DB_URI` kullanılır) | Şifreleme anahtarı önbelleği için isteğe bağlı ayrı veritabanı. Üretimde bellek içi depolamadan kaçının; yeniden başlatma oturum durumunu kaybettirir. |
| (sabit) | `file:storages/chatstorage.db` | Cihaz kayıtları, sohbet ve mesaj geçmişi, zamanlanmış gönderimler, Chatwoot bağlantıları. |

Bu dosyalara sahip herkes, bağlı hesaplar adına işlem yapabilir. GOWA, yerel depolama dizinlerini `0700` moduyla oluşturur; yerel oturum veritabanı dosyalarını ve SQLite yardımcı dosyalarını `0600` moduyla korur. Yedekleri şifreli tutun ve geri yüklerken bu izinleri koruyun. Oturum deposunu herkese açık `statics/` dizininin altına yerleştirmeyin.

### Yedekleme ve geri yükleme

GOWA’yı durdurun (veya birimin anlık görüntüsünü alın), ardından `storages/` dizinini kopyalayın. `DB_URI` için PostgreSQL kullanıyorsanız bu veritabanını **ve** `storages/chatstorage.db` dosyasını birlikte yedekleyin. İkisini de geri yüklemek, yeniden eşleştirme gerektirmeden tüm yuvaları geri getirir.

Aynı oturum verileri üzerinde iki GOWA örneği çalıştırmayın. WhatsApp, tek kimlikle iki istemci görür ve bunlardan birinin bağlantısını keser.

Oturumu kapatıp yeniden eşleştirdiğinizde yuva, cihaz başına webhook URL’sini, imzalama anahtarını ve olay filtrelerini korur. Yuvayı silmek yapılandırmasını kaldırır. Hesap kısıtlamalarını ağ bağlantısı kesilmesinden ayırt etmek için `device.logged_out`, `device.temporary_ban` ve `device.reachout_timelock` olaylarına abone olun. Bkz. [Webhook’lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md).

Yönetilen PostgreSQL oturumları için [Neon kurulum kılavuzuna](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/neon.md) bakın. `DB_URI` değerini değiştirmek mevcut oturumları taşımaz. Kayıtlar ve sohbet geçmişi yerel SQLite’ta kalır; bu nedenle `storages/` dizinini de kalıcı olarak saklayın.

## Çevrimiçi durumu

| Ayar | Varsayılan | Etki |
| - | - | - |
| `WHATSAPP_PRESENCE_ON_CONNECT` | `unavailable` | Bağlantı sonrası gönderilen çevrimiçi durumu: `available`, `unavailable` veya `none`. |
| `WHATSAPP_PRESENCE_PULSE_ENABLED` | `true` | Hesabı düzenli aralıklarla kısa bir süre `available`, ardından tekrar `unavailable` olarak işaretler. |
| `WHATSAPP_PRESENCE_PULSE_INTERVAL` | `24h` | Durum darbeleri arasındaki süre. |
| `WHATSAPP_PRESENCE_PULSE_DURATION` | `5m` | Her darbenin `available` kaldığı süre. |

Çevrimiçi durumunu `POST /send/presence` ile elle ayarlayın (`{"type": "available"}` veya `"unavailable"`).

## Sorun giderme

| Belirti | Olası neden | Çözüm |
| - | - | - |
| Yeniden başlatmadan sonra `is_logged_in: false` | Oturumun telefondan bağlantısı kaldırıldı veya `storages/` kalıcı olarak saklanmadı. | `/app/storages` dizinini bir birim olarak bağlayın; yeniden eşleştirin. |
| Yuvanın bağlantısı sürekli kesiliyor | Başka bir süreç aynı oturumu kullanıyor veya telefon yaklaşık 14 gündür çevrimdışı. | Tek bir örnek çalıştırın; telefonda WhatsApp’ı açın. |
| QR kodu taranmadan süresi doluyor | `qr_duration` süresi doldu. | Oturum açma uç noktasını yeniden çağırın veya eşleştirme kodu kullanın. |
| Gönderimler "oturum açılmadı" hatasıyla başarısız oluyor | Yuva var ancak eşleştirilmemiş. | `/devices/{device_id}/status` yolunu kontrol edin; yeniden eşleştirin. |


## Related topics

- [Bağlantı durumunu al](https://gowa-docs.mintlify.site/tr/api-reference/app/bağlantı-durumunu-al.md)
- [Çoklu Cihaz ve Cihaz Seçimi](https://gowa-docs.mintlify.site/tr/concepts/multidevice.md)
- [Yapılandırma başvurusu](https://gowa-docs.mintlify.site/tr/configuration.md)
- [Zamanlanmış Gönderimler](https://gowa-docs.mintlify.site/tr/examples/scheduled-sends.md)
- [Sunucu sağlık metriklerini al](https://gowa-docs.mintlify.site/tr/api-reference/app/sunucu-sağlık-metriklerini-al.md)


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