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

# WebSocket olayları

> Bir paneli GOWA'nın WebSocket'ine bağlayın, cihaz ve eşleştirme olaylarını işleyin, yeniden bağlandıktan veya oturum açtıktan sonra cihaz durumunu yenileyin.

GOWA, eşleştirme ve cihaz olaylarını `/ws` üzerinden gönderir. Her çerçeve; makine tarafından okunabilen bir `code`, insan tarafından okunabilen bir `message` ve yapısı olaya bağlı olan bir `result` içeren JSON nesnesi taşır.

## Bağlanma

`APP_BASE_PATH` altında `/ws` yolunu kullanın; örneğin `wss://gowa.example.com/gowa/ws`. `?device_id=<id>` ile bir cihaz seçin. Basic Auth etkin olduğunda tarayıcı istemcileri, `user:password` değerinin URL kodlaması uygulanmış base64 karşılığını `authorization` olarak iletir. `Authorization` üst bilgisini ayarlayabilen istemciler Basic Auth'u bu üst bilgi üzerinden kullanabilir. `wss://` kullanın ve proxy günlüklerinde sorgu dizesini gizleyin. Paneli ayrı barındırıyorsanız panelin origin'ini GOWA'nın [güvenilir tarayıcı origin'lerine](https://gowa-docs.mintlify.site/tr/authentication.md#cors) ekleyin.

Bağlantıda bir cihaz belirtilse bile bağlı her soket tüm yayınları alır. Mevcut olduğunda etkilenen yuvayı belirlemek için `result.device_id` kullanın. WebSocket erişimini yalnızca tüm cihazlar için güvenilen çağrı yapanlara verin.

## Olay yükleri

| `code` | Ne zaman gelir | `result` |
| - | - | - |
| `LIST_DEVICES` | Bir istemci `FETCH_DEVICES` gönderdiğinde. | `name`, `device` ve `jid` girdilerini içeren cihaz listesi. |
| `LOGIN_SUCCESS` | WhatsApp cihazı eşleştirdiğinde. | `null`. Cihaz durumunu REST üzerinden yenileyin. |
| `PASSKEY_REQUEST` | WhatsApp bir geçiş anahtarı doğrulama yanıtı istediğinde. | `device_id`, `challenge` (WebAuthn seçenekleri). |
| `PASSKEY_CONFIRMATION` | WhatsApp geçiş anahtarı aktarım sonucunu bildirdiğinde. | `device_id`, `code`, `skip_handoff_ux`. `skip_handoff_ux` true olduğunda etkin QR akışı onayı otomatik olarak gönderir. Aksi durumda kodu telefondakiyle karşılaştırın ve `POST /app/passkey/confirm` çağrısını yapın. |
| `PASSKEY_ERROR` | Geçiş anahtarıyla eşleştirme başarısız olduğunda. | `device_id`, `continuation`. Hata metnini `message` alanından okuyun. |
| `DEVICE_LOGGED_OUT` | Cihaz, yuvası korunarak oturumu kapattığında. | `device_id` ve uzaktan oturum kapatma için `reason` ya da API üzerinden oturum kapatma için `devices`. Listenin yapısı oturum kapatma uç noktasına bağlıdır. |
| `DEVICE_REMOVED` | Cihaz yuvası silindiğinde. | `device_id`, `devices` (kalan yuvalar). |
| `DEVICE_STREAM_REPLACED` | Aynı WhatsApp oturumuyla başka bir istemci bağlandığında. | `device_id`. |
| `DEVICE_TEMPORARY_BAN` | WhatsApp geçici bir yasak bildirdiğinde. | `device_id`, `code`, `reason`, `expires_in_seconds` ve WhatsApp bitiş zamanı sağladığında `expires_at`. |
| `DEVICE_REACHOUT_TIMELOCK` | WhatsApp yeni sohbet başlatma kısıtlaması bildirdiğinde veya kaldırdığında. | `device_id`, `is_active` ve isteğe bağlı `enforcement_type` ile `ends_at`. |
| `DEVICE_WEBHOOK_UPDATED` | Cihazın webhook URL'si değiştiğinde. | `device_id`, `webhook_url`. |
| `DEVICE_WEBHOOK_CONFIG_UPDATED` | Cihazın webhook ayarları değiştiğinde. | `device_id`. |

## Cihaz durumunu yenileme

Soket üzerinden liste istemek için metin çerçevesi olarak `{"code":"FETCH_DEVICES"}` gönderin. GOWA, oluşan `LIST_DEVICES` olayını tüm soketlere yayınlar. Yeniden bağlanma veya eşleştirme sonrasında güncel durumu almak için `GET /devices` ya da `GET /devices/{device_id}/status` çağrısını yapın. WebSocket olayları geçicidir.

```javascript theme={null}
const url = new URL("wss://gowa.example.com/ws");
url.searchParams.set("device_id", "my-device");
url.searchParams.set("authorization", btoa("admin:changeme"));

const socket = new WebSocket(url);
socket.addEventListener("open", () => {
  socket.send(JSON.stringify({ code: "FETCH_DEVICES" }));
});
socket.addEventListener("message", ({ data }) => {
  const { code, result } = JSON.parse(data);
  if (code === "LIST_DEVICES") {
    console.log("Device list", result);
  }
  if (code === "DEVICE_LOGGED_OUT" && result?.device_id === "my-device") {
    console.log("Device logged out", result.device_id);
  }
});
```

Geçiş anahtarı isteğini tamamlayan REST çağrıları için [Geçiş anahtarıyla eşleştirme](https://gowa-docs.mintlify.site/tr/authentication.md#ge%C3%A7i%C5%9F-anahtar%C4%B1) sayfasına bakın. WhatsApp mesajlarını ve alındı bildirimlerini işlemek için [webhook'ları](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) kullanın.


## Related topics

- [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/authentication.md)
- [API Kimlik Doğrulaması](https://gowa-docs.mintlify.site/tr/api-reference/authentication.md)
- [Çoklu Cihaz ve Cihaz Seçimi](https://gowa-docs.mintlify.site/tr/concepts/multidevice.md)
- [Webhook’lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md)
- [API Referansı](https://gowa-docs.mintlify.site/tr/api-reference/introduction.md)


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