# Unofficial WhatsApp API: ban risks and what Meta actually allows

> An unofficial WhatsApp API is free and on GitHub, but the number can be banned. See what WhatsApp's terms say, the real risks and how it compares with the official API.

- **HTML version:** https://tolky.to/en/blog/unofficial-whatsapp-api-risks
- **Author:** [Marlos Carmo](https://tolky.to/en/author/marlos), Co-founder of Tolky
- **Published:** November 19, 2026
- **Reviewed:** November 19, 2026
- **Language:** en

## Summary

An **unofficial WhatsApp API** automates WhatsApp Web through libraries and projects such as Baileys, whatsapp-web.js, WAHA and the Baileys mode of Evolution API, without Meta's approval. It is free, but WhatsApp says unofficial apps violate its terms and that the account may be temporarily or permanently banned. For a business number, the safe path is the official API (Cloud API), with coexistence to keep the app.

Search for "free WhatsApp API on GitHub" and you will find dozens of projects that connect a number in minutes by scanning a QR code. No Meta signup, no template approval, no per-message fee. It looks like the perfect shortcut to a chatbot or a shared inbox.

The price shows up later: the business number banned, the session dropping with every WhatsApp update, customer data on a server nobody controls. This guide explains what an unofficial API is, what WhatsApp's terms actually say, the concrete risks and when the official API pays off.

*Updated in November 2026.*

## What is an unofficial WhatsApp API?

**An unofficial WhatsApp API is software that automates a phone number's WhatsApp account, usually by connecting as WhatsApp Web, without Meta's authorization.** It reads and sends messages as if it were a linked device, and exposes that to other systems.

The best-known projects are open source and well maintained. According to their own repositories, checked on November 19, 2026:

- **[Baileys](https://github.com/WhiskeySockets/Baileys):** a TypeScript library that talks to WhatsApp Web over WebSockets, under the MIT license.
- **[whatsapp-web.js](https://github.com/pedroslopez/whatsapp-web.js):** a Node.js library that drives WhatsApp Web in an automated browser.
- **[WAHA](https://github.com/devlikeapro/waha):** an HTTP API you install on your server; the session starts by scanning a QR code with the phone.
- **[Evolution API](https://github.com/EvolutionAPI/evolution-api):** supports two modes, one based on Baileys and another on Meta's official Cloud API.

That last point matters: "unofficial" describes the connection method, not the project. Evolution API connected to the Cloud API uses the official channel.

## Why do so many people use an unofficial API?

**The unofficial API is popular because it is free, needs no approval from Meta and works with the number already on the phone.** For testing an idea, it is the shortest path.

- **No software cost**, and no Meta fee per message.
- **No signup** for a business account, verification or template approval.
- **Free-form messages at any time**, without the 24-hour window rule.
- **Plenty of tutorials** and ready integrations with n8n, Typebot and open source CRMs.

This is where searches for "WhatsApp CRM open source" and "open source WhatsApp inbox" come in. Many of these systems are serious and useful; the risk is not open source code, but connecting the number through an unofficial channel.

## What do WhatsApp's terms say about unofficial APIs?

**WhatsApp's terms forbid accessing or using the service through unauthorized automated means and sending impermissible bulk or automated messages, and the help center says unofficial apps violate the terms.** The sources below were read on November 19, 2026.

- **[Terms of Service](https://www.whatsapp.com/legal/terms-of-service):** users must not, "directly, indirectly, through automated or other means," access or use the services in unauthorized ways; must not "create accounts for our Services through unauthorized or automated means"; and must not send illegal or impermissible communications "such as bulk messaging, auto-messaging, auto-dialing, and the like." Violations can lead to the account being disabled or suspended.
- **[About unofficial WhatsApp apps](https://faq.whatsapp.com/1217634902127718):** unofficial apps and websites are versions built by third parties without WhatsApp's approval; using them or linking your account to them violates the terms, and the account may be temporarily or permanently banned.
- **[Unauthorized use of automated or bulk messaging](https://faq.whatsapp.com/5957850900902049):** WhatsApp says its products were not designed for automated or bulk messaging, that it uses machine learning to ban accounts and that it takes legal action against companies that violate its terms.

The projects themselves warn users. whatsapp-web.js says there is no guarantee you will not be blocked and that WhatsApp does not allow bots or unofficial clients. Baileys discourages bulk or automated messaging.

The terms talk about unauthorized use and action on the account. This guide does not call anyone illegal: the point is the risk the business takes on.

## What are the concrete risks for a business?

**The biggest risk is losing the business number, but instability, data security and lack of support weigh on the daily operation.**

1. **A banned number.** The ban can be temporary or permanent. According to the [help center](https://faq.whatsapp.com/465883178708358), only WhatsApp can ban or unban accounts, and third-party services cannot fix that.
2. **Bulk sends become reports.** Without approved templates or opt-in, mass messages lead to blocks and reports. See how to do [bulk messaging on WhatsApp](https://tolky.to/en/blog/whatsapp-bulk-messaging) the official way.
3. **Instability.** The connection relies on an interface WhatsApp changes at will. An update can drop the session and require a new QR code.
4. **Security and privacy.** The session grants access to the whole account, and conversations sit on the server of whoever runs the project. Privacy laws such as Brazil's LGPD require security measures to protect personal data ([Law 13,709, art. 46](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm)).
5. **No support or official features.** There is no one to turn to at Meta, and no templates, verified account or [number quality rating](https://tolky.to/en/glossary/number-quality-rating) as a health signal.

## Official or unofficial API: what is the difference?

**The official API costs per message and requires signup, but protects the number and scales; the unofficial one is free and instant, but puts the number at risk.**

| Criterion | Official API (Cloud API) | Unofficial API |
| :--- | :--- | :--- |
| Authorization | From Meta, with a business account | None |
| Cost | Meta fee per message, plus the platform | Server and maintenance |
| Risk to the number | Low, if you follow the policies | Temporary or permanent ban |
| After 24 hours | Approved template | No rule, and no protection |
| Features | Templates, buttons, webhooks, coexistence | Whatever WhatsApp Web offers, while it works |
| Scale | Limits grow with quality | More volume, more risk |
| Support | Meta and the provider ([BSP](https://tolky.to/en/glossary/bsp)) | The project's community |

Under the rate card in effect since October 1, 2026, checked on November 17, 2026, Meta gives 1,000 free service messages per number each month; after that, each costs US$ 0.0034 for a US number, and a marketing template US$ 0.025 ([WhatsApp Business Platform pricing](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)). See [WhatsApp Business's new pricing](https://tolky.to/en/blog/whatsapp-business-pricing-october-1-brazil) and run your numbers in the [WhatsApp API cost calculator](https://tolky.to/en/resources/whatsapp-api-cost-calculator).

## When do people still choose an unofficial API?

**The unofficial API still shows up in study, prototypes and personal use, with a number the person is willing to lose.** For learning how a bot works, it teaches fast.

For the business number, the one on the cards, the website and in customers' contacts, the math changes: a ban costs more than years of fees. If the plan is to build an agent with open tools, you can use the official channel, as the guide to a [WhatsApp AI agent with n8n](https://tolky.to/en/blog/whatsapp-ai-agent-n8n) shows.

## How do you move from an unofficial to the official API?

**To migrate, connect the number to the Cloud API, directly with Meta or through a provider, and use coexistence if you want to keep the app on the phone.**

1. **Choose the path:** direct Cloud API or a [BSP](https://tolky.to/en/glossary/bsp). The steps are in [how to get the official WhatsApp Business API](https://tolky.to/en/blog/how-to-get-official-whatsapp-business-api).
2. **Disconnect the unofficial session** from the number before migrating.
3. **Keep the app if you need it.** With [coexistence](https://tolky.to/en/blog/whatsapp-coexistence-business-app-and-api), the number stays in the WhatsApp Business app and also works on the API, when available for the account.
4. **Prepare templates and opt-in** to reach customers outside the 24-hour window.

The gains of the official API are in the guide to [WhatsApp Business API benefits](https://tolky.to/en/blog/whatsapp-business-api-benefits-for-your-company).

## Where does Tolky fit?

**Tolky serves customers on your company's official number through the official WhatsApp Business API, connected directly to Meta (Cloud API) or through Gupshup, an official Meta partner.** There is no QR code or WhatsApp Web connection. See the question [does Tolky use the official WhatsApp API?](https://tolky.to/en/faq/does-tolky-use-the-official-whatsapp-api)

![Real screenshot of Tolky's Conversations screen in English, with the list of WhatsApp conversations from several customers, the All, Unread and Paused filters and the collapsed side menu](https://tolky.to/screenshots/conversas-whatsapp-en.png)

On the same number, AI agents serve customers, hand off to people with the history and send campaigns with approved templates. With coexistence, when available, the number stays in the phone app.

**What Tolky does not do:** it does not use unofficial APIs or pay Meta's fees, which are not part of the plan. WhatsApp starts on the Starter plan; see the [plans](https://tolky.to/en/pricing).

## Frequently asked questions

### Is using an unofficial WhatsApp API forbidden?

WhatsApp's terms forbid access through unauthorized automated means and say unofficial apps violate the terms. The stated consequence is action on the account, such as suspension or a ban.

### What is the best unofficial WhatsApp API?

For a business number, none is safe, because the risk comes from the connection method. If you already use Evolution API, it also has a mode that uses the official Cloud API.

### Is there a free WhatsApp API?

The code of unofficial APIs is free, but the server and the risk are not. On the official API, Meta gives 1,000 free service messages per number each month and charges per message above that and per template.

### Is an open source WhatsApp CRM safe?

The software can be good; what defines the risk is how the number connects. Through the official API, the risk to the number is low; through WhatsApp Web, there is a ban risk.

### My number was banned. What should I do?

Follow the guidance in the app and request a review if the option appears. Only WhatsApp can unban an account; be wary of anyone promising to do it.

### Can I move to the official API without changing numbers?

Yes. The number can move to the Cloud API, and with coexistence it stays in the WhatsApp Business app, when the feature is available for the account.

---

## Conclusion

An unofficial WhatsApp API is free and fast, but it puts at risk the asset that is hardest to replace: the business number. For study, it works; for serving customers, the official API costs per message and gives back stability, templates and a protected number.

[See the plans](https://tolky.to/en/pricing), [learn the benefits of the official API](https://tolky.to/en/blog/whatsapp-business-api-benefits-for-your-company), [calculate your WhatsApp cost](https://tolky.to/en/resources/whatsapp-api-cost-calculator) or [talk to the team →](https://tolky.to/en/contact). Let's talk?

---

This is the Markdown version of the page. The full version, with images and navigation, is at https://tolky.to/en/blog/unofficial-whatsapp-api-risks

Tolky: https://tolky.to
