The official WhatsApp Business API exists in two hosting forms, and most companies don’t know which one they are using. The difference affects cost, speed of new features, and who is responsible when something stops working. This guide compares the two without jargon, shows how to find out which one you have, and explains why, in either case, what defines your experience is the system in front of you.
In this article
- What are Cloud API and On-Premises
- The differences that matter day-to-day
- Who used On-Premises and why
- How to know which one you have today
- How migration works
- What doesn’t change between the two models
- Security and data: what each model really delivers
- Why the provider matters more than the hosting
- Coexistence, QR Code, and why that’s another conversation
- The real cost of each model
- The most common mistakes in this decision
- Where to start
- Frequently asked questions
What are Cloud API and On-Premises
The official WhatsApp Business API exists in two hosting forms, and the difference between them defines cost, update speed, and who is responsible when something stops working.
The Cloud API runs on Meta’s own infrastructure. Your company, or the provider you hire, connects to a Meta address and sends and receives messages there. There is no WhatsApp server to install, update, or monitor: Meta takes care of that.
The On-Premises API was the old model, where WhatsApp software ran on servers owned by the company or provider — with containers to install, databases to maintain, version updates to apply, and monitoring to perform. It was created before the Cloud API existed and was the only option for years.
Since the Cloud API was launched, Meta has treated it as the main path, and On-Premises has been progressively discontinued. In practice, this means that today’s decision, for almost every company, is no longer a choice between two equivalent options: it’s understanding why the Cloud API became the standard and what to do if you are still on the old model.
This guide shows the real differences between the two models, what changes day-to-day for operators, how to find out which one you have today, what to watch for in a migration, and why, in either case, your experience is determined not by Meta’s hosting but by the provider and system in front of you.
Continue reading for free
Fill out once and unlock this and all other blog articles. We don’t charge anything — we just want to know who we’re writing for.
Takes 20 seconds. Prefer to talk directly on WhatsApp?
The differences that matter day-to-day
Putting technical vocabulary aside, six differences appear in operation:
- Who maintains the server. In Cloud API, Meta. In On-Premises, you or your provider — including version updates, which had deadlines and became urgent if forgotten.
- Updates and new features. New features arrive first on Cloud API. Those on the old model receive fewer and later updates.
- Peak scaling. In Cloud API, capacity is Meta’s. In On-Premises, large sends required scaling machines, and lack of capacity caused stuck queues.
- Infrastructure cost. Cloud API has no server cost. On-Premises added machine, database, backup, and maintenance team costs.
- Where messages pass through. In Cloud API, through Meta’s infrastructure. This was the main argument for those defending the old model in sectors requiring local data.
- Support. In Cloud API, platform problems are Meta’s problem. In On-Premises, the first question was always whether the error was in your container.
Who used On-Premises and why
Three reasons supported choosing the old model, and it’s worth understanding them because they explain some companies’ resistance to migrate.
The first was regulatory or internal requirements about where data travels and is stored, common in banking, healthcare, and public sectors. The second was latency and integration with internal systems: companies with heavy ERP and custom rules preferred having the WhatsApp component close to the rest of the architecture. The third was simply history — those who started before Cloud API existed built everything on that model and had no reason to change while it worked.
What changed is that the first two reasons lost strength over time as Meta expanded controls and processing options, while the cost of staying on the old model rose: fewer features, less support, and a running discontinuation deadline.
How to know which one you have today
Most companies don’t know because they hired a provider and never asked. Three quick ways to find out:
- Ask the provider directly, in writing: "Is my number on Cloud API or On-Premises?" The answer should be straightforward.
- Look at Meta’s dashboard. In the WhatsApp Business account manager, the number appears linked to the business account, and the configuration method gives clear clues.
- Observe the symptoms. If new features take a long time to arrive, if there was a container version update notice, or if the provider talks about "our WhatsApp server," it’s probably the old model.
Knowing this matters for a practical reason: if you are On-Premises, a migration is ahead, and it’s better to plan it than be caught by a deadline.
How migration works
Migrating from On-Premises to Cloud API is not changing your number or starting from scratch, but it’s not a button either. In general terms:
- the number is migrated within the same business account, keeping the same phone for the customer;
- approved templates are linked to the account, not the server, and remain available;
- the integration must point to the new address, and the webhook must be reconfigured;
- there is a short downtime window during the switch, which must be coordinated with operations;
- the number’s quality and sending limit follow the account, not the server.
The biggest point of attention is conversation history. It lives in the system you use, not the API — and that’s exactly why the choice of system matters more than hosting. Companies that handled conversations directly via API, without CRM, often discover during migration that they have no history to carry over.
What doesn’t change between the two models
This is the part that surprises those expecting Cloud API to solve problems that aren’t its responsibility. They remain exactly the same in both models:
- Meta’s rules. Approved templates to start conversations, service windows, message categories, and usage policies apply equally.
- Charging per conversation. Meta’s pricing model is the same and does not depend on hosting.
- Quality and sending limits. The number’s tier and quality rating follow the account and do not improve by switching models.
- Blocking and banning. The customer reports, and the consequences are the same.
- Opt-in. Permission to send is still required; it’s not a technical detail but a rule.
In other words: if your current problem is rejected templates, low-quality numbers, or blocked sends, switching from Cloud API to On-Premises or vice versa doesn’t solve anything.
Security and data: what each model really delivers
This was the strongest argument for On-Premises and remains the most misunderstood. The intuitive idea is that keeping the server in-house means data "doesn’t leave the company" — and that was never true. In either model, messages travel through WhatsApp’s network, are delivered by Meta’s infrastructure to the client’s device, and are subject to platform policies.
What changed in On-Premises was where the component that intermediated sending was located and where content was processed in that specific segment. For sectors with regulatory requirements about local processing, this made a real legal difference. For the vast majority of companies, it made no practical difference, and the feeling of control came with a greater risk: poorly maintained servers without updates and with improvised backups are less secure than managed infrastructure.
Today, the useful conversation about security has shifted. It’s no longer about API hosting but about who has access to conversations in the system you use: is there user permission control, can agents export the entire database, what happens when a salesperson leaves the company, who can see another agent’s conversations, and how is the audit trail recorded. That’s where leaks really happen — through unauthorized access from insiders, not the network segment between you and Meta.
Why the provider matters more than the hosting
From the user’s perspective, Meta’s hosting is invisible. What you see every day is what’s on top of it: the service interface, history, automation, reports, support speed, and integration stability.
Two companies can be on the same Cloud API and have opposite experiences because one has a system that stores conversations, distributes leads, automates responses, and shows results, while the other has a generic inbox that loses messages when the browser closes. The hosting is the same; the business is not.
When choosing, the questions that really change the outcome are: is the history mine and can I export it; how many agents can use the same number; is there real automation or just auto-reply; does the system show first response time and conversion; and how long does support take to respond when sending stops on a Friday night.
Coexistence, QR Code, and why that’s another conversation
A common confusion mixes three different things: Cloud API, On-Premises, and unofficial solutions based on QR Code scanning. The first two are official API hostings. The third is not an official API at all — it’s software that connects to WhatsApp as if it were a paired phone.
The practical difference is big. With the official API, there is a contract, approved templates, charging per conversation, support, and predictability. With QR Code connection, there is no prior message approval or cost per conversation, which attracts many, but there is also no guarantee: the number can be blocked at any time, without notice or appeal, and the sending behavior is exactly what triggers blocks most.
There is also coexistence, which allows using the WhatsApp Business app and the official API on the same number, with rules defined by Meta. It solves a specific problem — keeping history and mobile use while the company transitions to the API — and does not replace the hosting decision.
The correct way to see it is two independent axes. One is the channel: official or unofficial. The other, within official, is hosting: Cloud or On-Premises. Mixing the two axes leads to bad decisions, like choosing QR Code thinking it’s "the cheap version of the official API" when it’s actually a different category, with different risks and none of the guarantees that make a company choose the official path.
The real cost of each model
Comparison for an average operation, with one number and about six thousand conversations per month:
- Cloud API: cost of conversations charged by Meta + monthly fee for the service system. Infrastructure: zero.
- On-Premises: cost of conversations charged by Meta + monthly fee for the system + server and database + backup + technical team time for updates and monitoring.
In a real operation with a modest dedicated server, backup, and about four hours of technical work per month, the old model added between R$ 600 and R$ 1,400 per month in costs that simply don’t exist in Cloud API — without delivering anything extra for customer service. For companies with specific data processing requirements, this cost was justified. For all others, it was pure cost.
The most common mistakes in this decision
- Thinking hosting solves number quality or rejected template problems.
- Choosing a provider based on monthly price without asking if history is exportable.
- Delaying On-Premises migration until it becomes an urgent deadline.
- Migrating without reconfiguring the webhook and going days without receiving messages.
- Not coordinating downtime window with the service team.
- Confusing Cloud API with the WhatsApp Business app, which are completely different things.
Where to start
If you’re starting now, the answer is simple: Cloud API, with a provider that delivers your history and exportability. If you already operate, find out in writing which model you have; if it’s On-Premises, ask the provider for a migration plan with date, window, and who will reconfigure the webhook; and use the migration to review what really matters — if your system stores history, if automation works, and if you can measure response time and conversion. Hosting is a one-time decision; the system on top is what you use every day.
Frequently asked questions
What is the difference between Cloud API and On-Premises?
Both are ways to host the official WhatsApp Business API. In Cloud API, the software runs on Meta’s infrastructure, with no server to install, update, or monitor. In On-Premises, the software ran on company or provider servers, with containers, databases, version updates, and monitoring handled by the host. Since Cloud API’s launch, Meta has treated it as the main path and progressively discontinued On-Premises, providing fewer new features and less support. For those starting today, the practical decision is no longer choosing between two equivalent options: it’s understanding why Cloud API became the standard.
How do I know if my number is on Cloud API or On-Premises?
Most companies don’t know because they hired a provider and never asked. The quickest way is to ask the provider directly, in writing, and demand a clear answer. You can also check in the WhatsApp Business account manager, where the number appears linked to the business account and the configuration method gives clear clues. Finally, there are typical symptoms of the old model: new features arriving late, container version update notices, and a provider talking about "our WhatsApp server." Knowing this matters because if you’re On-Premises, a migration is ahead and it’s better to plan it than be caught by a deadline.
Does changing hosting solve rejected templates or low-quality numbers?
No. Meta’s rules are exactly the same in both models: approved templates to start conversations, service windows, message categories, usage policies, charging per conversation, quality classification, and sending limits by tier. All follow the business account and number, not the hosting. Blocking and banning work the same because the customer reports. So if your current problem is rejected templates, red quality, or blocked sends, switching from Cloud API to On-Premises or vice versa doesn’t change anything. What solves these cases is reviewing content, opt-in, sending pace, and list quality.
You choose hosting once. You use the system every day.
VeyloCRM connects your number to the official API, stores all history in your CRM, distributes leads among salespeople, and shows response time and conversion — with data exportable anytime.