📥 Request Body

Gunakan parameter berikut untuk mengonfigurasi pesan Anda. Request harus dikirim dalam format JSON.

Parameter	Tipe	Status	Deskripsi
`phone`	`string`	Wajib	Nomor tujuan dengan format internasional (contoh: `628123456789`).
`message`	`string`	Wajib	Isi pesan teks atau caption jika mengirim media.
`media_url`	`string`	`Opsional`	URL publik dari file media (Gambar/Video/Dokumen) yang ingin dikirim.
`media_type`	`string`	`Opsional`	Jenis media: `image`, `video`, `audio`, atau `document`.
`retry_interval`	`int`	`Opsional`	Jeda waktu (detik) antar percobaan jika pengiriman pertama gagal.
`expires_in`	`int`	`Opsional`	Masa berlaku pesan dalam detik. Jika lewat, pesan tidak akan dikirim.
`expires_at`	`string`	`Opsional`	Waktu kedaluwarsa absolut dalam format RFC3339.

Prioritas Expiration

Gunakan salah satu saja antara expires_in atau expires_at. Jika keduanya dikirim, Wagy akan menggunakan expires_at sebagai acuan utama dan mengabaikan expires_in.

Contoh Request Lengkap

{
  "phone": "628123456789",
  "message": "Halo, ini invoice belanja Anda!",
  "media_url": "https://yourdomain.com/files/inv-001.pdf",
  "media_type": "document",
  "retry_interval": 120,
  "expires_in": 3600
}

📤 Responses

1. Success (200 OK)

{
  "status": "success",
  "data": {
    "message_id": 1024,
    "status": "PENDING",
    "quota_type": "pro",
    "remaining": 499
  },
  "message": "Pesan masuk antrean"
}

2. Error Codes

Code	Pesan	Penjelasan
400	`Invalid JSON payload`	Format JSON salah atau ada parameter wajib yang kosong.
401	`Unauthorized`	API Key tidak valid atau tidak sesuai dengan `device_id`.
402	`Kuota habis`	Saldo pesan (Free/PRO) pada device tersebut sudah mencapai limit.
404	`Device not found`	`device_id` tidak terdaftar dalam sistem Wagy.

💡 Use Cases & Payloads

Teks Saja
Gambar

{
  "phone": "628123456789",
  "message": "Halo, ini pesan teks dari Wagy!"
}

{
  "phone": "628123456789",
  "message": "Lihat promo terbaru kami!",
  "media_url": "https://wagy.web.id/img/logo.jpg",
  "media_type": "image"
}

Catatan Antrean

Setiap pesan yang dikirim melalui API tidak langsung terkirim ke WhatsApp, melainkan masuk ke Antrean (Queue). Wagy akan memproses pengiriman dengan delay natural.

Send single message

POST /:device_id/send

Enqueue a WhatsApp message for delivery through a specific device.

Request

Responses

Pesan berhasil masuk antrean

📥 Request Body​

Contoh Request Lengkap​

📤 Responses​

1. Success (200 OK)​

2. Error Codes​

💡 Use Cases & Payloads​

Send single message

/:device_id/send

Request​

Responses​