Ana içeriğe atla
GOWA, mesaj almak için iki yöntem sunar:

Webhook’lar

GOWA’yı bir webhook URL’si ve gizli anahtarla başlatın:
Bir metin mesajı şu biçimde gelir:
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:
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 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:
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:
GOWA’nın süresi dolmuş bir dosyayı kurtarabilmesi için gereken koşulları 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.