Dokumentasi API

Panduan integrasi WA Service Manager API. Gunakan endpoint ini untuk mengirim pesan WhatsApp melalui berbagai provider yang terhubung.

Autentikasi

Setiap request ke API harus menyertakan X-Api-Key di header.

Headers

X-Api-KeyAPI Key aplikasi Anda. Didapatkan dari Dashboard admin.

X-Device-IdOptional. ID Device spesifik yang ingin digunakan pengiriman. Jika kosong, akan menggunakan Device Default.

Kirim Pesan (Unified Endpoint)

Multi-Provider Support

Endpoint ini otomatis menangani format yang dibutuhkan oleh provider (GOWA, Whacenter, dll) secara transparan.

POST/api/send

Mode 1: JSON Payload

Mode 2: Multipart Upload

Gunakan mode ini untuk mengirim pesan teks biasa atau media yang sudah memiliki URL publik.

Header Wajib

Content-Typeapplication/json

Field	Type	Required	Description
`phone`	string	Yes	Nomor WhatsApp tujuan (08xxx atau 62xxx).
`message`	string	Yes	Isi pesan teks.
`mediaUrl`	string	No	URL media (gambar/video/dokumen) jika mengirim via JSON.

Contoh Request:

curl -X POST https://sapa.pt-bks.com/api/send \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "phone": "08123456789", 
    "message": "Halo, ini pesan test",
    "mediaUrl": "https://example.com/image.png"
  }'

Format Response

API akan selalu mengembalikan format response yang seragam, tidak peduli provider mana yang memproses pesan tersebut.

{
  "success": true,
  "status": true, // Normalized status
  "message": "message sent",
  "data": {
    "id": "3EB0A5210BE5" // Provider Message ID
  }
}

HTTP 200 Pesan berhasil diproses oleh provider.
HTTP 400/401/500 Terjadi kesalahan (API Key salah, parameter kurang, atau server error).