\n\n\n\n\n\n\n\n\n\n
\n\nWhatsApp Baileys is an open-source library designed to help developers build automation solutions and integrations with WhatsApp efficiently and directly. Using websocket technology without the need for a browser, this library supports a wide range of features such as message management, chat handling, group administration, as well as interactive messages and action buttons for a more dynamic user experience.\n\nActively developed and maintained, baileys continuously receives updates to enhance stability and performance. One of the main focuses is to improve the pairing and authentication processes to be more stable and secure. Pairing features can be customized with your own codes, making the process more reliable and less prone to interruptions.\n\nThis library is highly suitable for building business bots, chat automation systems, customer service solutions, and various other communication automation applications that require high stability and comprehensive features. With a lightweight and modular design, baileys is easy to integrate into different systems and platforms.\n\n---\n\n### Main Features and Advantages\n\n- Supports automatic and custom pairing processes\n- Fixes previous pairing issues that often caused failures or disconnections\n- Supports interactive messages, action buttons, and dynamic menus\n- Efficient automatic session management for reliable operation\n- Compatible with the latest multi-device features from WhatsApp\n- Lightweight, stable, and easy to integrate into various systems\n- Suitable for developing bots, automation, and complete communication solutions\n- Comprehensive documentation and example codes to facilitate development\n\n---\n\n## Getting Started\n\nBegin by installing the library via your preferred package manager, then follow the provided configuration guide. You can also utilize the ready-made example codes to understand how the features work. Use session storage and interactive messaging features to build complete, stable solutions tailored to your business or project needs.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Install](#install)\n- [Quick Start](#quick-start)\n - [QR Code login](#login-with-qr-code)\n - [Pairing Code login](#login-with-pairing-code)\n- [Store](#store)\n- [Sending Messages](#sending-messages)\n - [Generic send / relay](#generic-send--relay)\n - [Simple senders](#simple-senders)\n - [Special message types](#special-message-types)\n- [Events](#events)\n- [Examples](#examples)\n- [Known Limitations](#known-limitations)\n- [Why Choose WhatsApp Baileys?](#why-choose-whatsapp-baileys?)\n- [Technical Notes](#technical-notes)\n- [Contact Developer](#contact-developer)\n- [Contributors](#contributors-outside-the-baileys-code)\n\n## Requirements\n\n- Node.js **>= 20**\n- Optional peer deps depending on the features you use: `sharp` or `jimp` (image processing), `link-preview-js` (link previews), `audio-decode` (audio waveform)\n\n## Install\n\n```bash\nnpm install @alannxd/baileys\n```\n\nOr alias it as `baileys` / `@whiskeysockets/baileys` in your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@alannxd/baileys\": \"latest\"\n }\n}\n```\n\n```js\nimport makeWASocket from '@alannxd/baileys'\n// or, CommonJS:\nconst { default: makeWASocket } = require('@alannxd/baileys')\n```\n\n## Quick Start\n\n### Login with QR Code\n\n```js\nimport makeWASocket, { Browsers, useMultiFileAuthState } from '@alannxd/baileys'\n\nconst { state, saveCreds } = await useMultiFileAuthState('auth_info')\n\nconst client = makeWASocket({\n browser: Browsers.ubuntu('Chrome'),\n printQRInTerminal: true,\n auth: state\n})\n\nclient.ev.on('creds.update', saveCreds)\n```\n\n### Login with Pairing Code\n\n```js\nimport makeWASocket, { Browsers, fetchLatestWAWebVersion, useMultiFileAuthState } from '@alannxd/baileys'\n\nconst { state, saveCreds } = await useMultiFileAuthState('auth_info')\nconst { version } = await fetchLatestWAWebVersion()\n\nconst client = makeWASocket({\n browser: Browsers.ubuntu('Chrome'),\n printQRInTerminal: false,\n version,\n auth: state\n})\n\nclient.ev.on('creds.update', saveCreds)\n\nif (!client.authState?.creds?.registered) {\n const phoneNumber = '628XXXXXXXXXX' // international format, no '+'\n const code = await client.requestPairingCode(phoneNumber)\n // custom pairing code (8 characters):\n // const code = await client.requestPairingCode(phoneNumber, 'YYYYYYYY')\n console.log('Pairing code:', code)\n}\n```\n\n## Store\n\n`makeInMemoryStore` builds a local cache of chats/contacts/messages, which\nBaileys does not persist automatically by default.\n\n```js\nimport makeWASocket, { makeInMemoryStore } from '@alannxd/baileys'\nimport pino from 'pino'\n\nconst store = makeInMemoryStore({\n logger: pino().child({ level: 'silent', stream: 'store' })\n})\n\nconst client = makeWASocket({ /* ...other options */ })\nstore.bind(client.ev)\n\nclient.ev.on('contacts.upsert', () => {\n console.log('New contact:', Object.values(store.contacts))\n})\n```\n\nNeed a persistent store (Redis, etc.)? Use `makeCacheManagerStore` — see [API Reference](docs/API.md#store-libstore).\n\n### Saving the store to a file\n\n`makeInMemoryStore` can read/write its state to a local JSON file, so it\nsurvives restarts without needing an external database:\n\n```js\nconst store = makeInMemoryStore({ /* ... */ })\n\n// load once on startup, then auto-save every 10s\nconst stopAutoSave = store.writeToFileInterval('./store.json')\n\nprocess.on('SIGINT', () => {\n stopAutoSave()\n process.exit(0)\n})\n```\n\nOr handle it manually with `store.readFromFile(path)` / `store.writeToFile(path)` — see [API Reference](docs/API.md#file-persistence-makeinmemorystore) for details.\n\n## Sending Messages\n\n### Generic send / relay\n\n```js\n// relayMessage — send a raw message object, bypassing the sendMessage pipeline\nawait client.relayMessage(jid, { conversation: 'Hello from Baileys' }, {})\n\n// sendMessage — the common way to send a message\nawait client.sendMessage(jid, { text: 'Hello from Baileys' })\n```\n\n### Simple senders\n\nAll the `sendX` functions below are shortcuts on top of `sendMessage`.\n\n```js\nawait client.sendText(jid, 'Hi!', { contextInfo: { mentionedJid: [jid] } })\nawait client.sendImage(jid, { url: './photo.jpg' }, 'image caption')\nawait client.sendVideo(jid, { url: './clip.mp4' }, 'video caption')\nawait client.sendAudio(jid, { url: './clip.mp3' })\nawait client.sendLocation(jid, 'Location name', -6.2, 106.8, 'https://maps.example', '1234567890')\nawait client.sendPoll(jid, 'Pick one', ['Option 1', 'Option 2', 'Option 3'], /* multiSelect */ true)\nawait client.sendQuiz(jid, 'Correct answer?', ['1', '2', '3'], /* correctIndex */ '2')\n```\n\n### Special message types\n\nHandled internally by the `Socket/luxu.js` helper, invoked automatically via\n`sendMessage`/`relayMessage` whenever the content includes one of the fields below.\n\n```js\n// Product message (catalog)\nawait client.relayMessage(jid, {\n productMessage: {\n title: 'Product Name',\n description: 'Product description',\n thumbnail: { url: './product.jpg' },\n productId: 'PRODUCT_ID',\n retailerId: 'RETAILER_ID',\n url: 'https://store.example/product',\n body: 'Body text',\n footer: 'Footer text',\n priceAmount1000: 72502, // price x 1000\n currencyCode: 'IDR'\n }\n}, {})\n\n// Order message\nawait client.sendMessage(jid, {\n thumbnail: fs.readFileSync('./thumb.jpg'),\n message: 'Order details',\n orderTitle: 'Store Name',\n totalAmount1000: 72502,\n totalCurrencyCode: 'IDR'\n}, { quoted: m })\n\n// Poll result snapshot (usually from a newsletter)\nawait client.sendMessage(jid, {\n pollResultMessage: {\n name: 'Poll Title',\n options: [{ optionName: 'Option 1' }, { optionName: 'Option 2' }],\n newsletter: { newsletterName: 'Newsletter Name', newsletterJid: '1234567890@newsletter' }\n }\n})\n\n// Interactive message (button)\nawait client.sendMessage(jid, {\n image: { url: './banner.jpg' },\n text: 'Message body',\n title: 'Title',\n footer: 'Footer',\n interactiveButtons: [{\n name: 'cta_url',\n buttonParamsJson: JSON.stringify({ display_text: 'Visit', url: 'https://example.com' })\n }]\n})\n\n// Group member label\nawait client.sendMessage(jid, {\n groupLabel: { labelText: 'Admin' }\n})\n\n// Broadcast to specific group members\nawait client.sendMessageMembers(jid, { extendedTextMessage: { text: 'Announcement' } }, {})\n```\n\n> Fields like `sender` and `participant: true` in the second argument of\n> `sendMessage`/`relayMessage` are used for group-participant send context — see\n> [`docs/API.md`](docs/API.md) for details on each socket layer.\n\n## Events\n\nAll interaction happens through events on `client.ev`:\n\n```js\nclient.ev.on('connection.update', ({ connection, lastDisconnect }) => {\n console.log('Connection status:', connection)\n})\n\nclient.ev.on('messages.upsert', ({ messages, type }) => {\n for (const m of messages) {\n console.log('Incoming message:', m.message)\n }\n})\n\nclient.ev.on('creds.update', saveCreds)\n```\n\nSee the full list of events in `lib/Types/Events.js`.\n\n## Examples\n\nReady-to-run scripts live in [`examples/`](examples):\n\n- [`examples/qr-login.js`](examples/qr-login.js) — QR login with auto-reconnect\n- [`examples/pairing-code.js`](examples/pairing-code.js) — pairing code login\n- [`examples/store-usage.js`](examples/store-usage.js) — using the in-memory store\n\n## Known Limitations\n\n- **No `.d.ts` for `lib/`** — only `WAProto` ships TypeScript types. Full autocomplete requires the TS source, which isn't included in this build.\n- **Console banner on import** — every time the package is `import`ed, an ASCII art banner and promotional link are printed to stdout. In production or multi-instance setups this becomes log noise.\n- **`optionHash` for per-option image polls** is not implemented — it appears to require further reverse-engineering at the WhatsApp APK level.\n- See [`docs/API.md`](docs/API.md#️-important-notes) for other technical notes.\n\n## Why Choose WhatsApp Baileys?\n\nBecause this library offers high stability, full features, and an actively improved pairing process. It is ideal for developers aiming to create professional and secure WhatsApp automation solutions. Support for the latest WhatsApp features ensures compatibility with platform updates.\n\n---\n\n### Technical Notes\n\n- Supports custom pairing codes that are stable and secure\n- Fixes previous issues related to pairing and authentication\n- Features interactive messages and action buttons for dynamic menu creation\n- Automatic and efficient session management for long-term stability\n- Compatible with the latest multi-device features from WhatsApp\n- Easy to integrate and customize based on your needs\n- Perfect for developing bots, customer service automation, and other communication applications\n- Has 1 newsletter follow, only the developer's WhatsApp channel: [WhatsApp Channel](https://whatsapp.com/channel/0029Vb3IiqTL7UVP9A9n0w1x)\n\n---\n\nFor complete documentation, installation guides, and implementation examples, please visit the official repository and community forums. We continually update and improve this library to meet the needs of developers and users of modern WhatsApp automation solutions.\n\n**Thank you for choosing WhatsApp Baileys as your WhatsApp automation solution!**\n\n\n---\n\n\n### Contact Developer\n\nFor questions, support, or collaboration, feel free to contact the developer:\n\n- **Telegram**: [Telegram Contact](https://t.me/alannxd)\n- **Channel WhatsApp**: [Channel WhatsApp](https://whatsapp.com/channel/0029Vb3IiqTL7UVP9A9n0w1x) \n\n### Contributors outside the Baileys code\n\nThanks to the following awesome contributors who help improve this project\n\n
![\"Thumbnail\"](\"https://img2.pixhost.to/images/9521/751472173_alan.jpg\")
\n![\"Developer\"/](\"https://github.com/alannzxd.png\")
\n ![\"Developer\"/](\"https://github.com/tenka-san.png\")
\n ![\"Contributor\"/](\"https://github.com/kiuur.png\")
\n ![\"Contributor\"/](\"https://github.com/Xcoursed.png\")
\n