📌 Overview

❄️ @hbmodsofc/baileys is a refined version of the Baileys library with cleaner API usage, exclusive features like album messaging, newsletter controls, and full-size profile uploads — tailored for modern WhatsApp automation needs.

Christmas Update 🎁 All update information is now redirected to the WhatsApp channel check at the bottom of the "homepage".

Udpate changelog see on our WhatsApp channel

📦 Installation

Via package.json

Fork Baileys (NPM) @whiskeysockets/baileys / @adiwajshing/baileys

@whiskeysockets/baileys
"dependencies": {
    "@whiskeysockets/baileys": "npm:@hbmodsofc/baileys"
}

@adiwajsing/baileys
"dependencies": {
    "@adiwajshing/baileys": "npm:@hbmodsofc/baileys"
}

Or via terminal non fork

npm install @hbmodsofc/baileys

Importing (for those who don't fork another repository) ESM & CJS

ESM

import makeWASocket from '@hbmodsofc/baileys

CJS

const { default: makeWASocket } = require('@hbmodsofc/baileys')

🌟 Key Features | Category | Description | |---|---| |channels | Seamlessly send messages to WhatsApp Channels. | | 🖱️ Buttons | Create interactive messages with button options and quick replies. | | 🖼️ Albums | Send grouped images or videos as an album (carousel-like format). | | 👤 LID Grouping | Handle group operations using the latest @lid addressing style. | | 🤖 AI Message Style | Add a stylized “AI” icon to messages. | | 📷 HD Profile Pics | Upload full-size profile pictures without cropping. | | 🔐 Pairing Code | Generate custom alphanumeric pairing codes. | | 🛠️ Dev Experience | Reduced noise from logs with optimized libsignal printouts. |

🚀 Features & Usage

📬 Newsletter Control

Manage WhatsApp Newsletter (Channel), from creation to message interaction.

// Create a newsletter
await sock.newsletterCreate("HBWABot Updates");

// Update description
await sock.newsletterUpdateDescription(
  "hbmodsofc@newsletter",
  "Fresh updates weekly"
);

// React to a channel message
await sock.newsletterReactMessage(
  "hbmodsofc@newsletter",
  "175",
  "🔥"
);

📌 Interactive Messaging

Send interactive messages using buttons to increase user interaction.

const buttons = [
  { buttonId: "btn1", buttonText: { displayText: "Click Me" }, type: 1 },
  { buttonId: "btn2", buttonText: { displayText: "Visit Site" }, type: 1 }
];

await sock.sendMessage(id, {
  text: "Choose one:",
  footer: "From HBWABot with love 💜",
  buttons,
  headerType: 1
});

🖼️ Send Album

Send multiple media (images or videos) in one album message.

const media = [
  { image: { url: "https://example.com/pic1.jpg" } },
  { video: { url: "https://example.com/clip.mp4" } }
];

await sock.sendMessage(
  id,
  { album: media, caption: "Memories 💫" }
);

🔐 Custom Pairing Code

Pairing WhatsApp devices using custom code.

const code = await sock.requestPairingCode("91xxxxxxxxxx","HBWABOTZ");

console.log("Pairing Code:", code);

📊 Poll Creation

Create polls for quick voting in chats or groups.

await sock.sendMessage(id, {
  poll: {
    name: "Favorite Color?",
    values: ["Red", "Blue", "Green"],
    selectableCount: 1
  }
});

📍 Location Sharing

Share complete location with coordinates and address.

await sock.sendMessage(id, {
  location: {
    degreesLatitude: 37.422,
    degreesLongitude: -122.084,
    name: "Googleplex",
    address: "1600 Amphitheatre Pkwy, Mountain View"
  }
});

👥 Group Management

Manage WhatsApp groups: create groups, add members, and update descriptions.

const group = await sock.groupCreate(
  "My New Group",
  [number1, number2]
);

await sock.groupAdd(group.id, [number3]);
await sock.groupUpdateDescription(group.id,"This is our awesome group!"
);

🐞 Found a Bug?

If you encounter a bug or issue while using this project, please do one of the following:

• Open an Issue through the official website (coming soon)
• Contact the maintainer directly via WhatsApp