Dokumentasi API & Fitur

Gunakan API ini untuk menghubungkan aplikasi Anda (PHP, Python, JS, dll) dengan server WhatsApp kami.

1. Mengirim Pesan Teks

Kirim pesan teks ke nomor WhatsApp manapun.

POST http://bot.slims.my.id:3000/send-message

            {
            "key": "
            ADHISLiMS-2326-E550",
            "number": "08123456789",
            "message": "Halo, ini adalah pesan tes dari API."
            }
        

2. Mengirim Pesan Gambar (Media)

Kirim gambar dengan caption teks melalui URL media.

POST http://bot.slims.my.id:3000/send-message

            {
            "key": "
            ADHISLiMS-2326-E550",
            "number": "08123456789",
            "message": "Cek gambar ini bos!",
            "media_url": "https://website.com/gambar.jpg"
            }
        

3. Parameter API

Parameter	Tipe	Wajib	Keterangan
`key`	String	Ya	API Key Anda (Cek di Settings)
`number`	String	Ya	Nomor tujuan (Gunakan format 08 atau 62)
`message`	String	Ya	Isi pesan teks yang akan dikirim
`media_url`	String	Tidak	Link URL file gambar/PDF yang ingin dikirim

4. Response Format

Setiap request akan mengembalikan data dalam format JSON.

            {
                "status": true,
                "response": "Pesan Terkirim"
            }
        

Jika gagal:

            {
                "status": false,
                "message": "Invalid API Key"
            }
        

5. Fitur Smart AI Gemini

Bot ini dilengkapi dengan kecerdasan buatan. Untuk mengaktifkannya:

Buka menu Settings.
Dapatkan API Key dari Google AI Studio.
Aktifkan fitur Smart AI.
Bot akan otomatis menjawab pertanyaan apapun yang tidak terdaftar di kata kunci Auto Reply.

6. Webhook Integration

Anda bisa menerima pesan masuk ke server Anda sendiri secara real-time.

💡 Info Webhook: Webhook sangat berguna untuk membuat bot interaktif atau mengintegrasikan WA dengan sistem Order/Tiket di website Anda.

Aktifkan Webhook di menu Dashboard.
Masukkan URL Webhook Anda (Contoh: https://anda.com/callback.php).
Bot akan mengirimkan data JSON via method POST.

📥 Unduh Script Webhook (.php)

<?php
// --- callback.php ---
// Contoh Skrip Penangkap Webhook untuk diletakkan di server Anda sendiri
// Pastikan URL file ini dimasukkan ke menu Settings Dashboard

// Ambil input JSON dari server Bot
$json = file_get_contents('php://input');
$data = json_decode($json, true);

if ($data) {
    // 1. Identifikasi Data
    $sender = $data['from'];    // Nomor pengirim (format: 628xxx)
    $name   = $data['name'];    // Nama di profil WA pengirim
    $msg    = $data['message']; // Isi pesan teks
    $type   = $data['type'];    // Type log (system / in / out)

    // 2. Berikan Logika (Contoh: Balas otomatis atau simpan ke DB)
    if (strtolower($msg) == 'halo') {
        // Anda bisa memanggil API send-message di sini untuk membalas
    }

    // 3. Simpan Log untuk debugging
    file_put_contents('webhook_log.txt', date('Y-m-d H:i:s')." - Msg from $name: $msg\n", FILE_APPEND);
}

// Balas dengan status 200 OK
http_response_code(200);
echo "OK";
?>
        

7. Contoh Skrip Pengiriman (PHP cURL)

Bila Anda ingin mengirim notifikasi dari aplikasi PHP Anda (misalnya selesai transaksi), gunakan contoh script ini:

📥 Unduh Script Kirim Pesan (.php)

<?php
// --- send_notif.php ---
// Script untuk mengirim pesan otomatis dari sistem Anda sendiri

$url = "http://bot.slims.my.id:3000/send-message";
$data = [
    "key"     => "ADHISLiMS-2326-E550", // Gunakan API Key dari dashboard
    "number"  => "628123456789",    // Gunakan format 62 atau 08
    "message" => "Halo [name], Ini adalah notifikasi otomatis.\nWaktu: " . date('H:i:s')
];

$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($data),
    CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
    CURLOPT_TIMEOUT        => 10
]);

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

if ($err) {
    echo "CURL Error: " . $err;
} else {
    echo "Respon Server: " . $response;
}
?>
        