ITSUKI WHATSAPP BOT BASE

Base Whatsapp Bot simple, rapi terstruktur, yang dapat kamu gunakan sebagaimana mungkin dengan mudah, gampang tanpa banyak kendala.

---

SETTINGS

Isi semua informasi bot di file settings.js

---

ITSUKI BOT ROOM

---

CONNECTION

process.argv.includes('--qr')           // tampilkan QR di terminal
process.argv.includes('--pairing-code') // pakai kode pairing

CONTOH:

node index.js --qr
node index.js --pairing-code

---

⚠️ WAJIB!

Isi Nomor Botnya, Buka file settings.js

Edit:

bot.number = "6280303838" // ganti dengan nomor botmu

Tanpa ini, bot gak bisa jalan.

---

TERMUX USER

$ pkg upgrade && pkg update
$ pkg install nodejs
$ pkg install ffmpeg
$ pkg install libwebp
$ pkg install imagemagick
$ pkg install git
$ pkg install yarn
$ gitclone https://github.com/siuspsrb/Itsuki-Bot-4.0
$ cd Itsuki-Bot-4.0
$ yarn
$ node .

---

HIGHLIGHTS

• Simple Penggunaan,
• Mudah digunakan,
• Stabil,
• Ringan
• Ga Pasaran
• Terstruktur Rapi
• Pairing Code
• Qr Code

---

STRUKTUR COMMANDS

Untuk menambahkan fitur, cukup tambahkan file .js dengan format dibawah didalam folder cmd

commands.add({
    name: ['nama1','nama2', ...], // nama event
    command: ['nama1', 'nama2', ...], // trigger command
    alias: ['alias1', 'alias2'], // alias command (opsional)
    category: 'fun', // kategori menu
    desc: 'deskripsi fitur',
    admin: false,    // true jika hanya admin grup
    group: false,    // true jika hanya bisa dipakai di grup
    botAdmin: false, // true jika bot harus admin
    owner: false,    // true jika hanya owner bot
    premium: false,  // true jika hanya premium user
    limit: 5,  // memakai 5 limit
    cooldown: 10, // 10 detik cooldown fitur
    query: true, // true jika membutuhkan input text dari user
    usage: "<text>", // param tampilan menu
    example: "https://github..", // contoh input text yang akan diberikan
    register: true, // harus daftar fulu
    level: 2, // minimal level 2 biar dpt akses
    run: async ({ sius, m, text, args, Func, dl }) => {
    // Logic fitur disini
    }
})

COMMANDS METHOD

commands.add(event)               // tambah fitur ke sistem
commands.remove(name)            // hapus command by name[0]
commands.findCommand(query)      // cari command/alias
commands.setCommandState(name, bool) // enable/disable command
commands.getAllCommands(filters) // ambil semua command (bisa difilter)
commands.getByCategory(category) // ambil command per kategori
commands.getCategories()         // ambil semua kategori unik
commands.incrementUsage(name)    // tambahkan counter + update lastUsed
commands.getStats(name?)         // statistik (usage & waktu pakai)
commands.checkCooldown(name, userId) // cek apakah user dalam cooldown
commands.setCooldown(name, userId)   // set cooldown untuk user
commands.reset()                 // hapus semua command dari memory

PROPERTI COMMANDS

{
  name: ["cekcmd"],           // (required) nama internal command
  command: ["cekcmd"],        // (required) trigger command utama
  alias: ["infocmd"],         // (optional) alias tambahan
  category: "utility",        // (required) kategori fitur
  desc: "cek info command",   // (optional) deskripsi singkat
  usage: "<query>",           // (optional) format cara pakai
  example: "menu",            // (optional) contoh pemakaian, query nya aja g usah ikut commandny
  param: "<text>",            // (optional) fallback argumen kalau kosong
  cooldown: 10,               // (optional) jeda per user (detik)
  limit: 2,                   // (optional) pakai limit user?
  premium: false,             // (optional) hanya user premium?
  level: 5,                   // (optional) minimal level user
  owner: false,               // (optional) hanya owner?
  group: false,               // (optional) hanya di grup?
  admin: false,               // (optional) hanya admin grup?
  botAdmin: false,            // (optional) bot harus admin?
  private: false,             // (optional) hanya di private chat?
  register: false,            // (optional) butuh register user?
  enable: true,               // (optional) aktif/nonaktif
  hidden: false,              // (optional) disembunyikan dari menu
  privatechat: false,         // (optional) hanya di private chat?
  dependencies: [],           // (optional) list module yg wajib ada

  run: async ({ sius, m, args, text, Func, dl }) => {} // (required) fungsi eksekusi
}

CONTOH COMMAND

commands.add({
    name: ['say'],
    command: ['say'],
    alias: ['ucap'],
    category: 'fun',
    desc: 'Bot akan mengulang teks yang kamu kirim',
    admin: false,
    group: false,
    botAdmin: false,
    owner: false,
    premium: false,
    limited: false,
    run: async ({ m, args }) => {
        if (!args[0]) return m.reply('Contoh: .say halo dunia!')
        m.reply(args.join(' '))
    }
})

---

CAROUSEL MESSAGE

sius.sendCarousel('628xxxx@s.whatsapp.net', 'Cek promo terbaru kami!', [
    {
        header: {
            image: 'https://telegra.ph/file/0c06df94c1d8f5bd82d64.jpg'
        },
        body: {
            title: 'Promo Spesial',
            subtitle: 'Diskon 70%!',
            description: 'Berlaku sampai 10 Juni 2025'
        },
        nativeFlowMessage: {
        buttons: [
        {
            name: 'cta_url',
            buttonParamsJson: JSON.stringify({
                display_text: 'Lihat Sekarang',
                url: 'https://tokomu.com/promo'
            })
        }
        ]
        }
    },
    {
        header: {
            image: 'https://telegra.ph/file/d5e8a1fa7588e7e3dba1d.jpg'
        },
        body: {
            title: 'Voucher Gratis Ongkir',
            subtitle: 'Khusus pengguna baru',
            description: 'Claim sebelum kehabisan'
        },
        nativeFlowMessage: {
        buttons: [
        {
            name: 'cta_url',
            buttonParamsJson: JSON.stringify({
                display_text: 'Claim Sekarang',
                url: 'https://tokomu.com/voucher'
            })
        }
        ]
    }
    }
], null, {
  footer: 'Powered by ©siuspsrb'
})

---

BUTTON MESSAGE

sius.sendButton('628xxxx@s.whatsapp.net', [
    ['Tombol 1', '.command1'],
    ['Tombol 2', '.command2']
], {
    text: 'Pilih salah satu tombol di bawah ini:',
    footer: 'Powered by ©siuspsrb'
})

sius.sendButton('628xxxx@s.whatsapp.net', [
    ['Lihat Promo', '.promo'],
    ['Menu Lain', '.menu']
], {
    image: { url: 'https://telegra.ph/file/abc123.jpg' },
    caption: 'Promo Hari Ini 🔥',
    footer: 'Klik tombol di bawah'
})

---

CONTACT MESSAGE

sius.sendContact('628xxxx@s.whatsapp.net', ['6281234567890', '6289876543210'], m)

---

CHANNEL FORWARD PREVIEW

sius.adChannel(
    'Update baru dari bot!',      // isi pesan utama
    {
        txt: 'sius.bot update',     // nama channel yg muncul
        title: 'Cek Channel Kami',  // title preview
        thumb: 'https://telegra.ph/file/abc123.jpg', thumbnail
        render: true                // true untuk thumbnail besar
    }
)

---

REPLY WITH PREVIEW

sius.reply(
    '628xxxx@s.whatsapp.net',     // JID tujuan
    'Halo! Cek fitur terbaru ya~', // isi pesan utama
    'sius.bot',                    //judul link preview
    true                           // true untuk thumbnail besar
)

---

Installing the FFmpeg

• Unduh salah satu versi FFmpeg yang tersedia dengan mengklik di sini.
• Extract file ke C:\ path.
• Ganti nama folder yang telah di-extract menjadi ffmpeg.
• Run Command Prompt as Administrator.
• Jalankan perintah berikut::

> setx /m PATH "C:\ffmpeg\bin;%PATH%"

Jika berhasil, akan memberikanmu pesan seperti: SUCCESS: specified value was saved.

• Sekarang setelah Anda menginstal FFmpeg, verifikasi bahwa itu berhasil dengan menjalankan perintah ini untuk melihat versi:

> ffmpeg -version

Installing the libwebp

• Unduh salah satu versi libwebp yang tersedia dengan mengklik di sini.
• Extract file ke C:\ path.
• Ganti nama folder yang telah di-extract menjadi libwebp.
• Run Command Prompt as Administrator.
• Jalankan perintah berikut::

> setx /m PATH "C:\libwebp\bin;%PATH%"

Jika berhasil, akan memberikanmu pesan seperti: SUCCESS: specified value was saved.

• Sekarang setelah Anda menginstal libwebp, verifikasi bahwa itu berhasil dengan menjalankan perintah ini untuk melihat versi:

> webpmux -version

---

👑 DEVELOPER

@sius

---

🙏 Thanks To

@adiwajshing

@mhankbarbar

@FatihArridho

@DikaArdnt

@dehanjing

@mamet8

@zackmans

@Ilman

---