WhatsApp Cloud API vs the Old On-Premises API (and Coexistence)
If you're still asking 'Cloud API or On-Premises,' the answer is simpler than it used to be. Here's what actually changed, and how coexistence lets you migrate gradually.
Meta has been retiring the old, self-hosted WhatsApp On-Premises API in stages and moving everyone onto the Cloud API, which Meta itself hosts. If you're still weighing "Cloud API vs On-Premises," the honest 2026 answer is that this isn't really a live decision anymore — the Cloud API, accessed through a Business Solution Provider, is simply the standard path. The one genuinely new piece worth understanding is coexistence: a feature that lets you keep the WhatsApp Business App on a phone while that same number also runs on the Cloud API, so you can migrate gradually instead of all at once.
Why this question still comes up#
Search the phrase "WhatsApp API" and you'll still land on years of older articles, forum threads and developer docs that talk about the "On-Premises API" as if it's a real, current choice you need to weigh against something called the "Cloud API." That content isn't wrong exactly — it's just describing an earlier stage of the WhatsApp Business Platform's history that Meta has since moved past.
Here's the short version of what happened. Meta originally offered exactly one way to get programmatic access to WhatsApp for a business: the On-Premises API, a piece of server software that a business — or, more commonly, a Business Solution Provider (BSP) acting for the business — had to install, configure and run on its own infrastructure. From 2022 onward, Meta introduced a second option: the Cloud API, hosted entirely on Meta's own servers, removing the need for anyone to run that server software at all. Since then, Meta has progressively retired the On-Premises path, pushing essentially all new integrations — and, over time, existing ones — onto the Cloud API.
Migration timelines and deprecation dates for Meta products move, and this guide reflects the trajectory Meta has been on. If you're reading older documentation, a vendor's outdated sales page, or a Stack Overflow thread from a few years back, treat any On-Premises setup instructions as historical, and check developers.facebook.com/docs/whatsapp for the current, authoritative status before you plan around it.
So when someone today asks "should I use the Cloud API or On-Premises," the honest answer is that the comparison itself is mostly a relic. Nobody sensibly starting fresh chooses On-Premises anymore. But the question is worth answering properly anyway, because (a) understanding why Meta made the switch tells you what to expect from the platform going forward, and (b) it sets up the one part of this story that's genuinely new and still evolving: coexistence.
It's worth being specific about why this confusion persists, because it isn't a sign anyone did anything wrong. The WhatsApp Business Platform is genuinely young as enterprise software goes, and its documentation, third-party tutorials and vendor marketing pages accumulated over several years while the underlying architecture was still changing underneath them. A blog post explaining On-Premises setup that was accurate and helpful the year it was published doesn't get automatically rewritten once Meta changes course — it just sits there, still indexed, still answering searches, quietly out of date. Add in the fact that plenty of developers, agencies and BSPs built real production systems on the On-Premises API back when it was the only option, and you get a long tail of forum questions, GitHub issues and internal runbooks that reference it long after it stopped being the recommended starting point. None of that is misinformation in the malicious sense — it's just software history lagging behind software reality, which is exactly the gap this article is trying to close.
What the On-Premises API actually was#
Before the Cloud API existed, if a business wanted to send and receive WhatsApp messages programmatically — templates, broadcasts, a shared inbox, a chatbot — the only route was through the On-Premises API. In practice this meant Meta's server software had to run somewhere: on a business's own servers, on a BSP's infrastructure, or in a cloud VM the business or its provider managed directly.
That single design choice created a whole category of ongoing work that had nothing to do with actually messaging customers:
- Someone had to provision and patch servers. Every security update, every version bump, every scaling adjustment was a manual operational task.
- Uptime was your problem. If the server went down at 2am, WhatsApp messaging for that business went down with it, and someone had to be paged.
- Capacity planning was manual. A sudden spike in conversation volume meant scaling the underlying servers yourself, not something that happened automatically.
- New features arrived late, if at all. Because On-Premises ran a fixed, versioned build of Meta's server software, newer capabilities were often built API-first for the hosted model and only trickled down to On-Premises later — if they ever did.
None of this was really the fault of the businesses running it; it's simply what "self-hosted" always costs, on any platform. For a handful of very large enterprises with dedicated infrastructure teams, that trade-off was sometimes acceptable. For the overwhelming majority of businesses — and for the BSPs serving thousands of smaller clients — it was pure overhead standing between them and the thing they actually wanted, which was to talk to customers.
It also meant every BSP serving small and mid-sized businesses was effectively running its own private fleet of WhatsApp servers on behalf of every client it onboarded — one deployment per business, each needing its own monitoring, its own failover plan and its own upgrade cycle. Multiply that across hundreds or thousands of client numbers and you can see why the On-Premises model scaled so poorly for the exact segment of the market — small and growing businesses — that WhatsApp messaging was supposed to be easiest for. The people closest to that pain were the BSPs themselves, which is a large part of why the shift to a Meta-hosted model was welcomed rather than resisted once it arrived.
What changed with the Cloud API#
The Cloud API is Meta's answer to that overhead: the same WhatsApp Business Platform capabilities — messages, templates, media, webhooks, Flows, catalog, Ads click-to-WhatsApp — but hosted by Meta, not by you. A business (or its provider, like SabNode) simply calls Meta's API endpoints. There is no server to install, no patching schedule, no capacity plan to draw up.
On-Premises meant "you run Meta's server software." Cloud API means "Meta runs it, you just call it." Everything downstream — faster feature access, lower technical bar to get started, less to break at 2am — follows from that one change.
That single architectural shift produces several concrete, practical differences:
- Less infrastructure to run, patch or scale. Meta absorbs the hosting burden entirely, which removes an entire job function from the equation for smaller businesses and lets larger BSPs redirect engineering effort toward the product instead of the plumbing.
- Faster access to new features. Because Meta only has to ship a feature once, to servers it controls, new capabilities — WhatsApp Flows, updated Ads/click-to-WhatsApp integration, newer template formats and buttons — have typically appeared on the Cloud API first, sometimes well before (or exclusively instead of) the On-Premises path.
- A lower technical bar to get started. Onboarding through a BSP onto the Cloud API is largely a business-verification and configuration exercise, not an infrastructure project. That's a big part of why embedded signup — a guided popup flow a provider like SabNode builds into its product — can get a business live in days rather than weeks.
- One less point of failure. Uptime, scaling and security patching for the messaging layer itself become Meta's job rather than yours or your provider's.
Cloud API vs On-Premises API, side by side#
| Dimension | On-Premises API (legacy) | Cloud API |
|---|---|---|
| Hosting | You or your BSP install and run Meta's server software | Hosted entirely by Meta |
| Maintenance | Manual patching, upgrades, uptime, capacity planning | None — Meta manages the infrastructure |
| Feature velocity | New features often arrive later, if at all | New features (Flows, Ads updates, template formats) typically ship here first |
| Setup path | Server provisioning plus business/API configuration | Business verification and configuration only, via a BSP's embedded signup |
| Who it's built for today | Legacy integrations only — being phased out | Everyone: new integrations and the ongoing migration target for old ones |
| Status | Being retired by Meta in stages | The standard, actively developed platform |
If you're comparing these two for a brand-new integration in 2026, there genuinely isn't a decision to make: you onboard onto the Cloud API through a provider. The table above exists to explain history, not to help you pick — On-Premises isn't a live option for new setups.
What if you (or your developer) inherited an old On-Premises setup?#
If you're reading this because your business already has a working integration that was built years ago and you've simply never had a reason to touch it, the practical guidance is straightforward: don't wait for something to break. Reach out to your current provider (or, if you're unsure who that is, any Business Solution Provider like SabNode) and ask specifically about migrating that number to the Cloud API. In most cases the number itself, your message history context, and your business verification status carry forward — what changes is where the messaging logic actually runs, which is invisible to your customers and, done properly, shouldn't interrupt service at all.
The same advice applies if you're evaluating a vendor quote or a freelance developer's proposal and it mentions installing or hosting WhatsApp server software for you. That's a strong signal the proposal is either describing outdated architecture or, less charitably, padding the project with infrastructure work that a Cloud API integration wouldn't require at all. Ask directly whether the integration will use the Cloud API — it's a one-sentence question with a one-sentence answer, and the answer should always be yes for new work.
What coexistence is (and why it's different from the API-vs-API question)#
Coexistence is a distinct, more recent Meta feature, and it answers a completely different question than "Cloud API or On-Premises." It answers: "I already use the free WhatsApp Business App on my phone for my number — do I have to give that up the moment I connect to the API?"
The answer, thanks to coexistence, is no. Coexistence lets a business keep using the ordinary, free WhatsApp Business App — the consumer-facing app most small business owners already know — on a phone for a given number, while that same number is also connected to the Cloud API through a provider. The two stay in sync: a manager can keep replying to customers from the familiar app interface on their own phone, while the rest of the team, the shared inbox, the chatbot and any broadcast automation all work through the API/BSP platform, on the same number, at the same time.
Coexistence is aimed squarely at small businesses transitioning gradually. If you're a solo owner or a small team used to running WhatsApp from one phone, and the idea of "moving to an API" sounds like you'll lose the interface you're comfortable with, coexistence is Meta's answer: you don't have to abandon the app the day you turn on the platform.
This matters because the biggest practical objection to adopting the WhatsApp Business Platform has never really been about templates or pricing — it's the fear of losing a familiar, working habit. A shop owner who's replied to customers from their phone for years, and who trusts that muscle memory, doesn't want to be told "starting Monday, you must use different software for everything." Coexistence removes that all-or-nothing pressure. You can connect the number to the Cloud API, add teammates and a chatbot on the platform side, and let the original phone-app habit keep running in parallel until it naturally becomes unnecessary.
Business App alone vs App + Coexistence vs Cloud API only#
| Setup | WhatsApp Business App alone | App + Coexistence | Cloud API only |
|---|---|---|---|
| Who can reply | One person, one phone | Manager on the phone app, team on the platform — same number | Unlimited agents via the shared inbox |
| Templates & broadcasts | Not available | Available through the connected platform | Full template and broadcast support |
| Chatbot / automation | Basic away messages only | Available through the connected platform | Full chatbot, routing and workflow support |
| CRM / systems integration | None | Available through the connected platform | Native — full API, webhooks, integrations |
| Familiar phone interface | Yes, always | Yes, kept in parallel during transition | Optional — usually retired once the team has fully moved over |
| Best for | A solo owner, single number, low volume | A small team migrating gradually, not ready to fully leave the app | A team fully running support and outreach through one shared system |
Reading left to right, this table is really a migration path, not three permanent competing options. Most growing businesses start on the left, use the middle column as a bridge for as long as it's useful, and settle on the right once the whole team has moved into the shared inbox.
How to move from the WhatsApp Business App to the Cloud API via coexistence#
Here's the practical sequence for a small business that's currently on the free app and wants to move onto SabNode's WaChat without a jarring cutover.
- Pick a Business Solution Provider. You need a BSP to reach the Cloud API — SabNode's WaChat is built on it natively. Choose a provider before you touch your existing number.
- Start embedded signup on your existing number. Rather than buying a fresh number, use the provider's embedded signup flow and choose the option to connect your current WhatsApp number rather than migrating it away from the app entirely.
- Enable coexistence during the connection flow. This is the step that keeps the WhatsApp Business App usable on your phone. Recent conversation history can sync into the platform at this point too.
- Verify your business with Meta. This runs in parallel with everything else — it doesn't block you from messaging at a lower tier while it completes, and it's what your green tick (if you pursue one) depends on later.
- Keep replying from your phone while you set the platform up. There's no rush to change anyone's habits on day one — the manager who's always answered from their phone can keep doing exactly that.
- Invite your team into the shared inbox. Add the additional agents who couldn't previously access the number at all, and start routing new conversations to them through the platform.
- Submit your first message templates. Welcome message, order or appointment update, and an OTP template if you need authentication — get these into review early so they're approved when you need them.
- Build a simple chatbot for the repetitive questions. Start with something small — hours, pricing, order status — so the team isn't manually answering the same five questions all day.
- Shift day-to-day replying into the platform gradually. As the team gets comfortable with the shared inbox, let it become the default place people work, with the phone app increasingly a backup rather than the primary tool.
- Retire the phone app once it's genuinely optional. There's no deadline forcing this — do it when the whole team is comfortably working from the platform and the app on the phone isn't adding anything anymore.
Every step above can happen without a single day of disrupted customer replies. That's the entire point of coexistence: the migration is additive, not a cutover, so nothing about your customer-facing number changes from a customer's point of view at any point in the process.
Common mistakes#
- Assuming you still need to choose On-Premises for "more control." On-Premises being self-hosted was never really "more control" in a way that benefited most businesses — it was just more maintenance. The Cloud API gives you the same messaging capabilities without the operational burden.
- Building a new integration against old On-Premises documentation. If a guide, tutorial or forum answer walks you through installing server software for WhatsApp, it's describing a path Meta has been retiring. Cross-check against current developer docs before following it.
- Treating coexistence as a permanent state instead of a bridge. Coexistence exists to make migration comfortable, not to be the end state forever. Teams that never move fully into the shared inbox miss out on the multi-agent access, templates and automation that were the reason to connect the API in the first place.
- Forgetting to enable coexistence before connecting an existing number. If you connect a number to the Cloud API without choosing the coexistence option, you may lose the ability to keep using the phone app on that number. Choose it deliberately during setup if a gradual handover matters to you.
- Worrying the green tick or verification resets. Verification status and any existing badge are tied to your Meta Business account and business identity, not to which hosting model (On-Premises vs Cloud) or which mode (app-only vs coexistence) the number happens to be running under.
- Skipping message templates because "the app never needed them." Once conversations move outside the free-form service window, only pre-approved templates can re-open them — this is true on the Cloud API regardless of whether coexistence is active, and it's easy to overlook if you're used to the app's unrestricted messaging.
- Letting the phone-app habit block team growth. If one manager keeps answering everything from their phone indefinitely "because it's faster," the business never actually captures the multi-agent, automation and reporting benefits that justified moving to the API in the first place.
Connect your existing WhatsApp number without losing the app
SabNode's WaChat onboards your current number onto the Cloud API with coexistence, so your team gains a shared inbox, templates and chatbots while the number keeps working exactly as customers expect.
Where this fits with the rest of WhatsApp on SabNode#
Once your number is on the Cloud API — whether you got there straight away or eased in through coexistence — everything else about running WhatsApp as a real business channel works the same way. Templates and the 24-hour service window govern what you can send and when; conversation-based pricing determines what it costs; and a shared inbox, broadcasts and chatbots are what turn the connection into an actual team workflow rather than just a technical link. The WhatsApp Business API complete guide covers all of that in depth, and the shared team inbox guide goes deep on the multi-agent workflow coexistence is ultimately building you toward.
It's also worth remembering that WhatsApp rarely sits alone in a business's stack for long. Once a number is on the Cloud API and connected to a real platform, the same conversation that starts on WhatsApp can naturally continue as a phone call, generate a payment link, or log straight into a CRM record — because the platform underneath it is doing more than just messaging. That's the broader argument for choosing an all-in-one provider over a WhatsApp-only tool: the API migration you make once should also be the last time you have to think about where your customer conversations live. Our overview of what SabNode actually is lays out how WhatsApp, calling, CRM and payments sit on one login and one customer timeline once you're past this migration step.
Conclusion#
The "Cloud API vs On-Premises API" question that so much older content still frames as a live decision has, in practice, already been answered by Meta: the Cloud API — hosted, faster-moving, and reached through a Business Solution Provider — is the standard path for every business setting up WhatsApp messaging today. On-Premises was a reasonable design for an earlier stage of the platform, but it asked businesses and their providers to carry infrastructure work that added nothing to the actual customer conversation, and Meta has been winding it down accordingly.
Coexistence is the piece worth actually planning around, because it changes how you get from "one phone, one app" to "a real team on the Cloud API" — not whether you should. It removes the false choice between keeping what works today and unlocking what you need tomorrow, letting a small business move at its own pace without ever disrupting the number customers already know.
If you're currently running WhatsApp from a single phone and wondering whether adopting the API means giving that up, it doesn't have to — not on day one, and not until you're ready. Start free on SabNode and connect your existing number through WaChat's embedded signup with coexistence enabled, or read the full WhatsApp Business API guide to see everything that becomes possible once your whole team is working from one shared inbox.
Frequently asked questions
Is the WhatsApp On-Premises API still available?
Meta has been retiring the On-Premises API in stages and pushing all new and existing integrations onto the Cloud API. If you're setting up WhatsApp Business messaging today, the Cloud API through a Business Solution Provider like SabNode is the standard path — treat any On-Premises references you find online as legacy, and confirm current status at developers.facebook.com/docs/whatsapp before assuming otherwise.
What's the actual difference between the Cloud API and the On-Premises API?
The On-Premises API required you (or your provider) to install, host and maintain Meta's server software on your own infrastructure — patching, scaling and uptime were your responsibility. The Cloud API is hosted by Meta itself, so there's no server to run. New features like WhatsApp Flows and updated Ads integrations typically land on the Cloud API first, and onboarding through a provider is faster because there's no infrastructure step.
What is WhatsApp coexistence?
Coexistence is a Meta feature that lets a business keep using the free, ordinary WhatsApp Business App on a phone for a number, while that same number is also connected to the Cloud API through a provider. Both stay in sync — a manager can keep replying from the familiar app on their phone while the rest of the team and any automation work through the API.
Do I have to give up the WhatsApp Business App to move to the API?
Not immediately. Coexistence exists specifically so you don't have to make a hard cutover. You can connect your existing number to the Cloud API via coexistence, run both side by side while your team gets comfortable, and fully retire the phone-based app later once everyone has moved into the shared inbox.
Which is better for a small business — the app, coexistence, or Cloud API only?
If one person handles all your WhatsApp chat from a single phone and that's working, the free app alone is fine. The moment more than one person needs to reply, or you want templates, broadcasts and a chatbot, coexistence is the easiest on-ramp because it doesn't force an abrupt switch. Cloud-API-only is the end state most growing teams land on once the whole team has moved into a shared inbox.
Will my WhatsApp number, chat history or green tick be affected by switching to the Cloud API?
Your number stays the same — that's the point of coexistence and of the Cloud API migration path in general. Recent chat history can sync during a coexistence connection, and verification status (including a green tick, if you have one) is tied to your Meta Business verification, not to which hosting model you use, so it carries over.
How do I move from the WhatsApp Business App to the Cloud API?
In short: pick a Business Solution Provider like SabNode, connect your existing number through Meta's embedded signup with coexistence enabled, keep using the app on your phone while your team joins the shared inbox, submit your message templates, then gradually shift day-to-day replying into the platform until the phone app is optional. The full numbered walkthrough is in this guide.