How-To Guidebeginner2 minutes

How to Create a WhatsApp Bot

Step-by-step guide to creating your own WhatsApp bot with BotWave. No coding required. Connect in under 60 seconds.

BotWave converts your own WhatsApp number into a fully programmable bot in under two minutes. The bot runs from your device IP via the Baileys library, which is dramatically safer than the server-IP approach used by most paid WhatsApp bot services. This guide walks you through every screen you will see, from signup to your first !sticker command.

Prerequisites

  • A working WhatsApp account (regular or Business) installed on your phone.
  • A free BotWave account at botwave.online/signup.
  • About 2 minutes of uninterrupted time, pairing codes expire after 60 seconds.
  • WhatsApp version 2.23 or newer (older versions do not support the Link a Device flow with pairing codes).

Step-by-step instructions

  1. 1

    Sign up at botwave.online/signup

    Create a free account using your email. You will need to confirm the address via a link before you can connect a session.

    Tip: Use a different email from the one tied to the WhatsApp account you plan to connect, it keeps your recovery flows cleanly separated.

  2. 2

    Open the Sessions tab in the dashboard

    Click "Sessions" in the left sidebar and then "Connect WhatsApp". The pairing code modal will appear with a 60-second countdown.

  3. 3

    Open WhatsApp → Settings → Linked Devices

    On your phone, open WhatsApp, tap the three-dot menu, choose Settings, then Linked Devices, then Link a Device. Tap "Link with phone number instead" at the bottom of the QR screen.

    Tip: On iOS the option is called "Link with phone number"; on Android it is "Link a device with phone number".

  4. 4

    Enter the 8-character pairing code

    Type the code displayed in the BotWave dashboard. WhatsApp will pair the device and the dashboard will flip to "Connected" within 5-10 seconds.

  5. 5

    Send your first command

    Open any chat or group where the bot is allowed and type !help. The bot will reply with the full list of available commands.

    !help
  6. 6

    Add the bot to a group (optional)

    Add your bot number to a WhatsApp group like any other contact. The bot will start responding to commands in that group automatically.

Expected result

The Sessions tab in your dashboard shows a green "Connected" badge, and !help replies with a list of 50+ commands in any chat the bot is in.

Power-user tips

  • The session is tied to your phone, if you log out of WhatsApp Web everywhere, you lose the BotWave session too.
  • Free tier ships with all 150+ commands enabled, but caps you at 300 messages/month. Upgrade is needed only if you cross that limit.
  • You can disable individual commands per session from Dashboard → Settings → Commands.
  • For best anti-ban behaviour, leave the default session warmup on for the first 7 days (15 → 200 msgs/day ramp).

Common pitfalls

  • Do not connect the same WhatsApp number from two different BotWave sessions, WhatsApp only allows one Linked Device entry per session and the older one will be silently killed.
  • Pairing codes expire after 60 seconds; if you miss the window, click "Regenerate code" instead of typing the old one.
  • Avoid pairing on a number that is brand-new (<24 hours old), WhatsApp aggressively rate-limits new accounts and the session may get banned within minutes.

Frequently asked questions

Do I need to be a developer to create a WhatsApp bot with BotWave?

No. BotWave is no-code from end to end, you sign up, paste a pairing code, and start using commands. There is no JavaScript, Python, or webhook configuration required. Developers who want webhooks and a REST API can opt into them from the Boss plan.

Is BotWave the same as a WhatsApp Business API account?

No. BotWave runs on a regular WhatsApp (or WhatsApp Business app) account via the Baileys library, it is a Linked Device, the same way WhatsApp Web is a Linked Device. The official WhatsApp Business API (Cloud API) requires a Meta-approved business account, a phone number not used in the consumer app, and is billed per conversation. BotWave is faster to set up and free to start; the Business API is the right choice if you need broadcast-template messaging at scale.

Will my WhatsApp number get banned for using BotWave?

WhatsApp can ban any automation, but BotWave applies a multi-layer anti-ban system specifically designed to look human: session warmup (15→200 msgs/day over 7 days), randomised typing and read receipts, message variation, presence simulation, and quiet-hours throttling. Following the on-boarding warmup period and avoiding bulk outbound to non-opted-in numbers keeps risk low, most BotWave users go years without a ban.

How long does the initial setup take?

About two minutes end-to-end if WhatsApp is already installed on your phone. The slowest step is usually finding "Link a Device" in WhatsApp Settings.

Can I use BotWave with WhatsApp Business?

Yes. The WhatsApp Business consumer app uses the same protocol as regular WhatsApp for Linked Devices, so pairing works identically. Note that this is the Business *app* (free, mobile-only), not the Business *API* (paid, Meta-approved).

Ready to put this into practice?

Create your free BotWave account and connect a session in under 2 minutes.

Get started free