Pengantar API Publik Wavio

Selamat datang di Dokumentasi API Publik Wavio. Semua endpoint yang tercantum di bawah ini dapat Anda gunakan untuk mengintegrasikan Wavio secara langsung ke dalam perangkat lunak atau server bisnis Anda.

Base URL

https://api.wavio.id/api/v1/public

Development Lokal

Jika Anda sedang menjalankan proyek secara lokal, ganti dengan http://localhost:5001/api/v1/public.

Autentikasi

Semua request wajib menyertakan header X-API-Key:

curl -X GET "https://api.wavio.id/api/v1/public/numbers" \
  -H "X-API-Key: wavio_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Cara Mendapatkan API Key

1. Login ke Dashboard Wavio.
2. Buka menu API Keys.
3. Klik Buat API Key Baru → Pilih permissions → Salin key.

Keamanan

Jangan pernah mem-publish API Key di repository publik atau meng-hardcode-nya di aplikasi frontend.

Format Respons

Sukses (200)

{
  "success": true,
  "message": "Operation successful",
  "data": { ... }
}

Error

{
  "success": false,
  "message": "Deskripsi error",
  "code": "VALIDATION_ERROR"
}

HTTP Status Codes

Status	Keterangan
200	Request berhasil
400	Bad Request — parameter tidak valid
401	Unauthorized — API Key tidak valid
404	Not Found — resource tidak ditemukan
429	Too Many Requests — rate limit terlampaui
500	Internal Server Error

Daftar Endpoint

Messaging

Method	Endpoint	Deskripsi
POST	/messages/send	Kirim pesan teks
POST	/messages/send-media	Kirim pesan media
POST	/messages/send-template	Kirim pesan template
POST	/messages/send-interactive	Kirim pesan interaktif
POST	/messages/broadcast	Kirim broadcast massal, terjadwal, Smart Timing, dan delay
GET	/messages	Riwayat pesan
GET	/messages/:id	Detail pesan

Contacts

Method	Endpoint	Deskripsi
GET	/contacts	Daftar kontak
GET	/contacts/:id	Detail kontak
POST	/contacts	Tambah kontak
PUT	/contacts/:id	Update kontak
DELETE	/contacts/:id	Hapus kontak
POST	/contacts/import	Import kontak massal

Templates

Method	Endpoint	Deskripsi
GET	/templates	Daftar template WhatsApp
GET	/templates/:id	Detail template

Numbers

Method	Endpoint	Deskripsi
GET	/numbers	Daftar nomor WABA

Webhooks

Method	Endpoint	Deskripsi
GET	/webhooks	Daftar webhook
POST	/webhooks	Tambah webhook
PUT	/webhooks/:id	Update webhook
DELETE	/webhooks/:id	Hapus webhook