{"_id":"@beenomjee/whatsapp-web.js","name":"@beenomjee/whatsapp-web.js","dist-tags":{"latest":"1.34.5-alpha.3"},"versions":{"1.34.5-alpha.3":{"name":"@beenomjee/whatsapp-web.js","version":"1.34.5-alpha.3","description":"Library for interacting with the WhatsApp Web API ","main":"./index.js","typings":"./index.d.ts","scripts":{"test":"mocha tests --recursive --timeout 5000","test-single":"mocha","shell":"node --experimental-repl-await ./shell.js","generate-docs":"npx jsdoc --configure .jsdoc.json --verbose"},"repository":{"type":"git","url":"git+https://github.com/pedroslopez/whatsapp-web.js.git"},"keywords":["whatsapp","whatsapp-web","api","bot","client","node"],"author":{"name":"Pedro Lopez"},"license":"Apache-2.0","bugs":{"url":"https://github.com/pedroslopez/whatsapp-web.js/issues"},"homepage":"https://wwebjs.dev/","dependencies":{"@pedroslopez/moduleraid":"^5.0.2","fluent-ffmpeg":"2.1.3","mime":"^3.0.0","node-fetch":"^2.6.9","node-webpmux":"3.1.7","puppeteer":"^24.31.0"},"devDependencies":{"@types/node-fetch":"^2.5.12","chai":"^4.3.4","chai-as-promised":"^7.1.1","dotenv":"^16.0.0","eslint":"^8.4.1","eslint-plugin-mocha":"^10.0.3","jsdoc":"^3.6.4","jsdoc-baseline":"^0.1.5","mocha":"^9.0.2","sinon":"^13.0.1"},"engines":{"node":">=18.0.0"},"optionalDependencies":{"archiver":"^5.3.1","fs-extra":"^10.1.0","unzipper":"^0.10.11"},"_id":"@beenomjee/whatsapp-web.js@1.34.5-alpha.3","gitHead":"c99d39d045d2396a06ac202fc184a1a9aaad22c3","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-Qn+cY45jocLasSJMaNpoj5W+0xLsu2HxcVpV0EWiA0MhNU/kHjpzivqj3IchEFit0QWBS/Xuppl+z50Jf/6qSQ==","shasum":"2635df1eec397a1e544e6501fac7103ec175242b","tarball":"https://registry.npmjs.org/@beenomjee/whatsapp-web.js/-/whatsapp-web.js-1.34.5-alpha.3.tgz","fileCount":56,"unpackedSize":479260,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH3PA2Ks6O2f26o1jNKKKEYKIUorqBJrYJXyciDDxfBXAiEA8F2zl9TjCy07QU5L8xSkLRI5xzT6eWO7opmOvpI/68o="}]},"_npmUser":{"name":"beenomjee","email":"beenomjee@gmail.com"},"directories":{},"maintainers":[{"name":"beenomjee","email":"beenomjee@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whatsapp-web.js_1.34.5-alpha.3_1768769649852_0.7103762835753393"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-18T20:54:09.751Z","1.34.5-alpha.3":"2026-01-18T20:54:10.007Z","modified":"2026-01-18T20:54:10.224Z"},"maintainers":[{"name":"beenomjee","email":"beenomjee@gmail.com"}],"description":"Library for interacting with the WhatsApp Web API ","homepage":"https://wwebjs.dev/","keywords":["whatsapp","whatsapp-web","api","bot","client","node"],"repository":{"type":"git","url":"git+https://github.com/pedroslopez/whatsapp-web.js.git"},"author":{"name":"Pedro Lopez"},"bugs":{"url":"https://github.com/pedroslopez/whatsapp-web.js/issues"},"license":"Apache-2.0","readme":"<div align=\"center\">\r\n    <br />\r\n    <p>\r\n        <a href=\"https://wwebjs.dev\"><img src=\"https://github.com/wwebjs/assets/blob/main/Collection/GitHub/wwebjs.png?raw=true\" title=\"whatsapp-web.js\" alt=\"WWebJS Website\" width=\"500\" /></a>\r\n    </p>\r\n    <br />\r\n    <p>\r\n\t\t<a href=\"https://www.npmjs.com/package/whatsapp-web.js\"><img src=\"https://img.shields.io/npm/v/whatsapp-web.js.svg\" alt=\"npm\" /></a>\r\n        <a href=\"https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765\"><img src=\"https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg\" alt=\"Depfu\" /></a>\r\n        <img src=\"https://img.shields.io/badge/WhatsApp_Web-2.3000.1017054665-brightgreen.svg\" alt=\"WhatsApp_Web 2.2346.52\" />\r\n        <a href=\"https://discord.gg/H7DqQs4\"><img src=\"https://img.shields.io/discord/698610475432411196.svg?logo=discord\" alt=\"Discord server\" /></a>\r\n\t</p>\r\n    <br />\r\n</div>\r\n\r\n## About\r\n**A WhatsApp API client that operates via the WhatsApp Web browser.**\r\n\r\nThe library launches the WhatsApp Web browser app via Puppeteer, accessing its internal functions and creating a managed instance to reduce the risk of being blocked. This gives the API client nearly all WhatsApp Web features for dynamic use in a Node.js application.\r\n\r\n> [!IMPORTANT]\r\n> **It is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.**\r\n\r\n## Links\r\n\r\n* [GitHub][gitHub]\r\n* [Guide][guide] ([source][guide-source])\r\n* [Documentation][documentation] ([source][documentation-source])\r\n* [Discord Server][discord]\r\n* [npm][npm]\r\n\r\n## Installation\r\n\r\nThe module is available on [npm][npm] via `npm i whatsapp-web.js`!\r\n\r\n> [!NOTE]\r\n> **Node ``v18`` or higher, is required.**  \r\n> See the [Guide][guide] for quick upgrade instructions.\r\n\r\n## Example usage\r\n\r\n```js\r\nconst { Client } = require('whatsapp-web.js');\r\n\r\nconst client = new Client();\r\n\r\nclient.on('qr', (qr) => {\r\n    // Generate and scan this code with your phone\r\n    console.log('QR RECEIVED', qr);\r\n});\r\n\r\nclient.on('ready', () => {\r\n    console.log('Client is ready!');\r\n});\r\n\r\nclient.on('message', msg => {\r\n    if (msg.body == '!ping') {\r\n        msg.reply('pong');\r\n    }\r\n});\r\n\r\nclient.initialize();\r\n```\r\n\r\nTake a look at [example.js][examples] for another examples with additional use cases.  \r\nFor further details on saving and restoring sessions, explore the provided [Authentication Strategies][auth-strategies].\r\n\r\n\r\n## Supported features\r\n\r\n| Feature  | Status |\r\n| ------------- | ------------- |\r\n| Multi Device  | ✅  |\r\n| Send messages  | ✅  |\r\n| Receive messages  | ✅  |\r\n| Send media (images/audio/documents)  | ✅  |\r\n| Send media (video)  | ✅ [(requires Google Chrome)][google-chrome]  |\r\n| Send stickers | ✅ |\r\n| Receive media (images/audio/video/documents)  | ✅  |\r\n| Send contact cards | ✅ |\r\n| Send location | ✅ |\r\n| Send buttons | ❌  [(DEPRECATED)][deprecated-video] |\r\n| Send lists | ❌  [(DEPRECATED)][deprecated-video] |\r\n| Receive location | ✅ | \r\n| Message replies | ✅ |\r\n| Join groups by invite  | ✅ |\r\n| Get invite for group  | ✅ |\r\n| Modify group info (subject, description)  | ✅  |\r\n| Modify group settings (send messages, edit info)  | ✅  |\r\n| Add group participants  | ✅  |\r\n| Kick group participants  | ✅  |\r\n| Promote/demote group participants | ✅ |\r\n| Mention users | ✅ |\r\n| Mention groups | ✅ |\r\n| Mute/unmute chats | ✅ |\r\n| Block/unblock contacts | ✅ |\r\n| Get contact info | ✅ |\r\n| Get profile pictures | ✅ |\r\n| Set user status message | ✅ |\r\n| React to messages | ✅ |\r\n| Create polls | ✅ |\r\n| Channels | ✅ |\r\n| Vote in polls | 🔜 |\r\n| Communities | 🔜 |\r\n\r\nSomething missing? Make an issue and let us know!\r\n\r\n## Contributing\r\n\r\nFeel free to open pull requests; we welcome contributions! However, for significant changes, it's best to open an issue beforehand. Make sure to review our [contribution guidelines][contributing] before creating a pull request. Before creating your own issue or pull request, always check to see if one already exists!\r\n\r\n## Supporting the project\r\n\r\nYou can support the maintainer of this project through the links below\r\n\r\n- [Support via GitHub Sponsors][gitHub-sponsors]\r\n- [Support via PayPal][support-payPal]\r\n- [Sign up for DigitalOcean][digitalocean] and get $200 in credit when you sign up (Referral)\r\n\r\n## Disclaimer\r\n\r\nThis project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at [whatsapp.com][whatsapp]. \"WhatsApp\" as well as related names, marks, emblems and images are registered trademarks of their respective owners. Also it is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.\r\n\r\n## License\r\n\r\nCopyright 2019 Pedro S Lopez  \r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");  \r\nyou may not use this project except in compliance with the License.  \r\nYou may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.  \r\n\r\nUnless required by applicable law or agreed to in writing, software  \r\ndistributed under the License is distributed on an \"AS IS\" BASIS,  \r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  \r\nSee the License for the specific language governing permissions and  \r\nlimitations under the License.  \r\n\r\n\r\n[guide]: https://guide.wwebjs.dev/guide\r\n[guide-source]: https://github.com/wwebjs/wwebjs.dev/tree/main\r\n[documentation]: https://docs.wwebjs.dev/\r\n[documentation-source]: https://github.com/pedroslopez/whatsapp-web.js/tree/main/docs\r\n[discord]: https://discord.gg/H7DqQs4\r\n[gitHub]: https://github.com/pedroslopez/whatsapp-web.js\r\n[npm]: https://npmjs.org/package/whatsapp-web.js\r\n[nodejs]: https://nodejs.org/en/download/\r\n[examples]: https://github.com/pedroslopez/whatsapp-web.js/blob/master/example.js\r\n[auth-strategies]: https://wwebjs.dev/guide/creating-your-bot/authentication.html\r\n[google-chrome]: https://wwebjs.dev/guide/creating-your-bot/handling-attachments.html#caveat-for-sending-videos-and-gifs\r\n[deprecated-video]: https://www.youtube.com/watch?v=hv1R1rLeVVE\r\n[gitHub-sponsors]: https://github.com/sponsors/pedroslopez\r\n[support-payPal]: https://www.paypal.me/psla/\r\n[digitalocean]: https://m.do.co/c/73f906a36ed4\r\n[contributing]: https://github.com/pedroslopez/whatsapp-web.js/blob/main/CODE_OF_CONDUCT.md\r\n[whatsapp]: https://whatsapp.com\r\n","readmeFilename":"README.md","_rev":"1-5a35c3b298a7310a9058406a471d3a12"}