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

# Mesaj alma

> Gelen mesajları webhook'larla işleyin veya kayıtlı sohbetleri ve mesajları GOWA'nın sohbet deposundan okuyun.

GOWA, mesaj almak için iki yöntem sunar:

| Yöntem | Kullanım amacı |
| - | - |
| **Webhook'lar** (önerilen) | Olaylara gerçek zamanlı tepki verme. GOWA her olayı URL'nize gönderir. |
| **Sohbet depolama API'si** | Geçmişi okuma, kesinti sonrasında kaçırılanları alma, gelen kutusu görünümleri oluşturma. |

## Webhook'lar

GOWA'yı bir webhook URL'si ve gizli anahtarla başlatın:

```bash theme={null}
./whatsapp rest --basic-auth=admin:changeme \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=change-me \
  --webhook-events=message,message.ack
```

Bir metin mesajı şu biçimde gelir:

```json theme={null}
{
  "event": "message",
  "device_id": "628123456789@s.whatsapp.net",
  "session_id": "my-device",
  "payload": {
    "id": "3EB0C127D7BACC83D6A1",
    "chat_id": "628987654321@s.whatsapp.net",
    "from": "628987654321@s.whatsapp.net",
    "from_name": "John Doe",
    "sender_display_name": "John Doe",
    "timestamp": "2026-10-15T10:30:00Z",
    "is_from_me": false,
    "body": "Hello, how are you?"
  }
}
```

Bir grupta `chat_id`, grubun JID'sidir (`...@g.us`); `from` ise mesajı gönderen üyedir.

### Örnek: otomatik yanıt botu

İmzayı doğrulayın, alındığını bildirin, ardından aynı cihazla API üzerinden yanıt verin:

```javascript theme={null}
const express = require("express");
const crypto = require("crypto");

const GOWA = "http://localhost:3000";
const AUTH = "Basic " + Buffer.from("admin:changeme").toString("base64");
const SECRET = "change-me";

const app = express();
app.post("/wa-hook", express.raw({ type: "application/json" }), async (req, res) => {
  const sig = crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const received = req.get("X-Hub-Signature-256") || "";
  const expected = `sha256=${sig}`;
  if (!/^sha256=[0-9a-f]{64}$/.test(received) ||
      received.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const evt = JSON.parse(req.body);
  res.sendStatus(200);
  if (evt.event !== "message" || evt.payload.is_from_me) return;
  if (!evt.session_id) return;
  if (!/^hi\b/i.test(evt.payload.body || "")) return;

  const response = await fetch(`${GOWA}/send/message`, {
    method: "POST",
    headers: {
      Authorization: AUTH,
      "Content-Type": "application/json",
      "X-Device-Id": evt.session_id,          // reply from the slot that received it
    },
    body: JSON.stringify({
      phone: evt.payload.chat_id,
      message: "Hello! How can we help?",
      reply_message_id: evt.payload.id,
    }),
  });
  if (!response.ok) console.error("GOWA reply failed", response.status);
});
app.listen(8080);
```

Bu basit örnek, yanıtı göndermeden önce alındı bildirimi verir. Üretimde, doğrulanan olayı alındı bildirimi vermeden önce kalıcı bir kuyruğa ekleyin, cihaz, sohbet ve mesaj kimliğine göre yinelenenleri ayıklayın ve başarısız gönderimleri işçinizde yeniden deneyin. `session_id` içermeyen olayları atlayın veya doğru cihazı açıkça belirleyin.

Her mesaja sabit bir yanıt vermek için `WHATSAPP_AUTO_REPLY="We'll get back to you soon"`, kod yazmadan bu işi yapar.

Tüm olay türleri, medya alanları, yeniden denemeler ve cihaza özel URL'ler için [Webhook'lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) bölümüne bakın.

### Yeni olay biçimlerini işleme

Albüm başlığı, `payload.album` içeren ve metin gövdesi olmayan bir `message` olayıdır. Her görüntü veya video, `payload.album_id` içeren ayrı bir medya olayı olarak ardından gelir. Başlığı eksik mesaj olarak değerlendirmek yerine medyayı bu kimliğe göre gruplayın.

`newsletter.message`, kanal sayaç güncellemelerini içerir ve yeni gönderi gövdesini garanti etmez. Kişilerin çevrimiçi ve çevrimdışı durum güncellemeleri `presence` kullanır, `POST /user/presence/subscribe` gerektirir ve istemcinizin erişilebilir kalmasını gerektirir. Grup adı değişiklikleri `group.info` kullanır.

Hesap kısıtlamalarını normal bağlantı kesilmelerinden ayırmak için `device.logged_out`, `device.temporary_ban` ve `device.reachout_timelock` olaylarına abone olun. Bu olaylar her zaman `session_id` ile cihaz yuvasını belirtir. Alanlar ve çevrimiçi durum yapılandırması için [Webhook'lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) bölümüne bakın.

## Sohbet depolama API'si

GOWA, her cihaz yuvasının sohbetlerini ve mesajlarını yerel sohbet deposuna kaydeder. Cihaz bazında sorgulayın:

```bash theme={null}
# list chats (filters: search, has_media, archived; paging: limit, offset)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chats?limit=20"

# messages in one chat (filters: start_time, end_time, media_only, is_from_me, search)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chat/628987654321@s.whatsapp.net/messages?limit=50"
```

Yalnızca GOWA'nın gördüğü (bağlıyken alınan veya WhatsApp geçmiş eşitlemesiyle iletilen) mesajlar kullanılabilir. Telefondan bir sohbetin daha eski geçmişini istemek için `{"count": 50}` ile `POST /chat/{chat_jid}/history` çağrısı yapın; mesajlar eşzamansız olarak gelir.

Periyodik sorgulama, kaçırılanları almak ve gelen kutusu görünümleri için uygundur. Botlar ve otomasyonlar için webhook kullanın.

## Medya indirme

Otomatik indirme açıkken (varsayılan), webhook, `http://localhost:3000/statics/media/<file>` adresinden sunulan `statics/media/` altındaki bir yolu verir. Aksi halde medyayı gerektiğinde alın:

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/message/3EB0C127D7BACC83D6A3/download?phone=628987654321@s.whatsapp.net"
```

GOWA'nın süresi dolmuş bir dosyayı kurtarabilmesi için gereken koşulları [Gelen medya](https://gowa-docs.mintlify.site/tr/examples/media-handling.md#gelen-medya) bölümünde bulabilirsiniz.

## Okundu bilgileri

`POST /message/{message_id}/read` ve `{"phone": "<chat_jid>"}` ile bir mesajı okundu olarak işaretleyin (mavi tikler) veya her gelen mesajı otomatik olarak okundu işaretlemek için `WHATSAPP_AUTO_MARK_READ=true` ayarını yapın.


## Related topics

- [Webhook’lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md)
- [Mesaj Gönderme](https://gowa-docs.mintlify.site/tr/examples/sending-messages.md)
- [Mesaj gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/mesaj-gönder.md)
- [Bülten mesaj sayaçlarını getir](https://gowa-docs.mintlify.site/tr/api-reference/newsletter/bülten-mesaj-sayaçlarını-getir.md)
- [Mesaj geçmişini Chatwoot ile eşitle](https://gowa-docs.mintlify.site/tr/api-reference/chatwoot/mesaj-geçmişini-chatwoot-ile-eşitle.md)


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