\n
![\"Header](\"https://capsule-render.vercel.app/api?type=waving&height=220&color=0:ff6b6b,40:f06595,100:845ef7&text=ishumdz-bail&fontAlignY=40&fontSize=44&fontColor=ffffff&desc=Stable%20WhatsApp%20Web%20API%20Fork%20for%20Production%20Bots&descAlignY=60&descSize=16\")
\n\n
\n\n\n
\n \n ![\"WhatsApp](\"https://i.postimg.cc/9Q6q2Pv6/IMG-20260925-WA4965.jpg\")
\n \n\n\n
\n\n\n# 🧑💻 ishumdz-bail\n\n
\n ![](\"https://img.shields.io/badge/Node.js-%3E%3D20-339933?style=for-the-badge&logo=nodedotjs&logoColor=white\")
\n ![](\"https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white\")
\n ![](\"https://img.shields.io/badge/WebSocket-010101?style=for-the-badge&logo=socketdotio&logoColor=white\")
\n ![](\"https://img.shields.io/badge/Open%20Source-FF4500?style=for-the-badge&logo=github&logoColor=white\")
\n ![](\"https://img.shields.io/badge/license-MIT-blue?style=for-the-badge\")
\n
\n\n
\n ![](\"https://img.shields.io/npm/v/ishumdz-bail?style=flat-square&color=25D366&label=npm\")
\n ![](\"https://img.shields.io/badge/maintained%20by-Lovely-black?style=flat-square\")
\n
\n\n**Open-source WhatsApp automation library — no browser required.**\nBuilt on WebSocket for speed, stability, and full multi-device support.\n\n
\n\n[Installation](#-getting-started) • [Features](#-main-features) • [Stability](#-stability--disconnect-handling) • [Website](https://ishanx-pro.site.je) • [WhatsApp Channel](https://shyracore.indevs.in)\n\n
\n\n### ⭐ If this project helped you, consider giving it a star!\n\nMade with ❤️ by **Lovely**\n\n
\n\n---\n\n## 🚀 Hosting / Troubleshooting (OptikLink, Pterodactyl, etc.)\n\nIf `npm install` fails on bot hosting panels (OptikLink, Pterodactyl, etc.), these are\nthe most common reasons:\n\n### ❌ `npm error code EALLOWGIT`\n\n```\nnpm error Fetching packages of type \"git\" have been disabled\nnpm error Refusing to fetch \"libsignal@git+ssh://git@github.com/...\"\n```\n\n**Reason:** npm v12+ (and most bot hosts) disable `git:`-type package fetches by default.\nOlder ishumdz-bail versions (< 1.0.20) used `\"libsignal\": \"github:tenka-san/libsignal-node\"`\nas a dependency — hosts that block git fetches refuse to install it.\n\n**Fix:** use **ishumdz-bail v1.0.20 or later** — libsignal is now pulled from the\nnpm registry (`libsignal-node`), no git fetch needed:\n\n```bash\nnpm install ishumdz-bail@latest\n```\n\nIf you must stay on an older version and your host allows it, enable git fetching:\n\n```bash\nnpm config set allow-git=all\n```\n\n### ❌ `Error: Cannot find module 'dotenv'`\n\nThis error comes from **your bot's `index.js`**, not from the library — your bot code\ndoes `require('dotenv')` but `dotenv` is not in the bot's `package.json` dependencies.\n\n**Fix:** add it and reinstall:\n\n```bash\nnpm install dotenv\n```\n\n### ✅ Deploy checklist for restricted hosts\n\n1. `ishumdz-bail` **v1.0.20+** in `package.json` (no git deps inside)\n2. `dotenv` (and every other module your bot requires) listed in your **bot's** `package.json`\n3. Run `npm install` from the bot folder (not global), then `npm start`\n4. If the host still blocks git deps, check `npm ls` output for any `github:` entries\n\n---\n\n## 📄 License\n\nMIT\n\n---\n\n## 📱 Full Feature Overview\n\n```\n╔═══════════════════════════════════════════════════════════════════════════╗\n║ 📱 MAIN FEATURES ║\n╠═══════════════════════════════════════════════════════════════════════════╣\n║ ║\n║ ┌─────────────────────────────────────────────────────────────────────┐ ║\n║ │ 🎮 GAMES │ 📞 VOIP CALLER │ ⚡ PRO METHODS │ ║\n║ │ ├─ Blackjack │ ├─ Auto Answer │ ├─ sendPoll │ ║\n║ │ ├─ Slots │ ├─ Audio Playback │ ├─ sendPollVote │ ║\n║ │ ├─ Dice │ └─ VoipClient │ ├─ editMessage │ ║\n║ │ ├─ Coin Flip │ │ ├─ deleteMessage │ ║\n║ │ ├─ Roulette │ 📊 POLLS │ ├─ pinMessage │ ║\n║ │ ├─ Mines │ ├─ Create Poll │ ├─ starMessage │ ║\n║ │ ├─ Trivia │ ├─ Vote Poll │ ├─ reactMessage │ ║\n║ │ ├─ RPS │ └─ Get Results │ ├─ sendPresence │\n║ │ └─ +6 HTML Games │ │ │ ║\n║ └─────────────────────────────────────────────────────────────────────┘ ║\n║ ║\n║ ┌─────────────────────────────────────────────────────────────────────┐ ║\n║ │ 📢 NEWSLETTER │ 🟢 STATUS │ 💬 CHAT │ ║\n║ │ ├─ channelVote │ ├─ sendText │ ├─ editMessage │ ║\n║ │ ├─ newsletterReact │ ├─ sendMedia │ ├─ deleteMessage │ ║\n║ │ ├─ getMessages │ ├─ readStatus │ ├─ pinMessage │ ║\n║ │ ├─ searchChannels │ └─ reactStatus │ ├─ unpinMessage │ ║\n║ │ └─ listChannels │ │ ├─ starMessage │ ║\n║ └─────────────────────────────────────────────────────────────────────┘ ║\n║ ║\n║ ┌─────────────────────────────────────────────────────────────────────┐ ║\n║ │ 👥 GROUPS │ 👤 PROFILE │ 📰 MEDIA │ ║\n║ │ ├─ Get Invite Info │ ├─ checkNumber │ ├─ Newsletter Paths │ ║\n║ │ ├─ Join via Invite │ ├─ setBio │ ├─ Image Upload │ ║\n║ │ ├─ Set Announcement │ ├─ updateName │ ├─ Video Upload │ ║\n║ │ ├─ Set Locked │ ├─ setProfilePic │ ├─ Audio Upload │ ║\n║ │ ├─ Request List │ ├─ removeProfilePic │ ├─ Document Upload │ ║\n║ │ ├─ Approve │ └─ rejectCall │ └─ Sticker Upload │ ║\n║ │ └─ Reject │ │ │ ║\n║ └─────────────────────────────────────────────────────────────────────┘ ║\n║ ║\n║ ✅ No Browser Required ✅ Multi-Device ✅ WebSocket Based ║\n║ ✅ Active Maintenance ✅ MIT License ✅ Full API Coverage ║\n║ ║\n╚═══════════════════════════════════════════════════════════════════════════╝\n```\n","readmeFilename":"README.md"}