Public API Reference

REST API WhatsApp Gateway

Dokumentasi publik untuk endpoint utama. Token dibuat dari panel dan bersifat session-scoped: satu token hanya mengakses satu session.

Access Model
Login diperlukan untuk membuat token. Endpoint publik ini hanya menampilkan referensi integrasi.
Login untuk Token API Management

Base Config

Authorization: Bearer YOUR_TOKEN
Accept: application/json
Content-Type: application/json

Endpoint Matrix

Method Endpoint Scope Fungsi
GET /sessions sessions:read List semua session yang diizinkan token.
GET /sessions/{session} sessions:read Detail satu session.
GET /sessions/{session}/messages sessions:read Fetch recent messages dengan filter inbox/group/personal/text-only/cursor.
GET /sessions/{session}/snapshot sessions:read Status gateway, QR, dan recent inbox.
GET /sessions/{session}/qr sessions:read Ambil QR onboarding terbaru.
POST /sessions/{session}/connect sessions:write Init atau re-init session.
POST /sessions/{session}/logout sessions:write Logout session device linked.
POST /sessions/{session}/messages/text messages:send Kirim teks biasa.
POST /sessions/{session}/messages/attachment messages:send Kirim image, video, audio, atau document via multipart/form-data.
POST /sessions/{session}/messages/reply-text messages:send Reply quote / mention.

Messages Query

  • limit: jumlah data, `1..100`
  • cursor_id: pagination ke data lebih lama
  • direction: `inbound`, `outbound`, `all`
  • chat_type: `personal`, `group`, `all`
  • text_only: `1` atau `0`
  • auto_replied: `1` atau `0`

Operational Notes

  • Token dibatasi ke satu session.
  • Session API bisa diaktif/nonaktifkan dari panel.
  • Safety guard dan stealth mode tetap berlaku saat kirim pesan.
  • Kontak tujuan harus pernah inbound atau memiliki opt-in yang valid.

Quick Start

Fetch Recent Messages
curl -X GET "https://z-labs.web.id/api/whatsapp/sessions/SESSION_UUID/messages?limit=20&direction=inbound&chat_type=all&text_only=0" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
Snapshot Session
curl -X GET "https://z-labs.web.id/api/whatsapp/sessions/SESSION_UUID/snapshot" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
Send Text
curl -X POST "https://z-labs.web.id/api/whatsapp/sessions/SESSION_UUID/messages/text" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "text": "Halo dari integrasi API"
  }'
Send Attachment
curl -X POST "https://z-labs.web.id/api/whatsapp/sessions/SESSION_UUID/messages/attachment" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -F "to=6281234567890" \
  -F "caption=Ini file lampirannya" \
  -F "attachment=@/path/to/file.pdf"