Messaging API

Endpoint messaging mengirim pesan keluar ke WhatsApp. Semua operasi memerlukan instance yang sudah CONNECTED.

curl --request POST \
  --url http://localhost:5002/api/api/send-message

$response = Invoke-WebRequest -Uri 'http://localhost:5002/api/api/send-message' -Method POST 

const url = 'http://localhost:5002/api/api/send-message';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

const fetch = require('node-fetch');

const url = 'http://localhost:5002/api/api/send-message';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import requests

url = "http://localhost:5002/api/api/send-message"

response = requests.post(url)

print(response.json())

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:5002/api/api/send-message"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "5002",
  CURLOPT_URL => "http://localhost:5002/api/api/send-message",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

POST /api/send-message — Kirim teks

Handler: MessageController.sendText (src/controller/MessageController.ts:11)

Request fields

Contoh request

{
  "instance": "0c1a968c-...",
  "number": "628123456789",
  "message": "Halo!",
  "pesan_id": "uuid-pesan",
  "role": "cs",
  "data": "{}",
  "quoted_raw_message": "{...}"
}

Response data

{
  "success": true,
  "message": "Sukses kirim pesan",
  "data": {
    "id": "3EB0...",
    "status": 1,
    "raw_message": "{\"key\":{...},\"message\":{...},\"messageTimestamp\":170000}",
    "number": "628123456789",
    "message_content": "Halo!"
  }
}

raw_message adalah bentuk minimal pesan terkirim — simpan nilai ini bila ingin memakainya sebagai quoted_raw_message saat membalas.

Anti-ban presence

Sebelum kirim, engine mensimulasikan presence:

1. presenceSubscribe(formattedNumber)
2. sendPresenceUpdate('composing', formattedNumber) — typing indicator
3. Jeda 1 detik
4. sendPresenceUpdate('paused', formattedNumber) — stop typing
5. sock.sendMessage(...)

onWhatsApp validation

Untuk nomor personal (bukan grup), engine validasi nomor terdaftar di WhatsApp:

formatNumber(number) → jika bukan @g.us:
  sock.onWhatsApp(formattedNumber)
  jika !exists → throw "Nomor tujuan belum terdaftar Whatsapp"

quoted_raw_message — reply

Jika quoted_raw_message ada, di-parse (JSON string → object) dan dipakai sebagai options.quoted di sock.sendMessage. Timestamp Long object dinormalisasi.

Socket emit

Setelah kirim, engine emit sendmessage + sendmessage_bubble ke room instance:

{
  "id": "628123456789",
  "type": "sendmessage",
  "number": 0,
  "instance": "0c1a968c-...",
  "text": "uuid-pesan",
  "status": "sent",
  "role": "cs",
  "data": { ... },
  "timestamp": "2024-01-15T10:30:00.000Z"
}

POST /api/send-media — Kirim media / link preview

Handler: MessageController.sendMedia (src/controller/MessageController.ts:98)

Request fields

Contoh request

{
  "instance": "0c1a968c-...",
  "number": "628123456789",
  "type": "image",
  "url": "https://example.com/photo.jpg",
  "caption": "Lihat foto ini",
  "pesan_id": "msg-1",
  "role": "cs",
  "data": "{}"
}

Perilaku per tipe

Validasi URL

Untuk image/video/document/audio, URL divalidasi lebih dulu via isMediaUrlValid:

const response = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(5000) });
return response.ok;  // 200-299

Jika tidak dapat diakses, request gagal tanpa mengirim presence:

"Media URL tidak dapat diakses: <url>"

Response data

{
  "success": true,
  "message": "Sukses kirim pesan",
  "data": {
    "id": "3EB0...",
    "result": true,
    "status": true,
    "type": "image",
    "raw_message": "{...}",
    "url": "https://example.com/photo.jpg"
  }
}

POST /api/send-location — Kirim lokasi

Handler: MessageController.sendLocation (src/controller/MessageController.ts:201)

Request fields

Contoh request

{
  "instance": "0c1a968c-...",
  "number": "628123456789",
  "latitude": "-6.200000",
  "longitude": "106.816666"
}

Response

{
  "success": true,
  "message": "Location sent",
  "data": { ...result.key }
}

POST /api/send-broadcast — Kirim ke banyak nomor

Handler: MessageController.sendBroadcast (src/controller/MessageController.ts:268)

Request fields

Contoh request

{
  "instance": "0c1a968c-...",
  "number": ["628111", "628222"],
  "message": "Promo hari ini!"
}

Response (1 nomor — objek tunggal)

{
  "success": true,
  "message": "Broadcast selesai diproses",
  "data": {
    "result": true,
    "id": "3EB0...",
    "number": "628111",
    "message": "Berhasil Terkirim"
  }
}

Response (>1 nomor — rekap)

{
  "success": true,
  "message": "Broadcast selesai diproses",
  "data": {
    "result": true,
    "count": 2,
    "success": 1,
    "failed": 1,
    "message": "Broadcast selesai diproses",
    "details": [
      { "result": true,  "id": "3EB0...", "number": "628111", "message": "Berhasil Terkirim" },
      { "result": false, "id": "",        "number": "628222", "message": "Nomor tujuan belum terdaftar Whatsapp" }
    ]
  }
}

Anti-ban delay

Untuk broadcast >1 nomor, ada jeda acak 3-5 detik antar pengiriman:

const delayTime = Math.floor(Math.random() * 2000) + 3000;  // 3000-5000ms

Broadcast memanggil sendTextMessage per nomor — yang berarti setiap nomor juga mendapat presence simulation (composing → paused).

Catatan

• sendContact sudah diimplementasi di MessageController.ts:249 tapi tidak didaftarkan di router — tidak dapat diakses
• formatNumber() menormalkan input otomatis — lihat Conventions
• Grup (deteksi: mengandung - atau panjang >15 digit) tidak divalidasi onWhatsApp
• Presence simulation bisa gagal — ditangkap dengan try/catch, tidak menghentikan pengiriman

Langkah berikutnya

• Kelola grup? Baca Group API.
• Detail alur pesan? Baca Message Flow.
• Kembali ke API Reference.