> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Saluran WhatsApp

> Temukan, ikuti, dan baca newsletter, unduh media saluran, serta terima pembaruan interaksi secara langsung.

GOWA menyebut saluran WhatsApp sebagai **newsletter** dalam API-nya. Semua permintaan di halaman ini menggunakan Basic Auth dan perangkat yang sudah login, dipilih melalui `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.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Menemukan saluran

Cari metadata saluran menggunakan `newsletter_id` atau `invite`. Sediakan tepat satu parameter. Undangan dapat berupa tautan lengkap `https://whatsapp.com/channel/...` atau kodenya.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'invite=https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M' \
  "$GOWA_URL/newsletter/info"
```

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

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'country_codes=ID' --data-urlencode 'view=TRENDING' \
  --data-urlencode 'limit=20' "$GOWA_URL/newsletter/directory"

curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'search_text=news' "$GOWA_URL/newsletter/directory"
```

| Parameter kueri | Perilaku |
| - | - |
| `view` | Default `RECOMMENDED`. Juga menerima `TRENDING`, `POPULAR`, `NEW`, dan `FEATURED`. Pencarian nama mengabaikan pilihan ini. |
| `country_codes` | Kode ISO dua huruf, diulang atau dipisahkan koma. Wajib untuk penjelajahan. Pencarian nama tidak mendukung filter negara. |
| `categories` | Nilai yang diulang atau dipisahkan koma dari `BUSINESS`, `ENTERTAINMENT`, `LIFESTYLE`, `NEWS`, `ORGANIZATIONS`, `PEOPLE`, dan `SPORTS`. |
| `limit` | Default `20`, rentang `1`–`50`. |
| `cursor` | Gunakan `results.next_cursor` dari respons sebelumnya selama `results.has_more` bernilai `true`. |

Respons direktori menempatkan saluran di `results.data`. Direktori menggunakan kueri WhatsApp yang tidak terdokumentasi dan dapat berubah terlepas dari GOWA.

## Mengikuti atau berhenti mengikuti

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/follow" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

Gunakan body JSON yang sama dengan `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

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'count=50' "$GOWA_URL/newsletter/messages"
```

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

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'after=123' --data-urlencode 'count=50' \
  "$GOWA_URL/newsletter/message-updates"
```

`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](https://gowa-docs.mintlify.site/id/concepts/webhooks.md), lalu daftarkan langganan setiap perangkat ke saluran yang dibutuhkannya.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/live-updates" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

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

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" -X DELETE --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/live-updates"
```

Menghapus langganan menghentikan pembaruannya. WhatsApp dapat terus mengirim pembaruan hingga masa langganan yang sudah diberikan berakhir. Langganan yang dibatalkan tidak diaktifkan kembali saat tersambung ulang atau oleh pembaruan langganan yang sedang berlangsung. Menghapus saluran tanpa langganan menghasilkan kesalahan validasi.

> [!NOTE]
>
> 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

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/messages/123/download"
```

Endpoint mengambil postingan tersebut langsung dari WhatsApp dan menyimpan media yang didukung ke direktori media server. JSON `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.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Login ke server WhatsApp](https://gowa-docs.mintlify.site/id/api-reference/app/login-ke-server-whatsapp.md)
- [Menghubungkan kembali ke server WhatsApp](https://gowa-docs.mintlify.site/id/api-reference/app/menghubungkan-kembali-ke-server-whatsapp.md)
- [Periksa apakah pengguna terdaftar di WhatsApp](https://gowa-docs.mintlify.site/id/api-reference/user/periksa-apakah-pengguna-terdaftar-di-whatsapp.md)
- [Autentikasi](https://gowa-docs.mintlify.site/id/authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.