API Documentation

Integrasikan Blass WhatsApp dengan sistem luar (seperti Radius Mikrotik, ERP, dll) menggunakan REST API.

Base URL & Authentication

Semua request ke API harus diarahkan ke URL server backend Anda, biasanya jika dijalankan lokal.

Authentication Header

Sertakan header berikut pada setiap POST/PUT/DELETE request:

x-api-key: [API_KEY_ANDA]

Kirim Pesan / OTP

POST /api/otp

Gunakan endpoint ini untuk mengirimkan pesan rahasia, OTP, atau notifikasi langsung ke 1 nomor (misalnya voucher Mikrotik).

Request Body (JSON)

{
  "phone": "081234567890",
  "otp": "VOUCHER123",
  "appName": "Hotspot Mikrotik"
}

Contoh cURL

curl -X POST /api/otp \
-H "Content-Type: application/json" \
-H "x-api-key: blass_xxx" \
-d '{"phone":"081234567890", "otp":"VOUCHER123", "appName":"Wifi Zone"}'

Webhook Payload (Incoming)

POST [WEBHOOK_URL]

Jika Webhook diaktifkan pada Pengaturan, server Blass akan mengirim POST request ke URL Anda setiap kali ada pesan WhatsApp masuk.

Format Payload yang Akan Anda Terima

{
  "from": "6281234567890@c.us",
  "body": "INFO HARGA",
  "isGroup": false,
  "timestamp": 1690123456
}

Anda bisa merespon dengan mengolah pesan di backend Anda sendiri, lalu memanggil endpoint POST /api/blast atau POST /api/otp untuk membalasnya.