f-baileys 🚀

Fast · Stable · Multi-Platform WhatsApp Bot Library
Pairing Code ✓ | QR Code ✓ | Auto-Install ✓ | Termux/VPS/Panel ✓

✨ Features

| Feature | Status | |---------|--------| | Pairing Code login (100% masuk) | ✅ | | QR Code login | ✅ | | Auto-reconnect on disconnect | ✅ | | Multi-platform support | ✅ | | Auto-install missing dependencies | ✅ | | Serialized message objects | ✅ | | Send Text/Image/Video/Audio/Sticker/Document | ✅ | | TypeScript definitions | ✅ | | Pterodactyl Panel compatible | ✅ | | Termux (F-Droid) compatible | ✅ |

📦 Install

npm install f-baileys

Saat install, f-baileys otomatis mendeteksi platform dan menginstall dependensi yang kurang.

🚀 Quick Start

Mode QR Code

const FBaileys = require('f-baileys');

const bot = new FBaileys({
  sessionPath: './session',
  usePairingCode: false,  // QR Code mode
  printQR: true,
  autoReconnect: true,
});

bot.on('open', () => console.log('✓ Connected!'));

bot.on('message', async (msg) => {
  if (msg.fromMe) return;
  if (msg.text === 'ping') {
    await msg.reply('Pong! 🏓');
  }
});

bot.connect();

Mode Pairing Code

const FBaileys = require('f-baileys');

const bot = new FBaileys({
  sessionPath: './session',
  usePairingCode: true,          // ← Pairing Code
  phoneNumber: '628xxxxxxxxxx',  // Nomor HP (tanpa + atau spasi)
  autoReconnect: true,
});

bot.on('open', () => console.log('✓ Connected via Pairing Code!'));
bot.on('message', async (msg) => {
  if (msg.text === 'halo') await msg.reply('Halo juga!');
});

bot.connect();

⚙️ Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | sessionPath | string | './f_session' | Folder simpan session | | usePairingCode | boolean | false | true = pairing code, false = QR | | phoneNumber | string | null | Nomor HP untuk pairing code | | printQR | boolean | true | Auto print QR ke terminal | | logLevel | string | 'silent' | 'silent' / 'info' / 'debug' | | autoReconnect | boolean | true | Auto reconnect saat putus | | reconnectDelay | number | 3000 | Delay reconnect (ms) | | baileysOptions | object | {} | Extra config ke makeWASocket |

📨 Message Object

Setiap pesan yang diterima sudah diserialisasi:

bot.on('message', async (msg) => {
  msg.id         // ID pesan
  msg.from       // JID pengirim/grup
  msg.sender     // JID pengirim (di dalam grup)
  msg.senderNum  // Nomor pengirim (tanpa @s.whatsapp.net)
  msg.fromMe     // true jika pesan dari bot sendiri
  msg.isGroup    // true jika pesan dari grup
  msg.text       // Isi teks pesan
  msg.type       // Tipe pesan (imageMessage, videoMessage, dll)
  msg.pushName   // Nama pengirim
  msg.timestamp  // Unix timestamp

  // Flags
  msg.isText     // Pesan teks
  msg.isImage    // Pesan gambar
  msg.isVideo    // Pesan video
  msg.isAudio    // Pesan audio
  msg.isSticker  // Pesan stiker
  msg.isDocument // Pesan dokumen

  // Quoted message
  msg.quoted?.body   // Teks quoted
  msg.quoted?.type   // Tipe quoted

  // Helpers
  await msg.reply('Teks')          // Balas pesan
  await msg.react('✅')            // Reaksi emoji
});

📤 Send Methods

// Teks
await bot.sendText(jid, 'Hello!');
await bot.sendText(jid, 'Reply!', quotedMsg);

// Gambar
await bot.sendImage(jid, './gambar.jpg', 'Caption');
await bot.sendImage(jid, 'https://..../img.jpg', 'Caption');

// Video
await bot.sendVideo(jid, './video.mp4', 'Caption');

// Audio
await bot.sendAudio(jid, './audio.mp3');
await bot.sendAudio(jid, './voice.ogg', true); // ptt = voice note

// Sticker
await bot.sendSticker(jid, './sticker.webp');

// Dokumen
await bot.sendDocument(jid, './file.pdf', 'dokumen.pdf', 'application/pdf');

// Reaksi
await bot.sendReaction(jid, msg.key, '🔥');

// Typing indicator
await bot.sendTyping(jid, 2000); // Typing selama 2 detik

// Download media dari pesan
const buffer = await bot.downloadMedia(msg);

🌍 Platform Support

| Platform | Status | |----------|--------| | VPS Linux (Ubuntu/Debian/CentOS) | ✅ | | Termux (Google Play) | ✅ | | Termux (F-Droid) | ✅ | | Pterodactyl Panel | ✅ | | Docker | ✅ | | Windows | ✅ | | macOS | ✅ |

📦 Dependencies (Auto-Install)

Saat npm install f-baileys, package berikut otomatis diinstall jika belum ada:

| Package | Fungsi | |---------|--------| | @whiskeysockets/baileys | Core WhatsApp MD | | sharp | Image processing (WebP, resize, dll) | | jimp | Pure JS image processing | | fluent-ffmpeg | FFmpeg wrapper (convert audio/video) | | ffmpeg-static | Binary FFmpeg | | ytdl-core | YouTube downloader | | webp-converter | Konversi ke WebP (sticker) | | color | Manipulasi warna | | chalk | Warna terminal | | qrcode-terminal | Print QR di terminal | | axios | HTTP requests | | pino | Logger |

Untuk Termux: f-baileys otomatis menjalankan pkg install ffmpeg nodejs juga.

📱 Pairing Code Guide

1. Jalankan bot dengan usePairingCode: true
2. Kode 8 digit akan muncul di terminal (format: XXXX-XXXX)
3. Buka WhatsApp di HP → Perangkat Tertaut → Tautkan Perangkat
4. Pilih Tautkan dengan Nomor Telepon
5. Masukkan kode yang tampil di terminal
6. Selesai! ✓

🔧 Events

bot.on('qr',           (qr) => { ... })          // QR string
bot.on('open',         (sock) => { ... })         // Connected
bot.on('close',        ({ reason, code }) => {})  // Disconnected
bot.on('message',      (msg) => { ... })          // Pesan masuk
bot.on('logout',       () => { ... })             // Session logout
bot.on('group-update', (update) => { ... })       // Update grup

🛠 Utility

// Convert nomor ke JID
FBaileys.toJid('628123456789')        // → [email protected]
FBaileys.toGroupJid('120363xxxxxx')   // → [email protected]

📄 License

MIT © f-baileys