@merajah/baileys
v4.4.0
Published
Baileys wrapper with event system, serialize, and anti-delete support
Maintainers
Readme
📦 @merajah/baileys
High-level WhatsApp Web API wrapper berbasis Baileys Engine yang dirancang untuk efisiensi. Library ini menyediakan fitur otomatisasi media, serialisasi pesan yang ringkas (SMSG), dan berbagai helper tambahan untuk mempermudah pengembangan bot WhatsApp.
Fitur Utama
- Enhanced Socket (extra.js): Fungsi tambahan seperti sendFile, reply, dan downloadM disuntikkan langsung ke instance socket.
- Simplified Message (serialize.js): Mengubah struktur pesan Baileys yang kompleks menjadi format yang lebih mudah digunakan (m.body, m.sender, dll).
- Auto Media Converter: Integrasi FFmpeg untuk konversi otomatis Voice Note (Opus) dan Video (MP4).
- Pairing Code: Mendukung autentikasi tanpa scan QR.
- Persistent Cache: Penyimpanan metadata grup dan kontak secara lokal agar performa lebih cepat.
INSTALLING
npm install @merajah/baileys
npm startCatatan: Pastikan FFmpeg terinstal di sistem Anda untuk fitur konversi media.
Penggunaan & Dokumentasi API
const Baileys = require('@merajah/baileys');
const bot = new Baileys({
session: 'session_data', // Nama folder session
number: '628xxxxxxxx', // Isi nomor untuk login via Pairing Code
online: true, // Set status bot selalu online
plugins: 'plugins' // set plugins dirname
});
bot.register('ready', ({ sock }) => {
console.log('✅ Bot Berhasil Terhubung!');
});
bot.register('message', async ({ sock, m, command, text, args }) => {
// 1. Membalas pesan dengan m.reply (Simple)
if (command === 'ping') {
await m.reply('Pong!');
}
// 2. Mengirim file menggunakan sock.sendFile (Extra.js)
// Otomatis deteksi Buffer, URL, atau Path Lokal
if (command === 'sendimg') {
await sock.sendFile(m.chat, 'https://example.com/image.jpg', 'foto.jpg', 'Ini caption', m);
}
// 3. Mengirim Voice Note (PTT) - Otomatis konversi ke format WhatsApp
if (command === 'vn') {
await sock.sendFile(m.chat, './audio.mp3', '', '', m, { ptt: true });
}
// 4. Mengirim Video sebagai GIF
if (command === 'gif') {
await sock.sendFile(m.chat, './video.mp4', '', 'Ini GIF', m, { gif: true });
}
// 5. Download Media (Extra.js)
if (command === 'download' && m.quoted) {
// Download media dari pesan yang dibalas
const buffer = await sock.downloadM(m.quoted.msg, m.quoted.mtype.replace('Message', ''));
await sock.sendFile(m.chat, buffer, 'file.jpg', 'Hasil download');
}
});
// EVENT: MANAJEMEN GRUP
bot.register('group.add', ({ jid, participants }) => {
// Member baru bergabung
});
bot.register('group.remove', ({ jid, participants }) => {
// Member keluar/dikick
});
bot.register('group.promote', ({ jid, participants }) => {
// Member naik jabatan jadi admin
});
// EVENT: LAINNYA
bot.register('message.delete', ({ m }) => {
// Anti-delete: dipanggil saat pesan dihapus
});
bot.register('error', ({ error }) => {
// Penanganan error sistem
});Message
| Properti | Deskripsi | |---|---| | m.id | ID unik dari pesan. | | m.chat | JID percakapan (Grup atau Private Chat). | | m.sender | JID pengirim yang sudah diformat (bersih). | | m.fromMe | Boolean, true jika pesan dikirim oleh bot sendiri. | | m.isGroup | Boolean, true jika pesan berasal dari grup. | | m.mtype | Tipe pesan (contoh: conversation, imageMessage). | | m.body | Isi teks pesan (mendukung pesan teks biasa, caption media, atau tombol). | | m.quoted | Objek pesan yang dibalas (jika ada), berisi properti yang sama seperti m. | | m.mentionedJid | Daftar JID yang di-mention dalam pesan. | | m.reply(text) | Fungsi cepat untuk membalas pesan tersebut. | | m.download() | Fungsi cepat untuk mengunduh media yang ada pada pesan. |
Options Baileys
const bot = new Baileys({
session: 'auth_folder',
number: '628xxx',
online: true
}, {
// Opsi asli dari Baileys SocketConfig (WASocketConfig)
printQRInTerminal: true,
browser: ['Merajah', 'Chrome', '1.0.0'],
syncFullHistory: false
});Merajah Team
- Dwi-Merajah (Developer) Thanks For Installing My Wrapper Module
