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

# Menerima pesan

> Tangani pesan masuk dengan webhook, atau baca chat dan pesan yang tersimpan di penyimpanan chat GOWA.

GOWA menyediakan dua cara untuk menerima pesan:

| Metode | Kegunaan |
| - | - |
| **Webhook** (disarankan) | Merespons event secara real time. GOWA mengirim setiap event ke URL Anda. |
| **API penyimpanan chat** | Membaca riwayat, mengambil pesan yang terlewat selama downtime, dan membuat tampilan kotak masuk. |

## Webhook

Jalankan GOWA dengan URL dan secret webhook:

```bash theme={null}
./whatsapp rest --basic-auth=admin:changeme \
  --webhook=https://example.com/wa-hook \
  --webhook-secret=change-me \
  --webhook-events=message,message.ack
```

Pesan teks diterima dalam bentuk:

```json theme={null}
{
  "event": "message",
  "device_id": "628123456789@s.whatsapp.net",
  "session_id": "my-device",
  "payload": {
    "id": "3EB0C127D7BACC83D6A1",
    "chat_id": "628987654321@s.whatsapp.net",
    "from": "628987654321@s.whatsapp.net",
    "from_name": "John Doe",
    "sender_display_name": "John Doe",
    "timestamp": "2026-10-15T10:30:00Z",
    "is_from_me": false,
    "body": "Hello, how are you?"
  }
}
```

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:

```javascript theme={null}
const express = require("express");
const crypto = require("crypto");

const GOWA = "http://localhost:3000";
const AUTH = "Basic " + Buffer.from("admin:changeme").toString("base64");
const SECRET = "change-me";

const app = express();
app.post("/wa-hook", express.raw({ type: "application/json" }), async (req, res) => {
  const sig = crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const received = req.get("X-Hub-Signature-256") || "";
  const expected = `sha256=${sig}`;
  if (!/^sha256=[0-9a-f]{64}$/.test(received) ||
      received.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const evt = JSON.parse(req.body);
  res.sendStatus(200);
  if (evt.event !== "message" || evt.payload.is_from_me) return;
  if (!evt.session_id) return;
  if (!/^hi\b/i.test(evt.payload.body || "")) return;

  const response = await fetch(`${GOWA}/send/message`, {
    method: "POST",
    headers: {
      Authorization: AUTH,
      "Content-Type": "application/json",
      "X-Device-Id": evt.session_id,          // reply from the slot that received it
    },
    body: JSON.stringify({
      phone: evt.payload.chat_id,
      message: "Hello! How can we help?",
      reply_message_id: evt.payload.id,
    }),
  });
  if (!response.ok) console.error("GOWA reply failed", response.status);
});
app.listen(8080);
```

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](https://gowa-docs.mintlify.site/id/concepts/webhooks.md) 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](https://gowa-docs.mintlify.site/id/concepts/webhooks.md) 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:

```bash theme={null}
# list chats (filters: search, has_media, archived; paging: limit, offset)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chats?limit=20"

# messages in one chat (filters: start_time, end_time, media_only, is_from_me, search)
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/chat/628987654321@s.whatsapp.net/messages?limit=50"
```

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:

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/message/3EB0C127D7BACC83D6A3/download?phone=628987654321@s.whatsapp.net"
```

Lihat [Media masuk](https://gowa-docs.mintlify.site/id/examples/media-handling.md#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.


## Related topics

- [Webhook](https://gowa-docs.mintlify.site/id/concepts/webhooks.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Kirim pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-pesan-interaktif-eksperimental.md)
- [Pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/examples/interactive-messages.md)
- [Mulai Cepat](https://gowa-docs.mintlify.site/id/quickstart.md)


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