Chats

Endpoint chat berada di /api/whatsapp/*. Semua request membutuhkan paket aktif dan device yang sudah terhubung.

GET /api/whatsapp/chats

Ambil daftar semua chat dari device yang terhubung.

Query parameters

Parameter	Type	Keterangan
`limit`	number	Jumlah data per halaman (default: 20)
`offset`	number	Offset paginasi
`search`	string	Filter berdasarkan nama chat
`has_media`	boolean	Hanya chat yang memiliki media
`archived`	boolean	`true` untuk chat diarsip, `false` untuk aktif

curl "/api/whatsapp/chats?limit=20&offset=0" \
  -b "wa_token=<token>"

Response 200

{
  "code": 200,
  "results": {
    "data": [
      {
        "jid": "628123456789@s.whatsapp.net",
        "name": "John Doe",
        "last_message_time": "2024-01-01T12:00:00Z",
        "ephemeral_expiration": 0,
        "archived": false
      }
    ],
    "pagination": {
      "limit": 20,
      "offset": 0,
      "total": 42
    }
  }
}

GET /api/whatsapp/chat/:chat_jid/messages

Ambil riwayat pesan dari chat tertentu.

chat_jid — JID chat, contoh: 628123456789@s.whatsapp.net atau 120363xxx@g.us untuk grup.

Query parameters

Parameter	Type	Keterangan
`limit`	number	Jumlah pesan per halaman
`offset`	number	Offset paginasi
`start_time`	string	Timestamp awal (ISO 8601)
`end_time`	string	Timestamp akhir (ISO 8601)
`media_only`	boolean	Hanya pesan dengan media
`is_from_me`	boolean	Filter berdasarkan pengirim
`search`	string	Pencarian teks dalam pesan

curl "/api/whatsapp/chat/628123456789@s.whatsapp.net/messages?limit=20" \
  -b "wa_token=<token>"

Response 200

{
  "code": 200,
  "results": {
    "data": [
      {
        "id": "3EB0...",
        "chat_jid": "628123456789@s.whatsapp.net",
        "sender_jid": "628123456789@s.whatsapp.net",
        "content": "Halo!",
        "timestamp": "2024-01-01T12:00:00Z",
        "is_from_me": false,
        "media_type": ""
      }
    ],
    "pagination": { "limit": 20, "offset": 0, "total": 5 }
  }
}

POST /api/whatsapp/chat/:chat_jid/pin

Pin atau unpin chat.

Request body (application/json)

Field	Type	Required	Keterangan
`pinned`	boolean	Ya	`true` untuk pin, `false` untuk unpin

curl -X POST "/api/whatsapp/chat/628123456789@s.whatsapp.net/pin" \
  -H "Content-Type: application/json" \
  -b "wa_token=<token>" \
  -d '{"pinned": true}'

POST /api/whatsapp/chat/:chat_jid/archive

Arsip atau pulihkan chat.

Request body (application/json)

Field	Type	Required	Keterangan
`archived`	boolean	Ya	`true` untuk arsip, `false` untuk pulihkan

curl -X POST "/api/whatsapp/chat/628123456789@s.whatsapp.net/archive" \
  -H "Content-Type: application/json" \
  -b "wa_token=<token>" \
  -d '{"archived": true}'

POST /api/whatsapp/chat/:chat_jid/disappearing

Set timer pesan hilang otomatis.

Request body (application/json)

Field	Type	Required	Keterangan
`timer_seconds`	number	Ya	`0` = nonaktif, `86400` = 1 hari, `604800` = 7 hari, `7776000` = 90 hari

curl -X POST "/api/whatsapp/chat/628123456789@s.whatsapp.net/disappearing" \
  -H "Content-Type: application/json" \
  -b "wa_token=<token>" \
  -d '{"timer_seconds": 604800}'

Chats

GET /api/whatsapp/chats

GET /api/whatsapp/chat/:chat_jid/messages

POST /api/whatsapp/chat/:chat_jid/pin

POST /api/whatsapp/chat/:chat_jid/archive

POST /api/whatsapp/chat/:chat_jid/disappearing

On this page