X-Device-Id. ID saluran berakhiran @newsletter; nomor kontak atau JID grup bukan ID saluran.
Atur URL server dan kredensial sebelum menjalankan contoh curl. Gunakan URL HTTPS publik untuk server jarak jauh dan sertakan APP_BASE_PATH jika dikonfigurasi.
Menemukan saluran
Cari metadata saluran menggunakannewsletter_id atau invite. Sediakan tepat satu parameter. Undangan dapat berupa tautan lengkap https://whatsapp.com/channel/... atau kodenya.
results berisi metadata saluran, termasuk ID, metadata thread, dan metadata penonton. Pencarian melalui undangan mendukung metadata publik tanpa perlu mengikuti saluran. Pencarian melalui JID bergantung pada akses akun yang dipilih ke saluran tersebut. viewer_metadata dapat bernilai null ketika WhatsApp hanya menyediakan metadata publik.
Untuk menjelajahi direktori, sediakan setidaknya satu kode negara. Untuk mencari berdasarkan nama, gunakan search_text.
Respons direktori menempatkan saluran di
results.data. Direktori menggunakan kueri WhatsApp yang tidak terdokumentasi dan dapat berubah terlepas dari GOWA.
Mengikuti atau berhenti mengikuti
POST /newsletter/unfollow untuk berhenti mengikuti. GET /user/my/newsletters menampilkan newsletter yang diikuti oleh akun yang dipilih.
Mengikuti saluran dan berlangganan pembaruan interaksi langsung merupakan operasi yang terpisah. Kelola langganan pembaruan langsung melalui /newsletter/live-updates.
Membaca pesan dan jumlah interaksi
GET /newsletter/messages membaca postingan langsung dari WhatsApp tanpa perlu mengikuti saluran. Riwayat yang tersedia ditentukan oleh WhatsApp. GOWA tidak menjamin periode retensi atau arsip yang lengkap. count memiliki nilai default 50 dan menerima 1–100. Untuk memuat postingan lebih lama, teruskan server_id tertua yang dikembalikan sebagai before.
results.data berisi postingan dengan server_id, message_id, type, timestamp, text, views_count, forwards_count, dan reaction_counts opsional. Kolom konten dapat tidak disertakan. WhatsApp melaporkan jumlah tayangan kepada admin saluran; akun lain dapat melihat views_count: 0.
Gunakan server_id numerik, bukan message_id, untuk paginasi dan pengunduhan media.
GET /newsletter/message-updates memperbarui jumlah interaksi tanpa mengambil konten pesan. after wajib diisi dan harus berupa ID server positif. Nilai default count adalah 50, dengan maksimum 100. Parameter opsional since adalah timestamp Unix nonnegatif dalam detik. Hasil menggunakan bentuk daftar results.data yang sama, dengan kolom konten dihilangkan ketika WhatsApp tidak mengembalikannya.
Menerima pembaruan jumlah interaksi secara langsung
Konfigurasikan webhook, lalu daftarkan langganan setiap perangkat ke saluran yang dibutuhkannya.results pada respons berisi newsletter_id, duration_seconds, expires_at, renewed_at, dan last_error opsional. WhatsApp memberikan langganan berdurasi singkat, yang teramati sekitar 90 detik. GOWA memperbaruinya sebelum kedaluwarsa dan setelah tersambung kembali. Event jumlah interaksi diterima sebagai webhook newsletter.message.
Tampilkan daftar langganan dengan GET /newsletter/live-updates. results.data memuat kolom status yang sama. Periksa last_error ketika pembaruan langganan gagal.
Langganan disimpan di memori dan tidak bertahan setelah server dimulai ulang. Buat kembali langganan setelah memulai ulang GOWA. Status langganan terikat pada perangkat yang dipilih.
Mengunduh media saluran
results berisi server_id, message_id, status, media_type, mime_type, filename, file_path, file_url, dan file_size. Handler REST menyediakan file_url sebagai URL statis publik untuk file yang disimpan. Respons ini bukan file biner. Postingan yang tidak ditemukan atau tidak memiliki media yang dapat diunduh menghasilkan kesalahan.