WORDBOT
Your own WhatsApp bot in 15 lines
Free and open source. Scan the QR code with your phone and it answers messages for you.
Checked by the Ninja on Nov 4, 2026Pick your way
Free or with the Ninja Agent?
FreeUS$ 0You do it yourself
Ninja AgentUS$ 4.99Coming soon
The bot
The official example: replies “pong” when someone sends “!ping”
Replies your way: greeting, menu, prices, address and hours
Security
You're on your own
The Ninja checks all 195 pieces before installing, one by one, by their fingerprint
Install
You copy and paste the commands
Step by step, in a chat. In Claude Code or Codex, the Ninja runs the commands for you
Got an error?
You google it
Paste the error in the chat: the Ninja explains it and tells you what to do
Known traps
On Node 26, the bot's Chrome installs half-way, silently
Already solved: the Ninja downloads the full Chrome and checks it
Your business
—
8 questions about your business become the bot's answers
Before going live
Straight onto your number
A simulator: chat with the bot on your computer first
Your number
Replies instantly, no limits
Waits like a person, 10 replies a minute at most, and goes quiet when you take over
QR code
Every time you start it
Only the first time
Ninja Dojo
You join on your own
The Ninja puts your bot there, with a Story-ready image
Not for sale yet
What the Ninja checked
Safe to try, with care- ✓Apache-2.0 license: free to use, even commercially
- ✓Alive: around since 2019, last updated Nov 1, 2026
- ✓22.8K stars and 5.2K forks on GitHub
- !Not official: the project itself warns your number can get banned
- !It downloads its own Chrome on install (that's how it runs WhatsApp Web in the background)
- !npm audit: 17 warnings (11 high, 6 moderate), none critical, all in third-party pieces. The Ninja Agent explains each one
See the project on GitHub ↗Source: the repository itself, on the day it was checked.
Free
The code, in 3 steps
Install Node.js 24
Use version 24 (LTS). On 26, the newest, the Chrome the bot downloads comes in half-way and it won't start (tested by the Ninja on Nov 4, 2026). Get it at nodejs.org and pick v24.
Install the bot
Make a new folder, open your terminal in it and run:
Terminalnpm install whatsapp-web.js qrcode-terminal
Create bot.js and run it
Save this file in the folder as
bot.jsand runnode bot.js. It's the project's official example, untouched.bot.jsconst { Client } = require('whatsapp-web.js'); const qrcode = require('qrcode-terminal'); const client = new Client(); client.on('qr', (qr) => { qrcode.generate(qr, { small: true }); }); client.on('ready', () => { console.log('Client is ready!'); }); client.on('message', (msg) => { if (msg.body == '!ping') { msg.reply('pong'); } }); client.initialize();See a QR code in your terminal? On the spare phone, open WhatsApp › Linked devices › Link a device. Once it prints
Client is ready!, text!pingfrom another number and it repliespong. To change the reply, edit'!ping'and'pong'in the code.
The safe way to test it
- Use a spare SIM. A number just for the bot, never your business or personal one.
- Only reply to people who message first. Bulk messages and texting strangers is what usually gets numbers banned.
- It only runs while your computer is on. Close the terminal and the bot stops.
- For real customers, the risk-free route is WhatsApp's official API, which charges per conversation.