Webhook’lar
GOWA’yı bir webhook URL’si ve gizli anahtarla başlatın: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: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 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 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:{"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:
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.