Mulai Cepat

Panduan cepat dari nol sampai bisa kirim pesan pertama.

Prasyarat

• Akun terdaftar secara mandiri, dan Syarat & Ketentuan yang berlaku sudah disetujui di Dashboard (Pengaturan) — tidak perlu menghubungi admin atau mengirim dokumen bisnis.
• API key (format: wag_xxxxxxxxxxxx) — lihat panduan API Key.
• Nomor WhatsApp yang aktif untuk dipasangkan sebagai sesi.

Base URL

Semua endpoint API memakai base URL https://api.wagwayapp.com.

---

Langkah 1 — Daftarkan & Aktifkan Nomor

Sebelum bisa dipasangkan, nomor WhatsApp harus terdaftar sebagai device dan berstatus active (sudah berlangganan paket).

curl -X POST https://api.wagwayapp.com/v1/numbers \
  -H "Authorization: Bearer wag_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"phone": "6281200000000"}'

Response:

{
  "slot_id": "nsub_9c1f...",
  "phone": "6281200000000",
  "plan": "free",
  "status": "active"
}

Kalau jatah nomor Free Anda masih kosong, status langsung active dan Anda bisa lanjut ke langkah pairing. Kalau status masih registered, pasang paket dulu lewat POST /v1/numbers/{id}/order — paket berbayar baru aktif setelah invoice-nya dilunasi lewat Dashboard → Tagihan (pembayaran sengaja tidak lewat API).

Simpan slot_id — dipakai di langkah berikutnya.

---

Langkah 2 — Pasangkan Nomor WhatsApp

Dengan device yang sudah aktif, mulai proses pairing dengan memindai QR code dari WhatsApp di ponsel Anda.

Mulai proses pairing:

curl -X POST https://api.wagwayapp.com/v1/sessions/onboard \
  -H "Authorization: Bearer wag_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"slot_id": "nsub_9c1f..."}'

Response:

{
  "onboard_id": "onb_9c1f...",
  "status": "pending"
}

Poll status dan ambil QR code:

curl https://api.wagwayapp.com/v1/onboard/onb_9c1f... \
  -H "Authorization: Bearer wag_xxxxxxxxxxxx"

Saat status berubah ke qr, field qr berisi string payload yang bisa dirender menjadi QR code. Pindai dengan WhatsApp di ponsel Anda (Perangkat Tertaut → Tautkan Perangkat).

Setelah berhasil, status berubah ke paired dan session_id tersedia:

{
  "status": "paired",
  "session_id": "[email protected]"
}

Simpan session_id ini — Anda akan membutuhkannya setiap kali kirim pesan.

---

Langkah 3 — Kirim Pesan Pertama

curl -X POST https://api.wagwayapp.com/v1/messages \
  -H "Authorization: Bearer wag_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: msg-001" \
  -d '{
    "session_id": "[email protected]",
    "to": "628111111111",
    "text": "Halo dari WhatsApp Gateway!"
  }'

Response:

{
  "message_id": "msg_7f3a...",
  "status": "accepted"
}

Pesan diantrekan dan akan dikirim dalam hitungan detik. Lihat panduan lengkap kirim pesan untuk detail idempotency, error handling, dan rate limit.

---

Langkah 4 — Terima Pesan Masuk (Webhook)

Untuk menerima notifikasi saat ada pesan masuk ke nomor Anda, daftarkan endpoint webhook. Lihat panduan webhook untuk setup lengkap termasuk verifikasi signature.

---

Autentikasi

Semua endpoint (kecuali /healthz) memerlukan header:

Authorization: Bearer <api_key>

API key bersifat rahasia — jangan diekspos ke sisi client/browser. Gunakan hanya dari server Anda.