WA Gateway

Info Sesi

Aksi Cepat

Aktivitas 14 Hari

memuat…

Hubungkan Perangkat

Menunggu scan

memuat…

Buka WhatsApp di HP → Perangkat Tertaut
Ketuk Tautkan Perangkat
Arahkan kamera ke QR di atas
Gateway otomatis tersambung & sesi tersimpan

Kirim Pesan Tes

Kirim dari (nomor gateway)

Tipe Tujuan

Target

Pesan

Endpoint: POST /session/{id}/send

Daftar Grup WA

—

Nama Grup	Group JID	Anggota	Aksi

Group JID dipakai sebagai "Contact" grup di WA Alarm (Alarm Receipt Config).

Sesi & Device (per Klien / Nomor)

Session ID	Klien	Nomor	Status	Folder Auth	Aksi

Tiap klien punya sesi & nomor sendiri (folder auth terpisah). API kirim: POST /session/{id}/send.

API Pengiriman

—

Endpoint

API Key (header Authorization)

POST /session/{id}/send
Authorization: {api key}
{ "target":"...@g.us", "message":"..." }
→ { "status":"SENT", "id":"..." }

Webhook Status

Webhook URL (callback ke WA Alarm)

Gateway mengirim update status (sent/failed) & koneksi ke URL ini.

Kejadian dikirim

message.sentmessage.deliveredmessage.failedmessage.incomingmessage.queuedconnection.updatesession.downsession.recoveredbroadcast.done

Log Aktivitas

Session

Event

Dari

Sampai

Waktu	Session	Event	Target	Status

Notifikasi Email

Kirim email peringatan otomatis saat: sesi/device minta pairing ulang atau logout, sesi terputus, atau gagal kirim beruntun (≥3×). Email dibatasi 1× per 10 menit per jenis agar tidak membanjiri.

Aktifkan notifikasi email

SMTP Host

Port

SSL/TLS

Username SMTP

Password / App Password

Dari (From)

Kirim ke (bisa banyak, pisah koma)

Untuk Gmail: aktifkan 2-Step Verification lalu buat App Password (bukan password akun biasa). Host smtp.gmail.com, Port 587 (STARTTLS).
Alternatif: isi lewat file .env (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, SMTP_FROM, ALERT_EMAIL_TO).

Broadcast / Kirim Massal

Kirim dari

Delay antar kirim (ms)

Daftar Penerima (satu nomor per baris, atau klik "Dari Kontak")

Total: 0 penerima

Pesan

Riwayat Broadcast

ID	Session	Total	Terkirim	Gagal	Status	Waktu

Pesan Masuk

Waktu	Session	Pengirim	Nama	Tipe	Pesan

Pesan masuk otomatis ditangkap saat sesi tersambung. Aktifkan webhook "message.incoming" untuk meneruskan ke sistem lain.

Daftar Kontak

Nama	Nomor	Tag	Aksi

Kontak tersimpan di gateway dan bisa dipakai untuk Broadcast cepat.

Pengaturan Privasi

Berlaku per sesi. Pilih sesi di dropdown atas untuk mengubah.

Typing Sign

Simulasi "sedang mengetik…" sebelum kirim pesan (1.5 detik)

Off

Read Receipts

Otomatis tandai pesan masuk sebagai sudah dibaca (centang biru)

Off

Info Server

Library@whiskeysockets/baileys

Runtime—

Mode—

Retensi Log60 hari

Dokumentasi API

Semua endpoint memakai header Authorization: {api_key} untuk client, atau X-Admin-Key: {admin_pass} untuk admin.

Kirim Pesan

POST /session/{id}/send
Content-Type: application/json
Authorization: {api_key}

Body: { "target": "628xxxx" atau "120363xxx@g.us", "message": "Teks pesan" }
Response: { "status": "SENT", "id": "msg_id" }

Cek Status Sesi

GET /session/{id}/status
Authorization: {api_key}

Response: { "id", "label", "status", "number", "sent24", "fail" }

Broadcast

POST /admin/sessions/{id}/broadcast
X-Admin-Key: {admin_pass}

Body: { "targets": ["628xxx","628yyy"], "message": "...", "delay_ms": 2000 }
Response: { "broadcast_id": "bc_xxx", "total": N, "status": "processing" }

Webhook Callback

Gateway mengirim POST ke webhook URL saat terjadi event:

• message.sent — pesan berhasil dikirim
• message.failed — pengiriman gagal
• message.incoming — pesan masuk diterima
• connection.update — status koneksi berubah
• broadcast.done — broadcast selesai

Body: { "event": "...", "ts": "...", "session": "...", ...data }

Kontak

GET /admin/contacts — daftar semua kontak
POST /admin/contacts — { "name": "...", "number": "628xxx", "tags": "..." }
PUT /admin/contacts/{id} — update kontak
DELETE /admin/contacts/{id} — hapus kontak

Pesan Masuk (Inbox)

GET /admin/inbox?session={id}&search={keyword}&limit=100
Response: [{ "ts", "session", "sender", "sender_name", "chat", "message", "msg_type", "is_group" }]

Antrian Kirim (persisten)

Waktu	Session	Tujuan	Pesan	Status	Coba	Aksi

Pesan yang gagal terkirim (sesi belum tersambung) disimpan di sini dan dikirim ulang otomatis begitu sesi hidup — tahan restart gateway.

Auto-Reply

Aktifkan

Balas otomatis saat menerima pesan pribadi (bukan grup) yang cocok kata kunci. Berguna untuk konfirmasi ke operator, mis. kirim "STATUS" → dibalas kondisi sistem.

Kata kunci	Kecocokan	Balasan

Backup Konfigurasi

Unduh konfigurasi gateway: daftar sesi (label & pengaturan), webhook, auto-reply, dan kontak. Berguna saat pindah PC. Catatan: kredensial WhatsApp (folder session) & API key tidak ikut demi keamanan — sesi perlu pairing ulang di PC baru.

Restore Konfigurasi

Pulihkan dari file backup. Kontak digabung (tidak menimpa yang sudah ada), sesi & pengaturan diperbarui.