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

# WhatsApp kanalları

> Bültenleri bulun, takip edin ve okuyun; kanal medyasını indirin ve canlı etkileşim güncellemelerini alın.

GOWA, API'sinde WhatsApp kanallarını **newsletters** (bültenler) olarak adlandırır. Bu sayfadaki tüm istekler Basic Auth ve `X-Device-Id` ile seçilen, oturum açmış bir cihaz kullanır. Kanal kimliği `@newsletter` ile biter; kişi numarası veya grup JID'si kanal kimliği değildir.

curl örneklerini çalıştırmadan önce sunucu URL'sini ve kimlik bilgilerini ayarlayın. Uzak bir sunucu için genel HTTPS URL'sini kullanın ve yapılandırılmışsa `APP_BASE_PATH` değerini ekleyin.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Kanal bulma

Kanal meta verilerini `newsletter_id` veya `invite` ile sorgulayın. Tam olarak birini sağlayın. Davet, tam bir `https://whatsapp.com/channel/...` bağlantısı veya davet kodu olabilir.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'invite=https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M' \
  "$GOWA_URL/newsletter/info"
```

`results`; kimlik, ileti dizisi meta verileri ve görüntüleyici meta verileri dahil kanal meta verilerini içerir. Davetle sorgulama, kanalı takip etmeden genel meta verilere erişimi destekler. JID ile sorgulama, seçilen hesabın kanala erişimine bağlıdır. WhatsApp yalnızca genel meta verileri sağladığında `viewer_metadata`, `null` olabilir.

Dizine göz atmak için en az bir ülke kodu sağlayın. Ada göre arama yapmak için `search_text` kullanın.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'country_codes=ID' --data-urlencode 'view=TRENDING' \
  --data-urlencode 'limit=20' "$GOWA_URL/newsletter/directory"

curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'search_text=news' "$GOWA_URL/newsletter/directory"
```

| Sorgu | Davranış |
| - | - |
| `view` | Varsayılan olarak `RECOMMENDED`. `TRENDING`, `POPULAR`, `NEW` ve `FEATURED` değerlerini de kabul eder. Ad aramaları bu seçimi yok sayar. |
| `country_codes` | Yinelenen veya virgülle ayrılmış iki harfli ISO kodları. Göz atmak için zorunludur. Ad aramaları ülke filtrelemeyi desteklemez. |
| `categories` | `BUSINESS`, `ENTERTAINMENT`, `LIFESTYLE`, `NEWS`, `ORGANIZATIONS`, `PEOPLE` ve `SPORTS` arasından yinelenen veya virgülle ayrılmış değerler. |
| `limit` | Varsayılan `20`, aralık `1`–`50`. |
| `cursor` | `results.has_more`, `true` olduğu sürece önceki yanıtın `results.next_cursor` değerini kullanın. |

Dizin yanıtlarında kanallar `results.data` içinde yer alır. Dizin, belgelenmemiş WhatsApp sorgularını kullanır ve GOWA'dan bağımsız olarak değişebilir.

## Takip etme veya takipten çıkma

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/follow" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

Takipten çıkmak için aynı JSON gövdesini `POST /newsletter/unfollow` ile kullanın. `GET /user/my/newsletters`, seçilen hesabın takip ettiği bültenleri listeler.

Bir kanalı takip etmek ve canlı etkileşim güncellemelerine abone olmak ayrı işlemlerdir. Canlı abonelikleri `/newsletter/live-updates` üzerinden yönetin.

## Mesajları ve sayaçları okuma

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'count=50' "$GOWA_URL/newsletter/messages"
```

`GET /newsletter/messages`, takip gerektirmeden gönderileri doğrudan WhatsApp'tan okur. Kullanılabilir geçmişi WhatsApp kontrol eder. GOWA, saklama süresi veya eksiksiz arşiv garantisi vermez. `count` varsayılan olarak `50` değerindedir ve `1`–`100` kabul eder. Daha eski gönderileri yüklemek için döndürülen en eski `server_id` değerini `before` olarak iletin.

`results.data`, `server_id`, `message_id`, `type`, `timestamp`, `text`, `views_count`, `forwards_count` ve isteğe bağlı `reaction_counts` içeren gönderiler barındırır. İçerik alanları bulunmayabilir. WhatsApp, görüntülenmeleri kanal yöneticilerine bildirir; diğer hesaplar `views_count: 0` görebilir.

Sayfalama ve medya indirmeleri için `message_id` yerine sayısal `server_id` kullanın.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'after=123' --data-urlencode 'count=50' \
  "$GOWA_URL/newsletter/message-updates"
```

`GET /newsletter/message-updates`, mesaj içeriğini almadan sayaçları yeniler. `after` zorunludur ve pozitif bir sunucu kimliği olmalıdır. `count` varsayılan olarak `50`, en fazla `100` değerindedir. İsteğe bağlı `since`, saniye cinsinden negatif olmayan bir Unix zaman damgasıdır. Sonuçlar aynı `results.data` liste biçimini kullanır; WhatsApp döndürmediğinde içerik alanları eklenmez.

## Canlı sayaç güncellemelerini alma

Bir [webhook](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md) yapılandırın, ardından her cihazı ihtiyaç duyduğu kanallara abone edin.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/live-updates" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

Yanıttaki `results`, `newsletter_id`, `duration_seconds`, `expires_at`, `renewed_at` ve isteğe bağlı `last_error` içerir. WhatsApp, yaklaşık 90 saniye olarak gözlemlenen kısa bir abonelik sağlar. GOWA bunu süre dolmadan ve yeniden bağlanmalardan sonra yeniler. Sayaç olayları `newsletter.message` webhook'ları olarak gelir.

Abonelikleri `GET /newsletter/live-updates` ile listeleyin. `results.data` aynı durum alanlarını içerir. Yenileme başarısız olduğunda `last_error` alanını inceleyin.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" -X DELETE --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/live-updates"
```

Aboneliği silmek yenilemeyi durdurur. WhatsApp, mevcut izin süresi dolana kadar güncelleme iletmeye devam edebilir. Yeniden bağlanma veya devam eden bir yenileme, iptal edilmiş aboneliği yeniden etkinleştirmez. Aboneliği olmayan bir kanalı silmek doğrulama hatası döndürür.

> [!NOTE]
>
> Abonelikler bellekte tutulur ve sunucu yeniden başlatıldığında korunmaz. GOWA'yı yeniden başlattıktan sonra bunları yeniden oluşturun. Abonelik durumu seçilen cihaza aittir.

## Kanal medyasını indirme

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/messages/123/download"
```

Uç nokta, ilgili gönderiyi doğrudan WhatsApp'tan alır ve desteklenen medyayı sunucunun medya dizinine kaydeder. JSON `results` alanı; `server_id`, `message_id`, `status`, `media_type`, `mime_type`, `filename`, `file_path`, `file_url` ve `file_size` içerir. REST işleyicisi, kaydedilen dosya için `file_url` değerini herkese açık statik URL olarak sağlar. Bu, ikili dosya yanıtı değildir. Eksik bir gönderi veya indirilebilir medyası olmayan bir gönderi hata döndürür.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/tr/index.md)
- [WhatsApp sunucusuna yeniden bağlan](https://gowa-docs.mintlify.site/tr/api-reference/app/whatsapp-sunucusuna-yeniden-bağlan.md)
- [WhatsApp sunucusunda oturum aç](https://gowa-docs.mintlify.site/tr/api-reference/app/whatsapp-sunucusunda-oturum-aç.md)
- [Kullanıcının WhatsApp’ta olup olmadığını kontrol et](https://gowa-docs.mintlify.site/tr/api-reference/user/kullanıcının-whatsapp’ta-olup-olmadığını-kontrol-et.md)
- [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/authentication.md)


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