Pendahuluan

REST API ini mengirim pesan WhatsApp dari sistem Anda — notifikasi transaksi, OTP, pengingat, broadcast kampanye — dan menerima balasan lewat webhook. Cocok untuk toko online, CRM, aplikasi kasir, atau layanan apa pun yang bisa memanggil HTTP.

Endpoint

Format respons

Sukses selalu berisi success: true; gagal berisi success: false danerror berisi pesan yang bisa langsung ditampilkan.

{ "success": true,  "message_id": "BAE5F6A1C3..." }
{ "success": false, "error": "Device does not belong to this API key" }

1. Autentikasi & Perangkat

WakoDinov menggunakan two-layer authentication: API Key untuk autentikasi akun, Device Key untuk memilih perangkat pengirim.

2. Kirim Pesan (Send Message)

?api_key=USER_API_KEY&device_key=DEVICE_KEY&to=628123456789&message=Halo%20dari%20API

{
  "success": true,
  "message_id": "BAE5F6A1C3..."
}

{
  "success": true,
  "queued": true,
  "status": "pending",
  "message_id": "9f1c...-job"
}

{
  "success": false,
  "error": "Device does not belong to this API key"
}

curl -X POST "http://your-domain.com/api/v1/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer USER_API_KEY" \
  -d '{
    "device_key": "DEVICE_KEY",
    "to": "628123456789",
    "message": "Halo dari API"
  }'

const res = await fetch('http://your-domain.com/api/v1/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer USER_API_KEY'
  },
  body: JSON.stringify({
    device_key: 'DEVICE_KEY',
    to: '628123456789',
    message: 'Halo dari API'
  })
});
const data = await res.json();
console.log(data);

<?php
$url = 'http://your-domain.com/api/v1/send';
$body = json_encode([
    'device_key' => 'DEVICE_KEY',
    'to' => '628123456789',
    'message' => 'Halo dari API'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer USER_API_KEY'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

3. Kirim Media

Endpoint sama (/api/v1/send). Tambahkan media_url, dan message menjadi caption-nya. Ukuran maksimum 16 MB.

Tipe yang didukung

Contoh — kirim gambar

curl -X POST "http://your-domain.com/api/v1/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer USER_API_KEY" \
  -d '{
    "device_key": "DEVICE_KEY",
    "to": "628123456789",
    "media_url": "https://contoh.com/produk.jpg",
    "media_type": "image/jpeg",
    "message": "Ini produk yang Anda tanyakan"
  }'

4. Kuota & Rate Limit

Pembatasan diterapkan per akun, bukan per perangkat. Seluruh perangkat berbagi kuota bulanan yang sama.

5. Webhook (Event Masuk)

Gateway mengirim event ke URL webhook Anda via POST berisiContent-Type: application/json. Atur URL dan event yang diinginkan per perangkat di halaman Webhook.

Event yang tersedia

Payload — message_received (pesan pribadi)

{
  "event": "message_received",
  "device_key": "dev_xxx",
  "from_number": "628123456789",
  "from_name": "Nama Pengirim",
  "sender_number": "",
  "sender_name": "",
  "message": "Halo, pesanan saya sudah dikirim?",
  "message_type": "text"
}

Payload — message_received (dari grup)

Untuk grup, from_number berisi JID grup (…@g.us), sedangkan pengirim sebenarnya ada di sender_number/sender_name.

{
  "event": "message_received",
  "device_key": "dev_xxx",
  "from_number": "120363021481520594@g.us",
  "from_name": "",
  "sender_number": "628987654321@s.whatsapp.net",
  "sender_name": "Budi",
  "message": "Setuju, lanjut ya",
  "message_type": "text"
}

Payload — device_connected / device_disconnected

Semua event device menyertakan timestamp ISO-8601.reason bernilai logged_out (sesi dihapus),status_<code> (putus sementara, mis. status_401), ataudisconnected. Perangkat akan menyambung ulang otomatis kecuali logged_out.

{
  "event": "device_connected",
  "device_key": "dev_xxx",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "jid": "628123456789:12@s.whatsapp.net"
}