🚀 WhatsApp Web API

A powerful WebSockets-based TypeScript library for interacting with the WhatsApp Web API

📖 Documentation • 🚀 Quick Start • 💬 Support • 🤝 Contributing

---

⚠️ Important Disclaimer

Warning

This project is not affiliated with WhatsApp Inc. Use responsibly and comply with WhatsApp's Terms of Service.

We strongly discourage:

• Spam messaging
• Bulk messaging
• Stalkerware usage
• Any automated abuse

---

✨ Features

🔐 Multi-Device Connect as secondary device Advanced multi-device support with seamless synchronization across platforms	📱 QR & Pairing Multiple connection methods Support for both QR code scanning and pairing code authentication	🎨 Rich Messages Buttons, polls, media, etc. Interactive messages with buttons, polls, location sharing, and media attachments	🔄 Real-time Events Live message updates WebSocket-based real-time messaging with instant delivery notifications
👥 Group Management Full admin capabilities Complete group administration including member management and settings control	🔒 Privacy Controls Block, privacy settings Comprehensive privacy management and user blocking functionality	📊 Message History Fetch chat history Access and manage complete conversation history with powerful search capabilities	🎯 Custom Functions Extensible architecture Highly customizable with plugin support and custom event handlers

---

🚀 Quick Start

📦 Installation

# 📦 Using npm (stable version) **not available**
npm install @owensdev1/baileys

# 🧶 Using yarn (edge version)
yarn add @owensdev1/baileys

🔌 Basic Usage

const { default: makeWASocket, DisconnectReason, useMultiFileAuthState } = require("@owensdev1/baileys");
const { Boom } = require('@hapi/boom');

async function connectToWhatsApp() {
    const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');
    
    const sock = makeWASocket({
        auth: state,
        printQRInTerminal: true
    });

    sock.ev.on('connection.update', (update) => {
        const { connection, lastDisconnect } = update;
        
        if(connection === 'close') {
            const shouldReconnect = (lastDisconnect.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut;
            console.log('Connection closed, reconnecting...', shouldReconnect);
            
            if(shouldReconnect) {
                connectToWhatsApp();
            }
        } else if(connection === 'open') {
            console.log('✅ Connected to WhatsApp!');
        }
    });

    sock.ev.on('messages.upsert', async (m) => {
        console.log('📩 New message:', JSON.stringify(m, undefined, 2));
        
        // Echo received messages
        const msg = m.messages[0];
        if (!msg.key.fromMe && msg.message) {
            await sock.sendMessage(msg.key.remoteJid, { text: 'Hello! 👋' });
        }
    });

    sock.ev.on('creds.update', saveCreds);
}

connectToWhatsApp();

---

📚 Table of Contents

🏗️ Setup & Connection 🔌 Connecting Account 📱 QR Code Connection 🔢 Pairing Code Connection 📜 Receive Full History ⚙️ Socket Configuration 💾 Save Auth Info

📨 Messaging 📤 Sending Messages 📝 Text Messages 🔘 Button Messages 🎯 Interactive Messages 📋 Poll Messages 📍 Location Messages 👤 Contact Messages 🎬 Media Messages ✏️ Modify Messages

🔧 Advanced Features 👥 Groups Management 🔒 Privacy Settings 📢 Broadcast & Stories 📊 Data Store Implementation 🎯 Custom Functionality 🐛 Debug Mode

---

🔌 Connecting Account

📱 Starting socket with QR-CODE

[!TIP] Pro Tip: Customize browser name using the Browser constant. See available browsers.

const { default: makeWASocket, Browsers } = require("@owensdev1/baileys");

const sock = makeWASocket({
    browser: Browsers.ubuntu('My App'),
    printQRInTerminal: true
});

🔢 Starting socket with Pairing Code

[!IMPORTANT] Pairing Code connects WhatsApp Web without QR-CODE.
Phone number format: country code + number (no +, (), or -)

const sock = makeWASocket({
    printQRInTerminal: false // Must be false for pairing code
});

// Standard pairing
if (!sock.authState.creds.registered) {
    const number = '1234567890'; // Your phone number
    const code = await sock.requestPairingCode(number);
    console.log('🔑 Pairing Code:', code);
}

// Custom pairing (8 digits/letters)
if (!sock.authState.creds.registered) {
    const customPair = "12345678";
    const number = '1234567890';
    const code = await sock.requestPairingCode(number, customPair);
    console.log('🔑 Custom Pairing Code:', code);
}

---

💾 Saving & Restoring Sessions

🎯 Never scan QR codes again! Save your session:

const { useMultiFileAuthState } = require("@owensdev1/baileys");

const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');

const sock = makeWASocket({ auth: state });

// Auto-save credentials when they update
sock.ev.on('creds.update', saveCreds);

[!WARNING] Critical: Always save auth keys when they update (authState.keys.set() is called) to ensure message delivery!

---

📤 Sending Messages

🎨 Message Types Gallery

📝 Text Simple text messages

🔘 Buttons Interactive buttons

📋 Polls Survey & voting

🎬 Media Images, videos, audio

📝 Text Message

await sock.sendMessage(jid, { text: 'Hello World! 🌍' });

🔘 Button Message

await sock.sendMessage(jid, {
    text: "Choose an option:",
    footer: "© 2025 Your Bot",
    buttons: [
        {
            buttonId: 'btn1',
            buttonText: { displayText: '✅ Option 1' },
            type: 1
        },
        {
            buttonId: 'btn2',
            buttonText: { displayText: '❌ Option 2' },
            type: 1
        }
    ],
    headerType: 1
});

🎯 Interactive Message with Flow

await sock.sendMessage(jid, {
    text: "Interactive Menu",
    footer: "© 2025 Bot",
    buttons: [
        {
            buttonId: 'menu',
            buttonText: { displayText: '📋 Show Menu' },
            type: 4,
            nativeFlowInfo: {
                name: 'single_select',
                paramsJson: JSON.stringify({
                    title: 'Select Option',
                    sections: [{
                        title: 'Available Options',
                        highlight_label: '⭐',
                        rows: [
                            {
                                header: 'OPTION 1',
                                title: 'First Choice',
                                description: 'Description for option 1',
                                id: 'opt1'
                            },
                            {
                                header: 'OPTION 2', 
                                title: 'Second Choice',
                                description: 'Description for option 2',
                                id: 'opt2'
                            }
                        ]
                    }]
                })
            }
        }
    ]
});

📋 Poll Message

await sock.sendMessage(jid, {
    poll: {
        name: 'What\'s your favorite color? 🎨',
        values: ['🔴 Red', '🔵 Blue', '🟢 Green', '🟡 Yellow'],
        selectableCount: 1
    }
});

🎬 Media Messages

🖼️ Images JPG, PNG, WebP support

🎥 Videos MP4, AVI with captions

🎵 Audio Voice notes & music

🖼️ Image Message

await sock.sendMessage(jid, {
    image: { url: './path/to/image.jpg' },
    caption: 'Beautiful image! 📸'
});

🎥 Video Message

await sock.sendMessage(jid, {
    video: { url: './path/to/video.mp4' },
    caption: 'Check this out! 🎬',
    ptv: false // Set to true for video note
});

🎵 Audio Message

await sock.sendMessage(jid, {
    audio: { url: './path/to/audio.mp3' },
    mimetype: 'audio/mp4'
});

---

📊 Implementing a Data Store

[!IMPORTANT] Production Ready: Build your own data store for production. The in-memory store is just for testing!

const { makeInMemoryStore } = require("@owensdev1/baileys");

const store = makeInMemoryStore({});

// Load from file
store.readFromFile('./baileys_store.json');

// Auto-save every 10 seconds
setInterval(() => {
    store.writeToFile('./baileys_store.json');
}, 10_000);

// Bind to socket
const sock = makeWASocket({});
store.bind(sock.ev);

// Access stored data
sock.ev.on('chats.upsert', () => {
    console.log('💬 Chats:', store.chats.all());
});

---

👥 Groups

🎯 Group Management Features

🆕 Create New groups

👤 Members Add/Remove users

⚙️ Settings Name, description

🛡️ Admin Promote/Demote

🆕 Create a Group

const group = await sock.groupCreate('🎉 My Awesome Group', [
    '1234567890@s.whatsapp.net',
    '0987654321@s.whatsapp.net'
]);

console.log('✅ Group created:', group.id);
await sock.sendMessage(group.id, { text: 'Welcome everyone! 👋' });

👤 Add/Remove Participants

await sock.groupParticipantsUpdate(
    groupJid,
    ['1234567890@s.whatsapp.net'],
    'add' // 'remove', 'promote', 'demote'
);

⚙️ Change Group Settings

// Update group name
await sock.groupUpdateSubject(groupJid, '🚀 New Group Name');

// Update description
await sock.groupUpdateDescription(groupJid, '📝 New group description');

// Admin-only messages
await sock.groupSettingUpdate(groupJid, 'announcement');

// Everyone can send messages
await sock.groupSettingUpdate(groupJid, 'not_announcement');

---

🔒 Privacy

🛡️ Privacy Controls

🚫 Block Management Block/Unblock users

⚙️ Privacy Settings Visibility controls

🚫 Block/Unblock Users

// Block user
await sock.updateBlockStatus(jid, 'block');

// Unblock user  
await sock.updateBlockStatus(jid, 'unblock');

⚙️ Privacy Settings

// Update various privacy settings
await sock.updateLastSeenPrivacy('contacts'); // 'all', 'contacts', 'none'
await sock.updateOnlinePrivacy('all'); // 'all', 'match_last_seen'
await sock.updateProfilePicturePrivacy('contacts');
await sock.updateStatusPrivacy('contacts');
await sock.updateReadReceiptsPrivacy('all'); // 'all', 'none'

---

🐛 Debugging

🔍 Enable debug mode to see all WhatsApp communications:

const sock = makeWASocket({
    logger: P({ level: 'debug' }),
});

🎯 Custom Event Handlers

// Listen for specific WebSocket events
sock.ws.on('CB:edge_routing', (node) => {
    console.log('📡 Edge routing message:', node);
});

// Listen with specific attributes
sock.ws.on('CB:edge_routing,id:abcd', (node) => {
    console.log('🎯 Specific edge routing message:', node);
});

---

💬 Support

🆘 Need Help?

📞 Direct Contact 6285358977442 WhatsApp Support

💬 Community WhatsApp Group Join our community

🐛 Bug Reports GitHub Issues Report Issues

---

🤝 Contributing

We welcome contributions! Here's how you can help:

graph LR
    A[🍴 Fork] --> B[🌟 Branch] 
    B --> C[💻 Code] 
    C --> D[📤 Push] 
    D --> E[🔄 PR]
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0
    style E fill:#fce4ec

Loading

1. 🍴 Fork the repository
2. 🌟 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💻 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔄 Open a Pull Request

---

📄 License

This project is licensed under the GPL v3 License - see the LICENSE file for details.

---

🙏 Acknowledgments

Special thanks to our amazing team and contributors who made this project possible:

👑 Owens Project Owner Lead Developer

🛠️ KyzRyzz Technical Support Community Management

🧪 Yousoo Development Support Testing & QA

💻 Valzy Development Base Source

🔧 Technical Credits

• Built with ❤️ using libsignal-node
• Special thanks to the WhatsApp Web reverse engineering community

---

⭐ Star this repo if it helped you!

---

📊 Project Stats

---

Made with 💻 and ☕ by the community

© 2025 Baileys WhatsApp API - Building the future of WhatsApp automation