Langsung ke konten utama
GOWA menyediakan dua cara untuk menerima pesan:

Webhook

Jalankan GOWA dengan URL dan secret webhook:
Pesan teks diterima dalam bentuk:
Dalam grup, chat_id adalah JID grup (...@g.us) dan from adalah anggota yang mengirim pesan.

Contoh: bot balasan otomatis

Verifikasi tanda tangan, berikan respons penerimaan, lalu balas melalui API menggunakan perangkat yang sama:
Contoh minimal ini memberikan respons penerimaan sebelum mengirim balasan. Untuk produksi, simpan event yang telah diverifikasi ke antrean persisten sebelum memberikan respons penerimaan, lakukan deduplikasi berdasarkan perangkat, chat, dan ID pesan, lalu ulangi pengiriman yang gagal di worker Anda. Lewati event tanpa session_id atau tentukan perangkat yang benar secara eksplisit. Untuk mengirim balasan tetap ke setiap pesan, gunakan WHATSAPP_AUTO_REPLY="We'll get back to you soon" tanpa perlu menulis kode. Lihat Webhook untuk semua jenis event, field media, percobaan ulang, dan URL per perangkat.

Menangani struktur event baru

Header album adalah event message dengan payload.album tanpa isi teks. Setiap gambar atau video menyusul sebagai event media terpisah dengan payload.album_id. Kelompokkan media berdasarkan ID tersebut alih-alih menganggap header sebagai pesan yang hilang. newsletter.message memuat pembaruan penghitung kanal dan tidak menjamin adanya isi postingan baru. Pembaruan status online dan offline kontak menggunakan presence, memerlukan POST /user/presence/subscribe, serta mengharuskan klien Anda tetap tersedia. Perubahan nama grup menggunakan group.info. Berlanggananlah ke device.logged_out, device.temporary_ban, dan device.reachout_timelock untuk membedakan pembatasan akun dari terputusnya koneksi biasa. Event ini selalu mengidentifikasi slot melalui session_id. Lihat Webhook untuk field dan konfigurasi status kehadiran.

API penyimpanan chat

GOWA mencatat chat dan pesan untuk setiap slot di penyimpanan chat lokal. Lakukan kueri per perangkat:
Hanya pesan yang pernah diterima GOWA (saat terhubung atau melalui sinkronisasi riwayat WhatsApp) yang tersedia. Untuk meminta riwayat chat yang lebih lama dari ponsel, panggil POST /chat/{chat_jid}/history dengan {"count": 50}; pesan akan diterima secara asinkron. Polling cocok untuk mengambil pesan yang terlewat dan menampilkan kotak masuk. Untuk bot dan otomatisasi, gunakan webhook.

Mengunduh media

Jika unduhan otomatis aktif (default), webhook memberikan path di bawah statics/media/, yang disajikan melalui http://localhost:3000/statics/media/<file>. Jika tidak, ambil media saat diperlukan:
Lihat Media masuk untuk persyaratan agar GOWA dapat memulihkan file yang kedaluwarsa.

Tanda dibaca

Tandai pesan sebagai dibaca (centang biru) dengan POST /message/{message_id}/read dan {"phone": "<chat_jid>"}, atau atur WHATSAPP_AUTO_MARK_READ=true untuk menandai setiap pesan masuk sebagai dibaca secara otomatis.