# WAHA

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

- Page: https://cgt.octabyte.io/templates/waha/
- Category: Customers & sales
- Replaces: WhatsApp Business API
- Ease of use: Some setup. You sign in to the dashboard, connect it with the API key Cloudgate shows, start a session and scan its QR code with WhatsApp on your phone.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: Apache-2.0
- Good for: Small businesses and developers wiring WhatsApp into their own tools, who accept the ban risk
- Official website: https://waha.devlike.pro
- Documentation: https://waha.devlike.pro/docs/overview/introduction/
- Source code: https://github.com/devlikeapro/waha
- Last updated: 2026-11-20

## 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?

Deploy link: https://cloudgate.octabyte.app/get-started?template=waha

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. **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. **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. **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.

## 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.
