OpenWA
A self-hosted WhatsApp API for your own apps, unofficial.
No server needed to start: Cloudgate can provide one. What happens when you click Deploy
What is OpenWA?
OpenWA is a free, self-hosted WhatsApp API gateway that sends and receives messages from your own apps. Unofficial: WhatsApp can ban the number.
OpenWA is a free, open-source, self-hosted WhatsApp API gateway that lets your own apps send and receive WhatsApp messages, as a low-cost alternative to the WhatsApp Business API. It is unofficial: it links to your number as a WhatsApp Web device, and WhatsApp can restrict or ban a number used this way.
You scan a QR code once with WhatsApp on your phone, and from then on your website, CRM or automation can send texts, pictures and documents and receive replies through webhooks. A bakery, for example, could message customers "your order is ready to collect" from a saved template and answer "what are your opening hours?" with an automatic reply, with no fee per message.
OpenWA is a building block rather than a chat app. It works with n8n, Chatwoot and Typebot, and its documented API can be called from any language. It is a separate project from the older open-wa (wa-automate) library. Test with a spare number, and message only people who expect to hear from you.
Cloudgate installs OpenWA on a server Cloudgate provides or one you connect, gives it a secure web address and protects it with an admin key. Sign in, add a session and scan the QR code to link your number.
What you can do with OpenWA
- Send and receive messages Send texts, pictures, videos, documents, voice notes, reactions and bulk messages through a web API, and see when they are delivered and read.
- Several numbers on one server Link more than one WhatsApp number, each with its own QR code, and manage them side by side.
- Webhooks for every reply Pass incoming messages and events to your website, CRM or automation, signed so your app can check they came from OpenWA, and filtered to the chats you care about.
- Message templates and auto-replies Save reusable messages with blanks such as a customer's name, and set simple rules that answer common questions automatically.
- Keys limited to chosen chats Give each app or AI assistant its own key that can only read, send or manage what you allow, down to a few chats on one number.
- A dashboard in 15 languages Manage numbers, chats, webhooks, templates, keys and plugins from a web dashboard, and send test messages without writing code.
- Works with n8n and Chatwoot Use the n8n nodes, the Chatwoot and Typebot plugins or ready-made code libraries for JavaScript, Python, Go, Java and PHP.
Replaces WhatsApp Business API
OpenWA does the same job as WhatsApp Business API. Here is what changes when you switch.
- No fee per message and no message templates to get approved by Meta
- Uses a WhatsApp number you already have, linked with a QR code
- Messages and media stay on your server
- Every feature is free under the MIT licence, with no paid edition
- It is unofficial, and WhatsApp can restrict or ban a number used this way
- No verified business name, green tick or Meta support
- A WhatsApp change can break it until OpenWA is updated
- It is a building block, so you need another tool or some code to use it fully
What happens when you click Deploy?
You do not need a server or any technical knowledge. Four steps, and OpenWA is running at its own web address.
- Step 1 Click Deploy and create your account
Deploy takes you to Cloudgate. Create an account, or log in if you have one. OpenWA itself is free.
- 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.
- Step 3 Cloudgate sets up OpenWA
It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
- 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.
New to Cloudgate? See what Cloudgate is
Run Cloudgate yourself? Deploy from your own console
In your Cloudgate console, open Templates and choose OpenWA.
Questions
Is OpenWA the same as open-wa or wa-automate?
No. OpenWA by Yudhi Armyndharis (rmyndharis) is a complete WhatsApp API gateway with a dashboard, under the MIT licence. open-wa, also called wa-automate, is an older, separate code library by another developer, under a different licence and with paid licence keys for some features.
Can WhatsApp ban my number if I use OpenWA?
Yes. OpenWA is not made by or connected to WhatsApp or Meta, and its own guide says there is always some risk that a number gets restricted or banned. Use a separate number you can afford to lose, warm a new number up slowly, and only message people who expect to hear from you. OpenWA cannot unban a number.
Is OpenWA free?
Yes. OpenWA is free and open source under the MIT licence, with no paid edition and no locked features. You pay only for your server.
Is OpenWA a good alternative to the WhatsApp Business API?
Yes for internal tools, alerts, order updates and small volumes, where no per-message fee and a quick QR setup matter most. For healthcare, finance, large-scale customer messaging or anything you cannot risk losing, OpenWA's own guide recommends Meta's official WhatsApp Cloud API instead.
How do I sign in to OpenWA and connect my WhatsApp number?
Sign in to the OpenWA dashboard with the admin key Cloudgate shows for the app. Then add a session, start it and scan its QR code with WhatsApp on your phone, under Settings, Linked devices.
Does OpenWA work with n8n, Chatwoot or AI assistants?
Yes. OpenWA has n8n nodes, Chatwoot and Typebot plugins, and an optional connection for AI assistants such as Claude, which is read-only unless you allow sending. Any tool that can call a web address and receive webhooks can use it too.
What server size does OpenWA need?
About 2 GB of memory suits OpenWA with one or a few WhatsApp numbers, since each number runs its own copy of WhatsApp Web, using roughly 300 to 500 MB. Add memory as you add numbers. It runs on Intel, AMD and ARM servers.
Do I need technical skills to run OpenWA?
No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up OpenWA and gives it a web address. You use it in your browser like any other online tool.
Do I need my own server for OpenWA?
No. When you deploy OpenWA, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
Can I move my data from WhatsApp Business API to OpenWA?
Most people export from WhatsApp Business API and import into OpenWA. The official guides at github.com walk through it.
Related apps
WhatsApp API with a test console; unofficial, numbers can be banned.
Connect WhatsApp to your chatbots, inbox and apps, unofficially.
A light WhatsApp API for your own code, unofficial and ban-prone.
Zapier-style automations between your apps, on your own server.