WA Engine

Register a new device and initialize WhatsApp connection.

curl -X POST https://watzap.sakuajaib.id/api/devices \
  -H "X-API-Key: wak_..." \
  -H "Content-Type: application/json" \
  -d '{"device_id":"phone-1","name":"Customer Support"}'

Response: 201 — Device registered. Poll GET /api/devices/:id/qr for the QR code.

List all devices belonging to your website.

curl -H "X-API-Key: wak_..." https://watzap.sakuajaib.id/api/devices

Response: Array of devices with id, name, status, phone_number, last_active, and live_status.

Get live connection status for a device.

curl -H "X-API-Key: wak_..." https://watzap.sakuajaib.id/api/devices/phone-1/status

Response: { connected: true, status: "connected", phone_number: "62812xxx" }

Poll for the QR code. Returns base64 PNG. Poll every 3-5 seconds until connected.

curl -H "X-API-Key: wak_..." https://watzap.sakuajaib.id/api/devices/phone-1/qr

Response: { qr_code: "data:image/png;base64,...", generated_at: "ISO8601" } — or { status: "connected" } if already connected.

Send a text or media message.

* Either message or media is required.

# Text
curl -X POST https://watzap.sakuajaib.id/api/messages/send \
  -H "X-API-Key: wak_..." \
  -H "Content-Type: application/json" \
  -d '{"device_id":"phone-1","to":"6281234567890","message":"Hello!"}'

# Image URL
curl -X POST https://watzap.sakuajaib.id/api/messages/send \
  -H "X-API-Key: wak_..." \
  -H "Content-Type: application/json" \
  -d '{"device_id":"phone-1","to":"6281234567890","media":"https://example.com/photo.jpg","caption":"Check this out"}'

Response: { message_id: "...", timestamp: 1234567890 }

Get current webhook configuration for your website.

curl -H "X-API-Key: wak_..." https://watzap.sakuajaib.id/api/webhook

Update webhook URL, secret, and subscribed events for your website.

curl -X PUT https://watzap.sakuajaib.id/api/webhook \
  -H "X-API-Key: wak_..." \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://myapp.com/api/wa-webhook","webhook_events":"qr,status,message"}'

Get the resolved webhook target for a specific device (shows device override or website fallback).

Override webhook settings for a specific device. Takes webhook_url, webhook_secret, webhook_events.

Server health: CPU usage, RAM, uptime, Node.js version, platform. All responses are wrapped in a { success, data } envelope.

{
  "success": true,
  "data": {
    "cpu_usage": 0.9,
    "memory": { "used_mb": 964, "total_mb": 1968, "usage_percent": 49 },
    "uptime_seconds": 217013,
    "node_version": "v22.23.0",
    "platform": "linux",
    "pid": 629065
  }
}

Your website overview: device counts, messages today, webhook success rate.

{
  "success": true,
  "data": {
    "website_name": "Saku Ajaib",
    "total_devices": 5,
    "active_devices": 3,
    "messages_today": { "incoming": 150, "outgoing": 89 },
    "webhook_success_rate": 98.5
  }
}

Per-device stats: status, phone number, last active, messages today. Returns an array under data.

{
  "success": true,
  "data": [
    {
      "id": "phone-1",
      "name": "Customer Support",
      "phone_number": "6281234567890",
      "status": "connected",
      "last_active": "2026-07-11 09:15:00",
      "messages_today": { "incoming": 12, "outgoing": 8 }
    }
  ]
}

Message statistics: by hour (last 24h), by message type, total counts.

{
  "success": true,
  "data": {
    "by_hour": [
      { "hour": "09", "direction": "incoming", "count": 5 },
      { "hour": "09", "direction": "outgoing", "count": 3 }
    ],
    "by_type": [
      { "message_type": "conversation", "count": 40 },
      { "message_type": "imageMessage", "count": 6 }
    ],
    "total": { "all": 46, "incoming": 28, "outgoing": 18 }
  }
}

Event Types

Envelope Format

{
  "event": "message",
  "data": {
    "device_id": "phone-1",
    "from": "6281234567890@s.whatsapp.net",
    "message_id": "BAE...",
    "timestamp": 1690000000,
    "type": "conversation",
    "content": "Hello, can I get help?",
    "has_media": false
  },
  "website_id": "web_abc123",
  "device_id": "phone-1",
  "timestamp": "2026-07-09T12:00:00.000Z"
}

Headers

Node.js — Full Integration

const API_KEY = 'wak_...';
const BASE = 'https://watzap.sakuajaib.id/api';
const headers = { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' };

// Register a device
async function registerDevice(deviceId, name) {
  const res = await fetch(\`\${BASE}/devices\`, {
    method: 'POST', headers, body: JSON.stringify({ device_id: deviceId, name })
  });
  return res.json();
}

// Poll for QR code
async function pollQR(deviceId) {
  const res = await fetch(\`\${BASE}/devices/\${deviceId}/qr\`, { headers });
  return res.json();
}

// Send a message
async function sendMessage(deviceId, to, text) {
  const res = await fetch(\`\${BASE}/messages/send\`, {
    method: 'POST', headers,
    body: JSON.stringify({ device_id: deviceId, to, message: text })
    });
  return res.json();
}

// Live polling — server health
async function getServerStats() {
  const res = await fetch(\`\${BASE}/stats/server\`, { headers });
  return res.json();
}

// Get website overview
async function getOverview() {
  const res = await fetch(\`\${BASE}/stats/overview\`, { headers });
  return res.json();
}

PHP (cURL)

define('API_KEY', 'wak_...');
define('BASE', 'https://watzap.sakuajaib.id/api');

function sendMessage($deviceId, $to, $message) {
  $ch = curl_init(BASE . '/messages/send');
  curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
      'X-API-Key: ' . API_KEY,
      'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
      'device_id' => $deviceId,
      'to' => $to,
      'message' => $message,
    ]),
  ]);
  $result = curl_exec($ch);
  curl_close($ch);
  return json_decode($result, true);
}

function getServerStats() {
  $ch = curl_init(BASE . '/stats/server');
  curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . API_KEY],
  ]);
  $result = curl_exec($ch);
  curl_close($ch);
  return json_decode($result, true);
}