A lightweight fork of Baileys with a few fixes and a small adjustment.
- πΌοΈ Fixed an issue where media could not be sent to newsletters due to an upstream issue.
- π Reintroduced
makeInMemoryStorewith a minimal ESM adaptation and small adjustments for Baileys v7. - π¦ Switched FFmpeg execution from
exectospawnfor safer process handling.
- ππ» Added support for sending interactive message types (button, list, interactive, template, carousel).
- π© Added support for album messages, group status messages, sticker pack messages, and several payment-related messages (request payment, payment invite, order, invoice).
- π° Simplified sending messages with ad thumbnails via
externalAdReplywithout requiring manualcontextInfo.
- ποΈ Added optional boolean flags for message handling:
ai- AI label on messageephemeral,groupStatus,viewOnceV2,viewOnceV2Extension,interactiveAsTemplate- Message wrappersraw- Build your message manually (DO NOT USE FOR EXPLOITATION)
Note
π This project is maintained with limited scope and is not intended to replace upstream Baileys.
π And, really sorry for my bad english.
- π Via
package.json
# NPM
"dependencies": {
"@itsliaaa/baileys": "latest"
}
# GitHub
"dependencies": {
"@itsliaaa/baileys": "github:itsliaaa/baileys"
}- β¨οΈ Via terminal
# NPM
npm i @itsliaaa/baileys@latest
# GitHub
npm i github:itsliaaa/baileys- π§© Import (ESM & CJS)
// --- ESM
import { makeWASocket } from '@itsliaaa/baileys'
// --- CJS (tested and working on Node.js 24 β
)
const { makeWASocket } = require('@itsliaaa/baileys')π Connect to WhatsApp (Quick Step)
import { makeWASocket, delay, DisconnectReason, useMultiFileAuthState } from '@itsliaaa/baileys'
import { Boom } from '@hapi/boom'
import pino from 'pino'
// --- Connect with pairing code
const myPhoneNumber = '6288888888888'
const connectToWhatsApp = async () => {
const { state, saveCreds } = await useMultiFileAuthState('session')
const logger = pino({ level: 'silent' })
const sock = makeWASocket({
logger,
auth: state
})
sock.ev.on('creds.update', saveCreds)
sock.ev.on('connection.update', (update) => {
const { connection, lastDisconnect } = update
if (connection === 'connecting' && !sock.authState.creds.registered) {
await delay(1500)
const code = await sock.requestPairingCode(myPhoneNumber)
console.log('π Pairing code', ':', code)
}
else if (connection === 'close') {
const shouldReconnect = new Boom(connection?.lastDisconnect?.error)?.output?.statusCode !== DisconnectReason.loggedOut
console.log('β οΈ Connection closed because', lastDisconnect.error, ', reconnecting ', shouldReconnect)
if (shouldReconnect) {
connectToWhatsApp()
}
}
else if (connection === 'open') {
console.log('β
Successfully connected to WhatsApp')
}
})
sock.ev.on('messages.upsert', async ({ messages }) => {
for (const message of messages) {
if (!message.message) continue
console.log('π Got new message', ':', message)
await sock.sendMessage(message.key.remoteJid, {
text: 'ππ» Hello world'
})
}
})
}
connectToWhatsApp()ποΈ Implementing a Data Store
π I highly recommend building your own data store, as keeping an entire chat history in memory can lead to excessive RAM usage.
import { makeWASocket, makeInMemoryStore, delay, DisconnectReason, useMultiFileAuthState } from '@itsliaaa/baileys'
import { Boom } from '@hapi/boom'
import pino from 'pino'
const myPhoneNumber = '6288888888888'
// --- Create your store path
const storePath = './store.json'
const connectToWhatsApp = async () => {
const { state, saveCreds } = await useMultiFileAuthState('session')
const logger = pino({ level: 'silent' })
const sock = makeWASocket({
logger,
auth: state
})
const store = makeInMemoryStore({
logger,
socket: sock
})
store.bind(sock.ev)
sock.ev.on('creds.update', saveCreds)
sock.ev.on('connection.update', (update) => {
const { connection, lastDisconnect } = update
if (connection === 'connecting' && !sock.authState.creds.registered) {
await delay(1500)
const code = await sock.requestPairingCode(myPhoneNumber)
console.log('π Pairing code', ':', code)
}
else if (connection === 'close') {
const shouldReconnect = new Boom(connection?.lastDisconnect?.error)?.output?.statusCode !== DisconnectReason.loggedOut
console.log('β οΈ Connection closed because', lastDisconnect.error, ', reconnecting ', shouldReconnect)
if (shouldReconnect) {
connectToWhatsApp()
}
}
else if (connection === 'open') {
console.log('β
Successfully connected to WhatsApp')
}
})
sock.ev.on('chats.upsert', () => {
console.log('βοΈ Got chats', store.chats.all())
})
sock.ev.on('contacts.upsert', () => {
console.log('π₯ Got contacts', Object.values(store.contacts))
})
// --- Read store from file
store.readFromFile(storePath)
// --- Save store every 3 minutes
setInterval(() => {
store.writeToFile(storePath)
}, 180000)
}
connectToWhatsApp()πͺͺ WhatsApp IDs Explain
id is the WhatsApp ID, called jid and lid too, of the person or group you're sending the message to.
- It must be in the format
[country code][phone number]@s.whatsapp.net- Example for people:
19999999999@s.whatsapp.netand12699999999@lid. - For groups, it must be in the format
123456789-123345@g.us.
- Example for people:
- For Meta AI, it's
11111111111@bot. - For broadcast lists, it's
[timestamp of creation]@broadcast. - For stories, the ID is
status@broadcast.
βοΈ Sending Messages
π You can get the
jidfrommessage.key.remoteJidin the first example.
π© Sending Common Messages
sock.sendMessage(jid, {
text: 'ππ» Hello'
}, {
quoted: message
})sock.sendMessage(jid, {
text: 'ππ» Hello @628123456789',
mentions: ['628123456789@s.whatsapp.net']
}, {
quoted: message
})sock.sendMessage(jid, {
react: {
key: message.key,
text: 'β¨'
}
}, {
quoted: message
})sock.sendMessage(jid, {
pin: message.key,
time: 86400, // --- Set the value in seconds: 86400 (1d), 604800 (7d), or 2592000 (30d)
type: 1 // --- Or 0 to remove
}, {
quoted: message
})const vcard = 'BEGIN:VCARD\n'
+ 'VERSION:3.0\n'
+ 'FN:Elia Wynn\n'
+ 'ORG:Waiters;\n'
+ 'TEL;type=CELL;type=VOICE;waid=628123456789:+62 8123 4567 89\n'
+ 'END:VCARD'
sock.sendMessage(jid, {
contacts: {
displayName: 'Elia',
contacts: [
{ vcard }
]
}
}, {
quoted: message
})sock.sendMessage(jid, {
location: {
degreesLatitude: 24.121231,
degreesLongitude: 55.1121221,
name: 'ππ» I am here'
}
}, {
quoted: message
})// --- Regular poll message
sock.sendMessage(jid, {
poll: {
name: 'π₯ Voting time',
values: ['Yes', 'No'],
selectableCount: 1,
toAnnouncementGroup: false
}
}, {
quoted: message
})
// --- Quiz (only for newsletter)
sock.sendMessage('1211111111111@newsletter', {
poll: {
name: 'π₯ Quiz',
values: ['Yes', 'No'],
correctAnswer: 'Yes',
pollType: 1
}
}, {
quoted: message
})
// Poll result
sock.sendMessage(jid, {
pollResult: {
name: 'π Poll Result',
votes: [{
name: 'Nice',
voteCount: 10
}, {
name: 'Nah',
voteCount: 2
}],
pollType: 0 // Or 1 for quiz
}
}, {
quoted: message
})
// Poll update
sock.sendMessage(jid, {
pollUpdate: {
metadata: {},
key: message.key,
vote: {
enclv: /* <Buffer> */,
encPayload: /* <Buffer> */
}
}
}, {
quoted: message
})π Sending Media Messages
π For media messages, you can pass a
Bufferdirectly, or an object with either{ stream: Readable }or{ url: string }(local file path or HTTP/HTTPS URL).
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'π₯ Superb'
}, {
quoted: message
})sock.sendMessage(jid, {
video: {
url: './path/to/video.mp4'
},
gifPlayback: false, // --- Set true if you want to send video as GIF
ptv: false, // --- Set true if you want to send video as PTV
caption: 'π₯ Superb'
}, {
quoted: message
})sock.sendMessage(jid, {
sticker: {
url: './path/to/sticker.webp'
}
}, {
quoted: message
})sock.sendMessage(jid, {
audio: {
url: './path/to/audio.mp3'
},
ptt: false, // --- Set true if you want to send audio as Voice Note
}, {
quoted: message
})sock.sendMessage(jid, {
album: [{
image: {
url: './path/to/image.jpg'
},
caption: '1st image'
}, {
video: {
url: './path/to/video.mp4'
},
caption: '1st video'
}, {
image: {
url: './path/to/image.jpg'
},
caption: '2nd image'
}, {
video: {
url: './path/to/video.mp4'
},
caption: '2nd video'
}]
}, {
quoted: message
})π If Sharp is not installed, the
coverandstickersmust already be in WebP format.
sock.sendMessage(jid, {
cover: {
url: './path/to/image.webp'
},
stickers: [{
data: {
url: './path/to/image.webp'
}
}, {
data: {
url: './path/to/image.webp'
}
}, {
data: {
url: './path/to/image.webp'
}
}],
name: 'π¦ My Sticker Pack',
publisher: 'π Elia',
description: '@itsliaaa/baileys'
}, {
quoted: message
})ππ» Sending Interactive Messages
sock.sendMessage(jid, {
text: 'ππ» Buttons!',
footer: '@itsliaaa/baileys',
buttons: [{
text: 'ππ» SignUp',
id: '#SignUp'
}]
}, {
quoted: message
})sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ππ» Buttons and Native Flow!',
footer: '@itsliaaa/baileys',
buttons: [{
text: 'ππ» Rating',
id: '#Rating'
}, {
name: 'single_select',
paramsJson: JSON.stringify({
title: 'π Select',
sections: [{
title: 'β¨ Section 1',
rows: [{
header: '',
title: 'π Secret Ingredient',
description: '',
id: '#SecretIngredient'
}]
}, {
title: 'β¨ Section 2',
highlight_label: 'π₯ Popular',
rows: [{
header: '',
title: 'π·οΈ Coupon',
description: '',
id: '#CouponCode'
}]
}]
})
}]
}, {
quoted: message
})π It only works in private chat (
@s.whatsapp.net).
sock.sendMessage(jid, {
text: 'π List!',
footer: '@itsliaaa/baileys',
buttonText: 'π Select',
title: 'ππ» Hello',
sections: [{
title: 'π Menu 1',
rows: [{
title: 'β¨ AI',
description: '',
rowId: '#AI'
}]
}, {
title: 'π± Menu 2',
rows: [{
title: 'π Search',
description: '',
rowId: '#Search'
}]
}]
}, {
quoted: message
})sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ποΈ Interactive!',
footer: '@itsliaaa/baileys',
optionText: 'ππ» Select Options', // --- Optional, wrap all native flow into a single list
optionTitle: 'π Select Options', // --- Optional
couponText: 'π·οΈ Newest Coupon!', // --- Optional, add coupon into message
couponCode: '@itsliaaa/baileys', // --- Optional
nativeFlow: [{
text: 'ππ» Greeting',
id: '#Greeting'
}, {
text: 'π Call',
call: '628123456789'
}, {
text: 'π Copy',
copy: '@itsliaaa/baileys'
}, {
text: 'π Source',
url: 'https://www.npmjs.com/package/baileys'
}, {
name: 'single_select',
buttonParamsJson: JSON.stringify({
title: 'π Select',
sections: [{
title: 'β¨ Section 1',
rows: [{
header: '',
title: 'π·οΈ Coupon',
description: '',
id: '#CouponCode'
}]
}, {
title: 'β¨ Section 2',
highlight_label: 'π₯ Popular',
rows: [{
header: '',
title: 'π Secret Ingredient',
description: '',
id: '#SecretIngredient'
}]
}]
})
}],
interactiveAsTemplate: false, // --- Optional, wrap the interactive message into a template
}, {
quoted: message
})sock.sendMessage(jid, {
text: 'ποΈ Interactive with Carousel!',
footer: '@itsliaaa/baileys',
cards: [{
image: {
url: './path/to/image.jpg'
},
caption: 'πΌοΈ Image 1',
footer: 'π·οΈοΈ Pinterest',
nativeFlow: [{
text: 'π Source',
url: 'https://www.npmjs.com/package/baileys'
}]
}, {
image: {
url: './path/to/image.jpg'
},
caption: 'πΌοΈ Image 2',
footer: 'π·οΈ Pinterest',
couponText: 'π·οΈ New Coupon!',
couponCode: '@itsliaaa/baileys',
nativeFlow: [{
text: 'π Source',
url: 'https://www.npmjs.com/package/baileys'
}]
}, {
image: {
url: './path/to/image.jpg'
},
caption: 'πΌοΈ Image 3',
footer: 'π·οΈ Pinterest',
optionText: 'ππ» Select Options',
optionTitle: 'π Select Options',
couponText: 'π·οΈ New Coupon!',
couponCode: '@itsliaaa/baileys',
nativeFlow: [{
text: 'π Product',
id: '#Product'
}, {
text: 'π Source',
url: 'https://www.npmjs.com/package/baileys'
}]
}]
}, {
quoted: message
})sock.sendMessage(jid, {
title: 'ππ» Hello',
image: {
url: './path/to/image.jpg'
},
caption: 'π« Template!',
footer: '@itsliaaa/baileys',
templateButtons: [{
text: 'ππ» Tap Here',
id: '#Order'
}, {
text: 'π Source',
url: 'https://www.npmjs.com/package/baileys'
}, {
text: 'π Call',
call: '628123456789'
}]
}, {
quoted: message
})π³ Sending Payment Messages
sock.sendMessage(jid, {
paymentInviteServiceType: 3 // 1, 2, or 3
})π Invoice message are not supported yet.
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
invoiceNote: 'π·οΈ Invoice'
})sock.sendMessage(chat, {
orderText: 'ποΈ Order',
thumbnail: fs.readFileSync('./path/to/image.jpg') // --- Must in buffer format
}, {
quoted: message
})sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
product: {
title: 'π My Product'
},
businessOwnerJid: '0@s.whatsapp.net' // --- Must included
}, {
quoted: message
})sock.sendMessage(jid, {
text: 'π³ Request Payment',
requestPaymentFrom: '0@s.whatsapp.net'
})ποΈ Other Message Options
π It only works in private chat (
@s.whatsapp.net).
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'π€ AI Labeled!',
ai: true
}, {
quoted: message
})π Wrap message into
ephemeralMessage
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ποΈ Ephemeral',
ephemeral: true
})π Add an ad thumbnail to messages (may not be displayed on some WhatsApp versions).
sock.sendMessage(jid, {
text: 'π° External Ad Reply',
externalAdReply: {
title: 'π Did you know?',
body: 'β I dont know',
thumbnail: fs.readFileSync('./path/to/image.jpg'), // --- Must in buffer format
largeThumbnail: false, // --- Or true for bigger thumbnail
url: 'https://www.npmjs.com/package/baileys' // --- Optional, used for WhatsApp internal thumbnail caching and direct URL
}
}, {
quoted: message
})π It only works in group chat (
@g.us)
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'π₯ Group Status!',
groupStatus: true
})sock.sendMessage(jid, {
extendedTextMessage: {
text: 'π Built manually from scratch using the raw WhatsApp proto structure',
contextInfo: {
externalAdReply: {
title: '@itsliaaa/baileys',
thumbnail: fs.readFileSync('./path/to/image.jpg'),
sourceApp: 'whatsapp',
showAdAttribution: true,
mediaType: 1
}
}
},
raw: true
}, {
quoted: message
})π Wrap message into
viewOnceMessage
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ποΈ View Once',
viewOnce: true
})π Wrap message into
viewOnceMessageV2
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ποΈ View Once V2',
viewOnceV2: true
})π Wrap message into
viewOnceMessageV2Extension
sock.sendMessage(jid, {
image: {
url: './path/to/image.jpg'
},
caption: 'ποΈ View Once V2 Extension',
viewOnceV2Extension: true
})π§° Additional Contents
π The ID must contain numbers only (no +, (), or -) and must include the country code with WhatsApp ID format.
// --- PN (Phone Number)
const phoneNumber = '6281111111111@s.whatsapp.net'
const ids = await sock.findUserId(phoneNumber)
console.log('π·οΈ Got user ID', ':', ids)
// --- LID (Local Identifier)
const lid = '43411111111111@lid'
const ids = await sock.findUserId(lid)
console.log('π·οΈ Got user ID', ':', ids)
// --- Output
// {
// phoneNumber: '6281111111111@s.whatsapp.net',
// lid: '43411111111111@lid'
// }
// --- Output when failed
// {
// phoneNumber: '6281111111111@s.whatsapp.net',
// lid: 'id-not-found'
// }
// --- Same output shape regardless of input typeimport { getImageProcessingLibrary } from '@itsliaaa/baileys'
const lib = await getImageProcessingLibrary()
if (lib.ffmpeg) {
const job = await lib.ffmpeg({
args: [
'-i', 'path/to/media.jpg',
'-frames:v', '1',
'-q:v', '10'
],
extension: 'jpg' // --- Used for output file extension
})
const buffer = await job.toBuffer() // --- Optional if you need a buffer. The output file will be deleted automatically after the buffer is created.
}
else {
throw new Error('FFmpeg not available')
}
// --- Output
// {
// outputFilename: 'output/path.jpg',
// toBuffer: [AsyncFunction: toBuffer]
// }π The phone number must contain numbers only (no +, (), or -) and must include the country code.
const phoneNumber = '6281111111111'
const customPairingCode = 'STARFALL'
await sock.requestPairingCode(phoneNumber, customPairingCode)
console.log('π Pairing code', ':', customPairingCode)π£ Newsletter Management
// --- Create a new one
sock.newsletterCreate('@itsliaaa/baileys')
// --- Get info
sock.newsletterMetadata('1231111111111@newsletter')
// --- Demote admin
sock.newsletterDemote('1231111111111@newsletter', '6281111111111@s.whatsapp.net')
// --- Change owner
sock.newsletterChangeOwner('1231111111111@newsletter', '6281111111111@s.whatsapp.net')
// --- Change name
sock.newsletterUpdateName('1231111111111@newsletter', 'π¦ @itsliaaa/baileys')
// --- Change description
sock.newsletterUpdateDescription('1231111111111@newsletter', 'π£ Fresh updates weekly')
// --- Change photo
sock.newsletterUpdatePicture('1231111111111@newsletter', {
url: 'path/to/image.jpg'
})
// --- Remove photo
sock.newsletterRemovePicture('1231111111111@newsletter')
// --- React to a message
sock.newsletterReactMessage('1231111111111@newsletter', '100', 'π')
// --- Get all subscribed newsletters
const newsletters = await sock.newsletterSubscribed()
console.dir(newsletters, { depth: null })π₯ Group Management
// --- Create a new one and add participants using their JIDs
sock.groupCreate('@itsliaaa/baileys', ['628123456789@s.whatsapp.net'])
// --- Get info
sock.groupMetadata(jid)
// --- Get invite code
sock.groupInviteCode(jid)
// --- Revoke invite link
sock.groupRevokeInvite(jid)
// --- Leave group
sock.groupLeave(jid)
// --- Add participants
sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'add')
// --- Remove participants
sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'remove')
// --- Promote to admin
sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'promote')
// --- Demote from admin
sock.groupParticipantsUpdate(jid, ['628123456789@s.whatsapp.net'], 'demote')
// --- Change name
sock.groupUpdateSubject(jid, 'π¦ @itsliaaa/baileys')
// --- Change description
sock.groupUpdateDescription(jid, 'Updated description')
// --- Change photo
sock.updateProfilePicture(jid, {
url: 'path/to/image.jpg'
})
// --- Remove photo
sock.removeProfilePicture(jid)
// --- Set group as admin only for chatting
sock.groupSettingUpdate(jid, 'announcement')
// --- Set group as open to all for chatting
sock.groupSettingUpdate(jid, 'not_announcement')
// --- Set admin only can edit group info
sock.groupSettingUpdate(jid, 'locked')
// --- Set all participants can edit group info
sock.groupSettingUpdate(jid, 'unlocked')
// --- Set admin only can add participants
sock.groupMemberAddMode(jid, 'admin_add')
// --- Set all participants can add participants
sock.groupMemberAddMode(jid, 'all_member_add')
// --- Enable or disable temporary messages with seconds format
sock.groupToggleEphemeral(jid, 86400)
// --- Disable temporary messages
sock.groupToggleEphemeral(jid, 0)
// --- Enable or disable membership approval mode
sock.groupJoinApprovalMode(jid, 'on')
sock.groupJoinApprovalMode(jid, 'off')
// --- Get all groups metadata
const groups = await sock.groupFetchAllParticipating()
console.dir(groups, { depth: null })
// --- Get pending invites
const invites = await sock.groupGetInviteInfo(code)
console.dir(invites, { depth: null })
// --- Accept group invite
sock.groupAcceptInvite(code)
// --- Get group info from link
const group = await sock.groupGetInviteInfo('https://chat.whatsapp.com/ABC123')
console.log('π₯ Got group info from link', ':', group)Note
This fork is based on Baileys (GitHub)
Important
This fork uses Protocol Buffer definitions maintained by WPP Connect via wa-proto
All rights belong to the original Baileys maintainers and contributors:
