Ana içeriğe atla
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.

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

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

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.
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 yapılandırın, ardından her cihazı ihtiyaç duyduğu kanallara abone edin.
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.
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.
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

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.