@ms-nicky/baileys
Advanced tools
WhatsApp API library using WebSocket technology (multi-device).
Fork of WhiskeySockets/Baileys with:
npm install github:ms-nicky/baileys
Or in package.json:
"@whiskeysockets/baileys": "github:ms-nicky/baileys"
const { default: makeWASocket, useMultiFileAuthState, fetchLatestWaWebVersion, makeCacheableSignalKeyStore } = require('@ms-nicky/baileys')
const pino = require('pino')
async function start() {
const { version } = await fetchLatestWaWebVersion()
const { state, saveCreds } = await useMultiFileAuthState('auth_info')
const sock = makeWASocket({
version,
auth: {
creds: state.creds,
keys: makeCacheableSignalKeyStore(state.keys, pino({ level: 'silent' })),
},
printQRInTerminal: false,
browser: ['Linux', 'Chrome', ''], // [OS, browser, version]
})
sock.ev.on('creds.update', saveCreds)
sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
if (connection === 'open') console.log('✓ Connected')
if (connection === 'close') {
const code = lastDisconnect?.error?.output?.statusCode
// 515 = pairing accepted, reconnect
if (code === 515) start()
else if (code !== 401) setTimeout(start, 5000)
}
})
const code = await sock.requestPairingCode('62812xxxxxxx')
console.log(`Pairing code: ${code}`)
}
start()
node pair.js 62812xxxxxxx # random code
node pair.js 62812xxxxxxx ELAINA13 # custom code (8 chars)
Auto-reconnects after pairing is accepted (handles 515 stream error).
Fetches latest WA version from WPPConnect, falls back to hardcoded.
const { version, isLatest } = await fetchLatestWaWebVersion()
0)query with 30s timeout)const code = await sock.requestPairingCode('62812xxxxxxx')
const code = await sock.requestPairingCode('62812xxxxxxx', 'MYCODE13')
Automatically detects 405 Method Not Allowed and retries the connection.
Built-in WebRTC voice calling using the official WhatsApp WASM stack.
Powered by baileys-caller.
const { createVoipClient, CallState } = require('@ms-nicky/baileys')
const client = await createVoipClient({ authDir: 'auth_info' })
const call = await client.call('62812xxxxxxx', { durationMs: 60000 })
call.on('ringing', () => console.log('• ringing'))
call.on('connected', () => console.log('✓ connected'))
call.on('ended', (reason) => console.log('• ended:', reason))
// Control
call.mute(true) // mute/unmute
call.end() // hang up
call.waitForEnd() // promise resolves when call ends
// Later
client.disconnect() // cleanup
node call-test.js # default target
node call-test.js 62812xxxxxxx # specific number
CALL_DURATION=60000 node call-test.js # custom duration (ms)
CallState.Idle // 0
CallState.Calling // 1
CallState.PreacceptReceived // 2
CallState.ReceivedCall // 3
CallState.AcceptSent // 4
CallState.AcceptReceived // 5
CallState.Active // 6
CallState.ActiveElsewhere // 7
CallState.Ending // 13
await sock.sendMessage(jid, { text: 'Hello World' })
await sock.sendMessage(jid, { image: { url: 'https://example.com/image.jpg' }, caption: 'Caption' })
await sock.sendMessage(jid, { video: { url: 'https://example.com/video.mp4' }, caption: 'Caption' })
await sock.sendMessage(jid, { audio: { url: 'https://example.com/audio.mp3' }, mimetype: 'audio/mp4', ptt: true })
await sock.sendMessage(jid, { document: fs.readFileSync('./file.pdf'), mimetype: 'application/pdf', fileName: 'file.pdf' })
await sock.sendMessage(jid, { sticker: { url: 'https://example.com/image.webp' } })
await sock.sendMessage(jid, { location: { degreesLatitude: -6.2, degreesLongitude: 106.8 } })
await sock.sendMessage(jid, { contacts: { displayName: 'Alice', contacts: [{ vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Alice\nEND:VCARD' }] } })
await sock.sendMessage(jid, {
poll: {
name: 'Pilihan',
values: ['A', 'B', 'C'],
selectableCount: 1
}
})
await sock.sendMessage(jid, {
list: {
title: 'Menu',
text: 'Pilih opsi:',
buttonText: 'Lihat',
sections: [{
title: 'Section',
rows: [{ title: 'Option 1', description: 'Desc', rowId: 'opt1' }]
}]
}
})
await sock.sendMessage(jid, {
buttons: [
{ buttonId: 'btn1', buttonText: { displayText: 'Button 1' }, type: 1 }
],
header: 'Header',
text: 'Text',
footer: 'Footer'
})
await sock.sendMessage(jid, {
albumMessage: [
{ image: fs.readFileSync('./img1.jpg'), caption: 'Photo 1' },
{ image: { url: 'https://example.com/img.jpg' }, caption: 'Photo 2' }
]
})
await sock.sendMessage(jid, {
interactiveMessage: {
header: 'Header',
title: 'Title',
footer: 'Footer',
buttons: [{
name: 'cta_copy',
buttonParamsJson: JSON.stringify({ display_text: 'Copy Code', id: '123', copy_code: 'ABC123' })
}]
}
})
await sock.sendMessage(jid, {
interactiveMessage: {
header: 'Header',
title: 'Title',
footer: 'Footer',
nativeFlowMessage: {
messageParamsJson: JSON.stringify({ bottom_sheet: { in_thread_buttons_limit: 2, list_title: 'Menu', button_title: 'Pilih' } }),
buttons: [{
name: 'single_select',
buttonParamsJson: JSON.stringify({ title: 'Pilih Opsi', sections: [{ title: 'Section', rows: [{ title: 'Option 1', id: 'opt1' }] }] })
}]
}
}
})
await sock.sendMessage(jid, {
eventMessage: {
isCanceled: false,
name: 'Event Name',
description: 'Description',
location: { degreesLatitude: 0, degreesLongitude: 0, name: 'Location' },
startTime: String(Math.floor(Date.now() / 1000)),
endTime: String(Math.floor(Date.now() / 1000) + 3600)
}
})
await sock.sendMessage(jid, {
pollResultMessage: {
name: 'Poll Name',
pollVotes: [
{ optionName: 'A', optionVoteCount: '10' },
{ optionName: 'B', optionVoteCount: '5' }
]
}
})
await sock.sendMessage(jid, {
productMessage: {
title: 'Product',
description: 'Description',
thumbnail: { url: 'https://example.com/img.jpg' },
productId: 'PROD001',
retailerId: 'RETAIL001',
priceAmount1000: 50000,
currencyCode: 'IDR',
buttons: [{ name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: 'Buy Now', url: 'https://example.com/buy' }) }]
}
})
await sock.sendMessage(jid, {
requestPaymentMessage: {
currency: 'IDR',
amount: 100000,
from: m.sender,
background: { id: '100', fileLength: '0', width: 1000, height: 1000, mimetype: 'image/webp', placeholderArgb: 0xFF00FFFF, textArgb: 0xFFFFFFFF, subtextArgb: 0xFFAA00FF }
}
})
await sock.sendStatusMention('Hello', jid)
// Create group
const group = await sock.groupCreate('Group Name', [participant1, participant2])
// Update subject
await sock.groupUpdateSubject(jid, 'New Subject')
// Update description
await sock.groupUpdateDescription(jid, 'New Description')
// Add / Remove participants
await sock.groupParticipantsUpdate(jid, [participant1], 'add')
await sock.groupParticipantsUpdate(jid, [participant1], 'remove')
// Promote / Demote admin
await sock.groupParticipantsUpdate(jid, [participant1], 'promote')
await sock.groupParticipantsUpdate(jid, [participant1], 'demote')
// Leave group
await sock.groupLeave(jid)
// Invite code
const code = await sock.groupInviteCode(jid)
await sock.groupRevokeInviteCode(jid)
// Settings
await sock.groupSettingUpdate(jid, 'announcement') // or 'not_announcement'
await sock.groupSettingUpdate(jid, 'locked') // or 'unlocked'
// Ephemeral messages
await sock.groupToggleEphemeral(jid, 86400)
// Label group
await sock.setLabelGroup(jid, 'label')
const info = await sock.newsletterFromUrl('https://whatsapp.com/channel/...')
console.log(info) // { name, id, state, subscribers, verification, creation_time, description }
// Check if number is on WhatsApp
const result = await sock.checkWhatsApp(jid)
// Block/unblock
await sock.updateBlockStatus(jid, 'block')
await sock.updateBlockStatus(jid, 'unblock')
// Update profile status
await sock.updateProfileStatus('New status')
// Update profile name
await sock.updateProfileName('New Name')
// Set/remove profile picture
await sock.updateProfilePicture(jid, { url: 'https://example.com/photo.jpg' })
await sock.removeProfilePicture(jid)
// Get business profile
const profile = await sock.getBusinessProfile(jid)
// Connection update
sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
if (connection === 'open') console.log('Connected')
if (connection === 'close') {
// reconnect logic
}
})
// Messages
sock.ev.on('messages.upsert', ({ messages, type }) => {
// handle incoming messages
})
// Presence
sock.ev.on('presence.update', ({ id, presences }) => {
// online, typing, recording, etc
})
// Group update
sock.ev.on('groups.update', (groups) => {
// group metadata changes
})
// Credentials
sock.ev.on('creds.update', saveCreds)
MIT
FAQs
WhatsApp API
The npm package @ms-nicky/baileys receives a total of 116 weekly downloads. As such, @ms-nicky/baileys popularity was classified as not popular.
We found that @ms-nicky/baileys demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Compromised maintainer accounts pushed malicious @ethersphere/bee-js 13.3.0 and Swarm Desktop 0.56.2, reusing SleepyDuck’s Ethereum-addressed C2 infrastructure.
Security News
Socket has released a free Certified Patch for a critical Rails Active Storage vulnerability, giving developers time to upgrade to a secure Rails version.
Security News
/Threat Research
A malicious Ruby gem runs a credential-stealing worm during installation, poisons AI coding tools, and can wipe files when a stolen GitHub token is revoked.