WhatsApp Cloud API vs On-Premises: What the 2025 Sunset Means

Nicolas Provost
Nicolas Provost2026-05-12 · 11 min read
WhatsApp Cloud API vs On-Premises: What the 2025 Sunset Means

Meta shut down the WhatsApp On-Premises API on October 23, 2025. What Cloud API offers, how it is priced and how to move a number still stuck on it.

If you are comparing the WhatsApp Cloud API and the On-Premises API, the comparison is over. Meta shut the On-Premises API down on October 23, 2025, and its documentation now states that On-Premises can no longer be used to send messages to WhatsApp users (Meta, On-Premises API sunset). The Cloud API, hosted by Meta, is the only option left.

This guide covers what happened to On-Premises, what the Cloud API gives a Shopify store today (hosting, throughput, pricing), and what to do if your WhatsApp number was left on an old setup. Every date and figure comes from Meta's own documentation, linked where it appears, as checked on September 11, 2026.

What happened to the WhatsApp On-Premises API

Meta's On-Premises API sunset page: the final supported version of the client expired on October 23, 2025

The On-Premises API (often written "On-Premise") was the self-hosted way to reach the WhatsApp Business Platform: businesses or their providers ran the API client on their own servers and installed each new version Meta released. The Cloud API, launched in 2022, moved that work to Meta. Meta then retired On-Premises in three steps, listed on its sunset page:

DateWhat Meta changed
January 9, 2024After On-Premises v2.53, every new feature ships to Cloud API only. On-Premises keeps quarterly releases limited to bug fixes and security patches.
July 1, 2024Business phone numbers can only be registered for Cloud API. Trying to register a number on On-Premises returns error code 1005.
October 23, 2025The final On-Premises version (v2.63) expires. Messages sent to or from numbers still registered on On-Premises are no longer delivered.

Meta justifies the move on the same page with lower setup, hosting and maintenance costs, higher throughput, better reliability, security certifications, local storage options, and new features that only ship to Cloud API. Meta's former On-Premises documentation links now redirect to that sunset page.

Cloud API vs On-Premises: how the two compared

If On-Premises still appears in an old contract, integration or RFP, here is how the two APIs compared, using Meta's own figures.

Cloud APIOn-Premises API
Who hosts itMetaThe business or its provider
Status in 2026ActiveShut down on October 23, 2025
New phone numbersYesNo registrations since July 1, 2024
New featuresEvery new feature since January 2024Bug fixes and security patches only, then nothing
ThroughputUp to 1,000 messages per second per numberLower: Meta says Cloud API reaches 4x the On-Premises level
Where message data is storedMeta data centers, with optional local storage in a chosen countryThe servers of the business or its provider
Servers and maintenanceHandled by MetaHandled by the business or its provider

Sources: Meta's On-Premises API sunset page, throughput documentation and local storage documentation.

Data location was one reason to self-host: message payloads stayed on servers the business controlled. The Cloud API now covers that need with local storage, which Meta presents for regulated industries such as finance, government and healthcare (Meta, Local storage). Details below.

What the WhatsApp Cloud API offers in 2026

Meta's About the WhatsApp Business Platform page, which describes Cloud API messaging, calling and groups

Hosted and run by Meta

The Cloud API is offered by Meta under its Cloud API Terms. You send messages with HTTPS calls to Meta's Graph API and receive incoming messages and delivery statuses through webhooks (Meta, About the WhatsApp Business Platform). There is no client to install, patch or scale on your side. Meta says some partners cut their infrastructure costs by 90% or more after moving to Cloud API (sunset page).

The Cloud API covers messaging (text, media and interactive messages), calling and groups, and Meta ships its newly released and upcoming features to Cloud API only. That is where features such as WhatsApp Flows run.

Throughput: 80 messages per second, up to 1,000

Each registered business number can send up to 80 messages per second by default. Meta upgrades a number to 1,000 messages per second automatically, at no cost, once three conditions are met: the business portfolio has an unlimited messaging limit, the number messages 100,000 or more unique WhatsApp users outside a customer service window within a moving 24-hour period, and its quality rating is Medium or higher. Numbers used with both the WhatsApp Business app and Cloud API stay at a fixed 20 messages per second (Meta, Throughput).

Throughput counts inbound and outbound messages together, and every number remains subject to its messaging limits. Your quality rating matters here: Meta uses it to decide automatic throughput upgrades (Meta, About the WhatsApp Business Platform).

Reliability

Meta states that Cloud API consistently delivers 99.9% uptime with p99 latency under 5 seconds, and it publishes live status on its WhatsApp Business API status page (sunset page). If your webhook endpoint goes down, Meta keeps retrying failed webhooks for up to 7 days (Meta, Throughput).

Security and data location

Messages keep WhatsApp's Signal protocol encryption, and Cloud API encrypts data in transit (HTTPS with TLS) and at rest (Meta, About the WhatsApp Business Platform). Meta lists GDPR and LGPD compliance and SOC 2 and SOC 3 certification for Cloud API, with ISO 27001 in progress (sunset page, Cloud API Compliance Center).

For data residency, local storage lets you choose, per phone number, the country where message content is stored at rest. Supported regions include the EU (Germany), Switzerland and the United Kingdom, among others (Meta, Register a business phone number). Message content can still be processed in Meta data centers outside that region for up to 60 minutes while in use, after which it is kept only in the chosen region (Meta, Local storage).

How Cloud API pricing works since July 1, 2025

Meta's pricing page for the WhatsApp Business Platform: per-message pricing since July 1, 2025

On Cloud API you pay Meta for messages, not for servers. Since July 1, 2025, Meta charges per message instead of per conversation (Meta, Pricing on the WhatsApp Business Platform):

  • You pay when a template message is delivered. The rate depends on the template category (marketing, utility or authentication) and on the country calling code of the recipient's number. Messages your customers send you are not charged.
  • Free-form replies are not charged today. Non-template messages can only be sent inside an open 24-hour customer service window, and utility templates sent inside that window are not charged either. Marketing templates are charged even inside that window.
  • Volume tiers lower utility and authentication rates as your monthly volume grows.
  • Free entry point window: when a customer messages you from a Click to WhatsApp ad or a Facebook Page call-to-action button and you answer within 24 hours, your messages are free for 72 hours, except Meta Business Agent messages.

Two changes arrive on October 1, 2026 (Meta, upcoming pricing updates). Meta will charge per message for service messages (non-template replies written by a person or a third-party AI), at the same rate as utility and authentication messages in each market. It will also charge utility templates sent inside an open customer service window. Meta adds that it will stop delivering service messages for solution providers and directly integrated businesses that have no payment method on file by September 30, 2026. Replies generated by Meta Business Agent, Meta's own AI agent, have been billed per token since August 1, 2026.

Meta only changes prices on the first day of a quarter (January 1, April 1, July 1 or October 1), with at least one month's notice for rate card updates (Meta, Pricing). Rates by country and cost examples for a Shopify store are in our WhatsApp Business pricing guide.

Still on an old setup? What to do now

If your WhatsApp messages stopped around October 23, 2025, or your provider still talks about an On-Premises installation, these steps follow Meta's current documentation.

1. Check the number's status

In WhatsApp Manager, open Account tools, then Phone numbers. Meta requires a number to show the Connected status to send and receive messages through the API (Meta, Business phone numbers). If deliveries stopped on October 23, 2025, that is the day Meta's last On-Premises version expired: the number has to be registered on Cloud API.

2. Register the number on Cloud API

Meta only allows registration through the API, not from WhatsApp Manager or the App Dashboard. The number must first be added to a WhatsApp Business account and verified, then registered with a six-digit two-step verification PIN. Meta caps registration at 10 requests per number in a moving 72-hour window, so avoid trial and error. Registration is also the moment to turn on local storage (Meta, Register a business phone number).

Meta's registration guide adds that numbers coming from On-Premises need extra steps before registration. The migration guide it links to no longer shows any content (checked on September 11, 2026). In practice, let your provider run this step: when you onboard through a provider's Embedded Signup flow, the provider completes the registration.

3. Changing provider? Use Meta's migration flow

If the number sits with a provider you are leaving, it can move to your new provider's WhatsApp Business account through Embedded Signup. The number keeps its display name, quality rating, messaging limit and Official Business Account status, and approved templates with a high quality rating are copied over automatically. A migrated number can only be registered on Cloud API (Meta, Migrating a business phone number between Solution Partners).

Before starting, Meta requires:

  • a verified Meta Business Account (business portfolio)
  • an approved WhatsApp Business account with a valid payment method
  • two-step verification turned off on the number

Plan for two details. Copied templates restart with an unknown quality rating for their first 24 hours, and templates that were not copied, or that Meta rejects after re-checking their category, must be resubmitted. Messages delivered before the migration completes are billed to the old provider.

4. Reconnect your store and your flows

Once the number is live on Cloud API, rebuild what the old stack did: webhooks for incoming messages and delivery statuses, your Shopify order and shipping notifications, your message templates and your opt-in collection. Meta requires opt-in before you send templates (Meta, About the WhatsApp Business Platform).

Where Kanal fits

Kanal is a WhatsApp marketing app for Shopify built on Meta's official WhatsApp Business Platform, so your store runs on the Cloud API from day one, with nothing to host or update on your side. Kanal takes care of the parts that used to require a developer:

Moving off an old provider or a number that was stuck on On-Premises? Book a demo: we'll look at your current number and setup with you and plan the switch.

Conclusion

Meta settled the WhatsApp Cloud API vs On-Premises question: On-Premises stopped delivering messages on October 23, 2025. What is left to decide is how you run the Cloud API:

  1. Check that your number shows Connected in WhatsApp Manager.
  2. If it went silent on October 23, 2025, have it registered on Cloud API through a provider that uses Meta's Embedded Signup.
  3. Budget for per-message pricing, including the October 1, 2026 changes for service and utility messages.

Book a demo to see how Kanal runs WhatsApp on the Cloud API for your Shopify store.

Resources

Frequently asked questions

What is the difference between WhatsApp Cloud API and On-Premises API?

Cloud API is the version of the WhatsApp Business API that Meta hosts: you call it over HTTPS and Meta runs the infrastructure. The On-Premises API was a client that businesses or their providers hosted on their own servers. Meta shut On-Premises down on October 23, 2025, so Cloud API is the only hosting option left.

Is the WhatsApp On-Premises API still available?

No. According to Meta's sunset page, new features stopped shipping to On-Premises in January 2024, new phone numbers could only be registered on Cloud API from July 1, 2024, and the final On-Premises version (v2.63) expired on October 23, 2025. Since then, messages sent to or from numbers still registered on On-Premises are not delivered.

How do I move a WhatsApp number from On-Premises to Cloud API?

The number has to be registered on Cloud API, which Meta only allows through the API, with a six-digit two-step verification PIN. Meta's documentation says numbers coming from On-Premises need extra steps first, so the simplest route is a provider that onboards you through Meta's Embedded Signup. If you also change provider, Meta's migration flow keeps your display name, quality rating, messaging limit and eligible templates.

How much does the WhatsApp Cloud API cost?

There is no server to pay for: Meta charges per message. Since July 1, 2025, you pay when a template message is delivered, at a rate set by the template category and the recipient's country calling code. Free-form replies and utility templates sent inside the 24-hour customer service window are not charged until September 30, 2026; Meta starts charging both on October 1, 2026. Your provider's plan comes on top.

Can I choose where the WhatsApp Cloud API stores my message data?

Yes. Local storage, enabled per phone number, keeps message content at rest in the country you pick, for example Germany for the EU, Switzerland or the United Kingdom. Meta may still process message content in data centers outside that country for up to 60 minutes while it is in use.

Nicolas Provost
Nicolas ProvostWhatsApp Marketing & Shopify Expert at Kanal

Nicolas helps e-commerce brands grow revenue with WhatsApp marketing. With deep expertise in Shopify ecosystems and conversational commerce, he shares proven strategies for abandoned cart recovery, broadcast campaigns, and AI-powered customer engagement.

Share this article
Discuss with AI

Ready to boost your WhatsApp sales?

ShopifyInstall with Shopify

Glossary terms in this article

Quick definitions for the WhatsApp Business terms used above.

WhatsApp Cloud API

The WhatsApp Cloud API is the version of the WhatsApp Business API hosted directly by Meta in the cloud, so businesses do not need to run their own servers.

Read full definition

On-Premise API

The On-Premise API is the legacy version of the WhatsApp Business API that businesses hosted on their own servers. Meta has been deprecating it in favor of the Cloud API.

Read full definition

WhatsApp Business Platform

The WhatsApp Business Platform is the umbrella name for the set of products and APIs that Meta offers businesses to message customers programmatically at scale.

Read full definition

Webhook

A webhook is an automatic notification WhatsApp sends to a business application whenever an event happens, such as an incoming message or a delivery status update.

Read full definition

Messaging Limits

Messaging limits define how many unique customers a business can start conversations with in a rolling 24-hour period. New numbers start low and scale up with good quality.

Read full definition

Customer Service Window (24-hour window)

The customer service window is the 24-hour period, opened by a customer message, during which a business can reply with free-form messages instead of approved templates.

Read full definition

Quality Rating

The quality rating is a score WhatsApp assigns to a business phone number based on recent customer feedback, mainly blocks and reports. It influences messaging limits.

Read full definition

WhatsApp Business App

The WhatsApp Business App is a free mobile application designed for small businesses to chat with customers, with a catalog, quick replies, and automated greeting messages.

Read full definition

Utility Template

A utility template is a message template that delivers information tied to a specific transaction or account, such as order confirmations, shipping updates, and appointment reminders.

Read full definition

Marketing Template

A marketing template is a message template categorized as promotional, used for offers, product launches, and campaigns. It requires opt-in and is the most heavily reviewed template category.

Read full definition

AI Agent

An AI agent is a conversational assistant that autonomously answers customers, qualifies their needs, and guides them to a purchase, going beyond the scripted replies of a classic chatbot.

Read full definition

WABA (WhatsApp Business Account)

A WABA (WhatsApp Business Account) is the account-level container on Meta's side that holds everything a business owns on WhatsApp: phone numbers, message templates, and the business profile.

Read full definition

Embedded Signup

Embedded Signup is Meta's guided onboarding flow that lets a business create or connect a WhatsApp Business Account from inside a third-party platform, through an OAuth popup, in minutes.

Read full definition

Official Business Account (green tick)

An Official Business Account is a WhatsApp business account that has earned a verified badge, the green tick, shown next to its name to confirm Meta has verified the brand.

Read full definition

Opt-in

An opt-in is the explicit permission a customer gives a business to contact them on WhatsApp. It is required before a business can send any message.

Read full definition
Get Started

Turn WhatsApp into your #1 sales channel

Install Kanal in 5 minutes and launch your first WhatsApp flow today.

5/5 on Shopify/500+ brands trust us
WhatsApp Cloud API vs On-Premises: What the 2025 Sunset Means | Kanal