ckptw-wabot - WhatsApp Bot dengan @mengkodingan/ckptw

Catatan: Script ini telah diperbarui.

Gambaran Umum

ckptw-wabot adalah bot WhatsApp yang dibangun menggunakan library @mengkodingan/ckptw. Bot ini memungkinkan Anda untuk mengotomatisasi berbagai tugas di WhatsApp, serta mendukung arsitektur modular melalui sistem perintah (command).

Fitur Utama

• Penanganan Pesan: Bot dapat menangani pesan yang masuk dan merespons sesuai kebutuhan.
• Penerjemah Perintah: Memahami perintah yang dikirim pengguna dan menjalankan tindakan sesuai perintah tersebut.
• Respon Interaktif: Bot memberikan tanggapan interaktif dan dinamis terhadap pertanyaan atau perintah pengguna.
• Penanganan Media: Mendukung pengiriman dan penerimaan media seperti gambar, video, dan dokumen.
• Sistem Perintah: Bot mudah diperluas dengan menambahkan perintah baru yang sesuai dengan kebutuhan Anda.

Cara Memulai

Ikuti langkah-langkah berikut untuk mengatur dan menjalankan ckptw-wabot:

1. Kloning Repositori:

   git clone https://github.com/itsreimau/ckptw-wabot.git
   cd ckptw-wabot

2. Instalasi Dependensi:

   npm install

3. Konfigurasi: Ganti nama file config.example.js menjadi config.js, lalu perbarui nilai konfigurasi seperti nama bot, beberapa pesan, nomor pemilik (Owner), dll.

4. Menjalankan Bot:

   npm start

5. Autentikasi WhatsApp: Ada dua metode autentikasi yang dapat digunakan untuk menghubungkan bot ke akun WhatsApp Anda:

   • Menggunakan Kode Pairing:

     • Setelah bot dijalankan, kode pairing akan ditampilkan di terminal.
     • Buka aplikasi WhatsApp di ponsel, pilih menu Perangkat Tertaut, lalu ketuk Tautkan Perangkat.
     • Masukkan kode pairing yang ditampilkan untuk menautkan akun WhatsApp dengan bot.

   • Menggunakan Kode QR:

     • Setelah bot dijalankan, kode QR akan muncul di terminal.
     • Buka aplikasi WhatsApp di ponsel, pilih menu Perangkat Tertaut, lalu ketuk Tautkan Perangkat.
     • Pindai kode QR yang muncul untuk menautkan akun WhatsApp dengan bot.

6. Mulai Berinteraksi: Setelah proses autentikasi berhasil, bot siap menerima dan merespon pesan sesuai perintah yang dikirimkan.

Kustomisasi

Menambahkan Perintah Baru

Untuk menambahkan perintah baru, ikuti langkah-langkah berikut:

1. Buat file JavaScript baru di folder commands dengan fungsionalitas yang diinginkan, misalnya test-helloworld.js:

   // commands/test/helloworld.js
   
   module.exports = { // Mengatur dan membagikan fungsi untuk perintah "helloworld"
       name: "helloworld", // Nama perintah yang akan digunakan oleh pengguna
       category: "test", // Kategori untuk mengelompokkan perintah ini
       handler: { // Pengaturan khusus untuk perintah ini
           admin: Boolean, // Apakah hanya admin grup yang bisa menggunakan perintah ini? (true/false)
           botAdmin: Boolean, // Apakah bot harus menjadi admin agar bisa menjalankan perintah ini? (true/false)
           banned: Boolean, // Apakah pengguna yang dilarang tidak bisa menggunakan perintah ini? (true/false)
           coin: Array[coin, media, source] || Number, // Koin yang diperlukan untuk menjalankan perintah ini:
           // coin: jumlah koin yang dibutuhkan
           // media: jenis media yang diperlukan
           // source: dari mana media diambil (1 untuk media utama, 2 untuk media yang dikutip, 3 untuk keduanya)
           cooldown: Boolean, // Apakah ada waktu tunggu sebelum perintah ini bisa digunakan lagi? (true/false)
           group: Boolean, // Apakah perintah ini hanya bisa digunakan di dalam grup? (true/false)
           owner: Boolean, // Apakah hanya pemilik bot yang bisa menggunakan perintah ini? (true/false)
           premium: Boolean, // Apakah hanya pengguna premium yang bisa menggunakan perintah ini? (true/false)
           private: Boolean // Apakah perintah ini hanya bisa digunakan dalam chat pribadi? (true/false)
       },
       code: async (ctx) => { // Fungsi yang dijalankan saat perintah ini dipanggil
           const status = await handler(ctx, module.exports.handler); // Memeriksa apakah pengguna memiliki izin untuk menggunakan perintah
           if (status) return; // Jika statusnya true, artinya pengguna tidak diperbolehkan menggunakan perintah ini, jadi hentikan proses
   
           return await ctx.reply("Hello, World!"); // Jika tidak ada pembatasan, kirim pesan "Hello, World!" kepada pengguna
       }
   };

2. Perintah baru ini bisa dipicu dengan mengirimkan /helloworld di chat.

Baca Dokumentasi @mengkodingan/ckptw

Untuk informasi lebih lanjut tentang penggunaan library ini, kunjungi dokumentasi ckptw.

Kontribusi

Kami sangat terbuka untuk kontribusi! Jika Anda menemukan bug atau memiliki ide untuk fitur baru, jangan ragu untuk membuka issue atau mengirimkan pull request.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT.

---

Jelajahi, modifikasi, dan tingkatkan ckptw-wabot sesuai kebutuhan Anda. Selamat mencoba dan semoga sukses!