WAHA

Send and receive WhatsApp messages from your own apps, unofficially.

Replaces WhatsApp Business API Some setup Free app

No server needed to start: Cloudgate can provide one. What happens when you click Deploy

WAHA
The WAHA dashboard in a dark theme, with cards for 3 sessions, 1 connected worker and an up-to-date notice, a workers table showing the server, its engine and version, and a sessions table listing a bookings session tagged team=front-desk and a default session, both stopped, with buttons to start, restart, stop, log out and delete
The dashboard: your WAHA server and each WhatsApp number it runs. Captured by Cloudgate, with sample data
The WAHA session settings window for a session named bookings, with the server, name, a custom device option, engine settings that store messages, chats, contacts, groups and labels, and a metadata table with team set to front-desk
Settings for one WhatsApp session, including your own tags. Captured by Cloudgate, with sample data
WAHA's built-in API documentation, Chatting section, listing endpoints to send a text, image, file, voice message, video, sticker, link preview and list message, to forward, mark as seen, show typing, react with an emoji and star a message
The built-in API documentation, with every message type you can send. Captured by Cloudgate, with sample data

What is WAHA?

Self-hosted WAHA: an unofficial WhatsApp HTTP API to send and receive messages from your apps, webhooks and n8n. WhatsApp can ban numbers.

WAHA (WhatsApp HTTP API) is free, self-hosted software that lets your own apps send and receive WhatsApp messages, as a low-cost alternative to the WhatsApp Business API and providers such as Twilio. It is unofficial: it links to your number as a WhatsApp Web device, and WhatsApp can ban a number used this way.

You scan a QR code once with WhatsApp on your phone, and from then on your website, CRM, help desk or automation can send texts, pictures, files and voice notes, and receive replies through webhooks. A bike repair shop, for example, could text customers automatically when their bike is ready and collect the replies in its shared inbox, with no fee per message.

WAHA is a building block rather than a chat app. It works with n8n workflows, the Chatwoot shared inbox and Typebot chatbots, and its documented API can be called from any programming language. Use a spare number to test it, and message only people who expect to hear from you.

Cloudgate installs WAHA on a server Cloudgate provides or one you connect and gives it a secure web address, protected by a dashboard password and an API key. Open the dashboard, start a session and scan the QR code to link your number.

What you can do with WAHA

  • Send messages from your apps Send texts, images, files, videos and voice notes to WhatsApp chats and groups through a simple web API.
  • Get incoming messages Webhooks pass every new message and event to your website, CRM, help desk or automation.
  • Link a number with a QR code Connect an ordinary WhatsApp or WhatsApp Business app number by scanning a QR code, as you would for WhatsApp Web.
  • Run several numbers Connect more than one WhatsApp number on the same server and manage each one separately.
  • Manage it from a dashboard Start and stop sessions, scan QR codes and tag each number in a web dashboard.
  • Groups, channels and status Create and manage groups, and post to WhatsApp Channels and Status from your own tools.
  • Works with n8n and Chatwoot Plug it into n8n workflows, a Chatwoot shared inbox or a Typebot chatbot, or call the documented API from any language.

Replaces WhatsApp Business API

WAHA does the same job as WhatsApp Business API. Here is what changes when you switch.

What you gain
  • No fee per message or conversation, and no message templates to get approved
  • Uses the WhatsApp number you already have, linked in a minute
  • Messages and media stay on your server
  • Every feature is free, including several numbers on one server
What is different
  • It is unofficial, and WhatsApp can ban a number used this way
  • No official business verification, green tick or Meta support
  • A WhatsApp update can break it until WAHA catches up
  • It is an API, so you need another tool or some code to use it

What happens when you click Deploy?

You do not need a server or any technical knowledge. Four steps, and WAHA is running at its own web address.

  1. Step 1 Click Deploy and create your account

    Deploy takes you to Cloudgate. Create an account, or log in if you have one. WAHA itself is free.

  2. Step 2 Choose a server

    No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.

  3. Step 3 Cloudgate sets up WAHA

    It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.

  4. Step 4 Open your app and sign in

    Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

Run Cloudgate yourself? Deploy from your own console

In your Cloudgate console, open Templates and choose WAHA.

Questions

Is WAHA an official WhatsApp API?

No. WAHA is not made by or connected to WhatsApp or Meta. It links to your account as a WhatsApp Web device, while the official route is Meta's WhatsApp Business Platform, sold directly or through providers such as Twilio.

Can WhatsApp ban my number if I use WAHA?

Yes. WhatsApp does not allow bots or unofficial clients, and WAHA's own site says it should not be considered totally safe. Bulk or unsolicited messages raise the risk most, so test with a spare number and only message people who expect to hear from you.

Is WAHA free?

Yes. WAHA is free and open source under the Apache 2.0 licence, and since mid-2026 the features of the former paid Plus version are in the free version too. You pay only for your server.

Is WAHA a good alternative to the WhatsApp Business API or Twilio?

Yes, WAHA suits internal tools, small volumes and testing, where no per-message fee and a quick QR setup matter most. For customer messaging at scale, approved templates, a verified business name or anything you cannot risk losing, the official WhatsApp Business API is the safer choice.

How do I connect my WhatsApp number to WAHA?

Open the WAHA dashboard, sign in with the username and password Cloudgate shows, connect with the API key, and start a session. Then scan the QR code with WhatsApp on your phone, under Settings, Linked devices.

Can WAHA work with n8n or Chatwoot?

Yes. WAHA has an n8n community node and works with Chatwoot and Typebot, and any tool that can call a web address and receive webhooks can use it.

How do I switch from the WhatsApp Business API to WAHA?

There is nothing to import. Start a session in the WAHA dashboard, scan its QR code from WhatsApp on the phone, point WAHA's webhook at your app and change your code to call WAHA's send endpoints. Test with a spare number first, because WhatsApp can ban a number used this way.

What server size does WAHA need?

A small server with 1 GB of memory is enough for one or a few WhatsApp numbers. Each extra number needs more memory, because WAHA runs a copy of WhatsApp Web for each one. The template runs on servers with Intel or AMD (x86) processors, not ARM.

Do I need technical skills to run WAHA?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up WAHA and gives it a web address. You use it in your browser like any other online tool.

Do I need my own server for WAHA?

No. When you deploy WAHA, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

WAHAFree app
Deploy WAHA