Total Devices
0
Connected
0
Connecting
0
Disconnected
0
Monitor and control your WhatsApp device connections
Start managing multiple WhatsApp accounts by adding your first device connection
Scan this QR code with WhatsApp to connect the device
http://localhost:3001
/devices
Get list of all devices
Response:
{
"success": true,
"total_devices": 2,
"devices": {
"device_key": {
"device_name": "Customer Service",
"status": "connected"
}
}
}
/device/create
Create a new device
Request Body:
{
"device_name": "Customer Service",
"instance_key": "optional_custom_key"
}
Response:
{
"success": true,
"message": "Device created successfully",
"instance_key": "device_abc123"
}
/device/{instance_key}/qr
Generate QR code for device connection
Response:
{
"success": true,
"qr": "base64_qr_image_data",
"instance_key": "device_abc123"
}
/device/{instance_key}/send
Kirim berbagai jenis pesan dari device tertentu
Request Body:
{
"jid": "6281234567890",
"message": "Halo! Ini pesan dari WhatsApp API"
}
Request Body:
{
"jid": "6281234567890",
"message": "Lihat gambar ini!",
"media": {
"type": "image",
"url": "https://example.com/image.jpg",
"caption": "Caption untuk gambar"
}
}
Request Body:
{
"jid": "6281234567890",
"media": {
"type": "document",
"url": "https://example.com/document.pdf",
"filename": "dokumen.pdf",
"caption": "Ini adalah dokumen penting"
}
}
Request Body:
{
"jid": "6281234567890",
"media": {
"type": "audio",
"url": "https://example.com/audio.mp3"
}
}
Request Body:
{
"jid": "6281234567890",
"media": {
"type": "video",
"url": "https://example.com/video.mp4",
"caption": "Video menarik untuk Anda"
}
}
Request Body:
{
"jid": "6281234567890",
"location": {
"latitude": -6.2088,
"longitude": 106.8456,
"name": "Jakarta, Indonesia",
"address": "Jl. Sudirman, Jakarta Pusat"
}
}
Request Body:
{
"jid": "6281234567890",
"contact": {
"name": "John Doe",
"phone": "+6281234567890",
"organization": "PT. Example"
}
}
Response (untuk semua jenis pesan):
{
"success": true,
"message": "Message sent successfully",
"instance_key": "device_abc123",
"jid": "6281234567890@s.whatsapp.net",
"messageId": "msg_12345"
}
/device/{instance_key}/status
Get device connection status
Response:
{
"success": true,
"device": {
"instance_key": "device_abc123",
"device_name": "Customer Service",
"status": "connected",
"connected": true
}
}
/device/{instance_key}
Hapus device tertentu
Response:
{
"success": true,
"message": "Device deleted successfully",
"instance_key": "device_abc123"
}
/device/{instance_key}/bulk-send
Kirim pesan ke banyak nomor sekaligus (bulk message)
Request Body:
{
"recipients": [
"6281234567890",
"6281234567891",
"6281234567892"
],
"message": "Pesan broadcast untuk semua",
"delay": 2000
}
Response:
{
"success": true,
"message": "Bulk messages queued successfully",
"total_recipients": 3,
"instance_key": "device_abc123"
}
/device/{instance_key}/messages
Ambil riwayat pesan dari device tertentu
Query Parameters:
?jid=6281234567890&limit=50&offset=0
Response:
{
"success": true,
"messages": [
{
"id": "msg_123",
"from": "6281234567890@s.whatsapp.net",
"message": "Hello!",
"timestamp": 1640995200,
"type": "text"
}
],
"total": 1
}
/device/{instance_key}/webhook
Konfigurasi webhook untuk menerima pesan masuk
Request Body:
{
"webhook_url": "https://yourapp.com/webhook",
"events": ["message", "status", "qr"]
}
Response:
{
"success": true,
"message": "Webhook configured successfully",
"webhook_url": "https://yourapp.com/webhook"
}
Endpoint legacy ini TIDAK menggunakan instance_key dan hanya bekerja dengan satu device default. Sistem akan otomatis menggunakan device pertama yang tersedia atau device yang sudah terhubung sebelumnya.
/qr
Generate QR code untuk device default (tanpa instance key)
Response:
{
"success": true,
"qr": "base64_qr_image_data"
}
/send-message
Kirim pesan dari device default (tanpa instance key)
Request Body:
{
"jid": "6281234567890",
"message": "Hello World!"
}
Response:
{
"success": true,
"message": "Message sent successfully",
"jid": "6281234567890@s.whatsapp.net"
}
/status
Cek status device default (tanpa instance key)
Response:
{
"success": true,
"connected": true,
"status": "connected"
}
📱 Multiple Device Management (Direkomendasikan):
# 1. Buat device baru
curl -X POST http://localhost:3001/device/create \\
-H "Content-Type: application/json" \\
-d '{"device_name": "Customer Service Bot"}'
# Response: {"success": true, "instance_key": "device_abc123"}
# 2. Dapatkan QR code untuk device tersebut
curl http://localhost:3001/device/device_abc123/qr
# 3. Kirim pesan menggunakan device tersebut
curl -X POST http://localhost:3001/device/device_abc123/send \\
-H "Content-Type: application/json" \\
-d '{"jid": "6281234567890", "message": "Halo dari Bot!"}'
# 4. Cek status device
curl http://localhost:3001/device/device_abc123/status
⚠️ Legacy Single Device (Tidak Direkomendasikan):
# 1. Dapatkan QR code (device default)
curl http://localhost:3001/qr
# 2. Kirim pesan (menggunakan device default, tidak tahu device mana)
curl -X POST http://localhost:3001/send-message \\
-H "Content-Type: application/json" \\
-d '{"jid": "6281234567890", "message": "Hello World!"}'
# 3. Cek status (device default)
curl http://localhost:3001/status
Multiple Device: Anda bisa mengelola banyak device WhatsApp sekaligus dengan instance_key yang unik
Legacy Single: Hanya bisa menggunakan 1 device, sistem tidak tahu device mana yang digunakan
Rekomendasi: Gunakan Multiple Device Management untuk kontrol yang lebih baik
Format yang Benar:
6281234567890 - Nomor Indonesia tanpa tanda +60123456789 - Nomor Malaysia tanpa tanda +6591234567 - Nomor Singapura tanpa tanda +Format yang Salah:
+6281234567890 - Jangan gunakan tanda +081234567890 - Jangan gunakan 0 di depan6281234567890@s.whatsapp.net - Jangan tambahkan @s.whatsapp.net