WhatsApp disconnected

📡 API Documentation

• {{t.label}}

GET    {{ baseUrl }}/api/commands            -> list semua command
POST   {{ baseUrl }}/api/commands            -> buat command baru
PUT    {{ baseUrl }}/api/commands/:id        -> update command by id
PUT    {{ baseUrl }}/api/commands            -> replace semua command (array)
DELETE {{ baseUrl }}/api/commands/:id        -> hapus command by id
PATCH  {{ baseUrl }}/api/commands/:id/toggle -> toggle enabled/disabled

curl -X POST {{ baseUrl }}/api/commands \\
  -H "Authorization: Bearer YOUR_JWT" \\
  -H "Content-Type: application/json" \\
  -d '{
    "command": "!halo",
    "replyMessage": "Halo juga!",
    "mode": "message",
    "mediaUrls": [],
    "enabled": true
  }'

curl -X POST {{ baseUrl }}/api/commands \\
  -H "Authorization: Bearer YOUR_JWT" \\
  -H "Content-Type: application/json" \\
  -d '{
    "command": "!cuaca",
    "mode": "script",
    "script": "const kota = args[0] || \"Jakarta\"; const res = await axios.get(`https://wttr.in/${kota}?format=3`); return res.data;",
    "mediaUrls": ["https://example.com/weather.jpg"],
    "enabled": true
  }'

curl -X PUT {{ baseUrl }}/api/commands/CMD_ID \\
  -H "Authorization: Bearer YOUR_JWT" \\
  -H "Content-Type: application/json" \\
  -d '{"replyMessage": "Updated!", "enabled": false}'

curl -X PATCH {{ baseUrl }}/api/commands/CMD_ID/toggle \\
  -H "Authorization: Bearer YOUR_JWT"

GET    {{ baseUrl }}/api/autoreply                          -> list semua rule
POST   {{ baseUrl }}/api/autoreply                          -> buat rule baru
PUT    {{ baseUrl }}/api/autoreply/:id                      -> update rule by id
DELETE {{ baseUrl }}/api/autoreply/:id                      -> hapus rule by id
PATCH  {{ baseUrl }}/api/autoreply/:id/toggle               -> toggle enabled/disabled
POST   {{ baseUrl }}/api/autoreply/:id/move-to-command      -> konversi rule menjadi Command

curl -X POST {{ baseUrl }}/api/autoreply \\
  -H "Authorization: Bearer YOUR_JWT" \\
  -H "Content-Type: application/json" \\
  -d '{
    "keyword": "hello",
    "matchType": "contains",
    "response": "Halo! Apa kabar?",
    "mode": "message",
    "mediaUrls": [],
    "enabled": true
  }'

curl -X POST {{ baseUrl }}/api/autoreply \\
  -H "Authorization: Bearer YOUR_JWT" \\
  -H "Content-Type: application/json" \\
  -d '{
    "keyword": "!jam",
    "matchType": "equals",
    "mode": "script",
    "script": "const now = new Date().toLocaleTimeString(\"id-ID\"); return `Sekarang jam ${now}`;",
    "mediaUrls": ["https://example.com/clock.png"],
    "enabled": true
  }'

"equals"     -> pesan sama persis dengan keyword
"contains"   -> pesan mengandung keyword (default)
"startsWith" -> pesan diawali dengan keyword

curl -X POST {{ baseUrl }}/api/autoreply/RULE_ID/move-to-command \\
  -H "Authorization: Bearer YOUR_JWT"

# Rule "hello" akan menjadi Command "!hello" dengan replyMessage/script yang sama

Send to a single number

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{"number": "6282146727409", "message": "Hello!"}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({ number: "6282146727409", message: "Hello!" })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  number: '6282146727409',
  message: 'Hello!'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {'number': '6282146727409', 'message': 'Hello!'},
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({'number': '6282146727409', 'message': 'Hello!'}),
);
print(response.body);

Send to multiple numbers

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "recipients": ["6282146727409", "628xxx"],
  "message": "Hello everyone!"
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    recipients: ["6282146727409", "628xxx"],
    message: "Hello everyone!"
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  recipients: ['6282146727409', '628xxx'],
  message: 'Hello everyone!'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'recipients': ['6282146727409', '628xxx'],
    'message': 'Hello everyone!'
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'recipients': ['6282146727409', '628xxx'],
    'message': 'Hello everyone!'
  }),
);
print(response.body);

Send to group(s)

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "recipients": ["120363xxx@g.us"],
  "message": "Hello group!"
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    recipients: ["120363xxx@g.us"],
    message: "Hello group!"
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  recipients: ['120363xxx@g.us'],
  message: 'Hello group!'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'recipients': ['120363xxx@g.us'],
    'message': 'Hello group!'
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'recipients': ['120363xxx@g.us'],
    'message': 'Hello group!'
  }),
);
print(response.body);

Send to multiple groups + numbers

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "recipients": [
    "6282146727409",
    "628xxx",
    "120363xxx@g.us",
    "120363yyy@g.us"
  ],
  "message": "Hello!"
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    recipients: [
      "6282146727409",
      "628xxx",
      "120363xxx@g.us",
      "120363yyy@g.us"
    ],
    message: "Hello!"
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  recipients: [
    '6282146727409',
    '628xxx',
    '120363xxx@g.us',
    '120363yyy@g.us'
  ],
  message: 'Hello!'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'recipients': [
      '6282146727409',
      '628xxx',
      '120363xxx@g.us',
      '120363yyy@g.us'
    ],
    'message': 'Hello!'
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'recipients': [
      '6282146727409',
      '628xxx',
      '120363xxx@g.us',
      '120363yyy@g.us'
    ],
    'message': 'Hello!'
  }),
);
print(response.body);

Send to Main Number (use "main")

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{"number": "main", "message": "Hello!"}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({ number: "main", message: "Hello!" })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  number: 'main',
  message: 'Hello!'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {'number': 'main', 'message': 'Hello!'},
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({'number': 'main', 'message': 'Hello!'}),
);
print(response.body);

Send Image / File from URL

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "number": "6282146727409",
  "message": "Check this image!",
  "media": { "url": "https://example.com/photo.jpg" }
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    number: "6282146727409",
    message: "Check this image!",
    media: { url: "https://example.com/photo.jpg" }
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  number: '6282146727409',
  message: 'Check this image!',
  media: { url: 'https://example.com/photo.jpg' }
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'number': '6282146727409',
    'message': 'Check this image!',
    'media': { 'url': 'https://example.com/photo.jpg' }
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'number': '6282146727409',
    'message': 'Check this image!',
    'media': { 'url': 'https://example.com/photo.jpg' }
  }),
);
print(response.body);

Send File with Base64 Data

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "number": "6282146727409",
  "message": "Here is the document",
  "media": {
    "data": "BASE64_ENCODED_DATA",
    "mimetype": "application/pdf",
    "filename": "document.pdf"
  }
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    number: "6282146727409",
    message: "Here is the document",
    media: {
      data: "BASE64_ENCODED_DATA",
      mimetype: "application/pdf",
      filename: "document.pdf"
    }
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
const fs = require('fs');
const fileData = fs.readFileSync('document.pdf').toString('base64');
axios.post('{{ baseUrl }}/api/send-message', {
  number: '6282146727409',
  message: 'Here is the document',
  media: {
    data: fileData,
    mimetype: 'application/pdf',
    filename: 'document.pdf'
  }
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'dart:convert';
import 'dart:io';
import 'package:dio/dio.dart';
final dio = Dio();
final bytes = await File('document.pdf').readAsBytes();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'number': '6282146727409',
    'message': 'Here is the document',
    'media': {
      'data': base64Encode(bytes),
      'mimetype': 'application/pdf',
      'filename': 'document.pdf'
    }
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'dart:io';
import 'package:http/http.dart' as http;
final bytes = await File('document.pdf').readAsBytes();
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'number': '6282146727409',
    'message': 'Here is the document',
    'media': {
      'data': base64Encode(bytes),
      'mimetype': 'application/pdf',
      'filename': 'document.pdf'
    }
  }),
);
print(response.body);

Send Media Only (no caption)

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "number": "6282146727409",
  "media": { "url": "https://example.com/photo.jpg" }
}'

// Same as above examples, just omit the "message" field.
// Only "number" (or "recipients") + "media" is required.

🔍 Check Message Status

Check the delivery status of a queued message by its queue ID or your custom reference_id.

Send with reference_id

curl -X POST {{ baseUrl }}/api/send-message \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{ apiKeyValue }}" \
  -d '{
  "number": "6282146727409",
  "message": "Hello!",
  "reference_id": "order-12345"
}'

fetch("{{ baseUrl }}/api/send-message", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{{ apiKeyValue }}"
  },
  body: JSON.stringify({
    number: "6282146727409",
    message: "Hello!",
    reference_id: "order-12345"
  })
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.post('{{ baseUrl }}/api/send-message', {
  number: '6282146727409',
  message: 'Hello!',
  reference_id: 'order-12345'
}, {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.post('{{ baseUrl }}/api/send-message',
  data: {
    'number': '6282146727409',
    'message': 'Hello!',
    'reference_id': 'order-12345'
  },
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
  Uri.parse('{{ baseUrl }}/api/send-message'),
  headers: {'Content-Type': 'application/json', 'X-API-Key': '{{ apiKeyValue }}'},
  body: jsonEncode({
    'number': '6282146727409',
    'message': 'Hello!',
    'reference_id': 'order-12345'
  }),
);
print(response.body);

Check status

curl {{ baseUrl }}/api/message-status/order-12345 \
  -H "X-API-Key: {{ apiKeyValue }}"

fetch("{{ baseUrl }}/api/message-status/order-12345", {
  headers: { "X-API-Key": "{{ apiKeyValue }}" }
}).then(r => r.json()).then(console.log);

const axios = require('axios');
axios.get('{{ baseUrl }}/api/message-status/order-12345', {
  headers: { 'X-API-Key': '{{ apiKeyValue }}' }
}).then(res => console.log(res.data));

import 'package:dio/dio.dart';
final dio = Dio();
final response = await dio.get('{{ baseUrl }}/api/message-status/order-12345',
  options: Options(headers: {'X-API-Key': '{{ apiKeyValue }}'}),
);
print(response.data);

import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.get(
  Uri.parse('{{ baseUrl }}/api/message-status/order-12345'),
  headers: {'X-API-Key': '{{ apiKeyValue }}'},
);
print(jsonDecode(response.body));

Response

{
  "id": "uuid-queue-id",
  "reference_id": "order-12345",
  "number": "6282146727409",
  "chatId": "6282146727409@c.us",
  "message": "Hello!",
  "status": "sent",   // pending | sending | sent | failed
  "error": null,
  "createdAt": 1709654400000,
  "sentAt": 1709654405000
}