What is the WhatsApp Business API and how to get started in 2026?
What the WhatsApp Business API is, who needs it, the three ways to get access, and the requirements, verification, templates and setup problems to expect.
The WhatsApp Business API is Meta's way for software to send and receive WhatsApp messages on a business phone number. Its official name is the WhatsApp Business Platform, and the part you connect to is the Cloud API, which Meta hosts. With it, a shared inbox, CRM, booking system or AI agent can answer customers on WhatsApp instead of one person on one phone.
You can get started in three ways: set up the Cloud API yourself in Meta's developer dashboard, sign up through a Meta partner, or connect your number to a messaging platform that handles the setup for you. Every route needs the same basics: a Meta business portfolio, a phone number that is not active on regular WhatsApp, a display name that passes review, and approved templates for any message you start.
Pick the Cloud API if you have a developer, a Solution Partner if you want one invoice and a support contract, and a platform if you want an inbox or AI agent ready to use.
What is the WhatsApp Business API?
It is a set of APIs, not an app. Meta's Cloud API sends and receives messages, the Business Management API handles accounts, phone numbers and templates, and webhooks deliver every incoming message and status update to your server. Meta's WhatsApp Business Platform overview lists each piece.
That has one practical consequence: there is no screen to answer customers from. Something has to sit on top of the API, whether that is code your developers write, a team inbox, a CRM or an AI agent. This is also why you can end up paying Meta for messages and a provider for the software, which our guide to WhatsApp Business API pricing breaks down.
In Meta's current setup, three assets live inside your business portfolio: a WhatsApp account for your business presence, including its phone numbers, a Messaging account that holds your templates and billing, and an app that is allowed to use them. Older guides call the second one a WhatsApp Business Account, or WABA, and you will still see that name in the API.
Who needs the WhatsApp Business API?
The free WhatsApp Business app is enough when one or two people answer from a phone and the volume is manageable. If that is you, our comparison of WhatsApp, WhatsApp Business and the API explains what the app can and cannot do.
You need the API when one of these is true:
- Several people need to answer the same number from their own computers, with each chat assigned to someone.
- You want an AI agent or chatbot to answer, including at night and on weekends.
- WhatsApp has to talk to another system, such as a booking engine, store, CRM or property management system.
- You send confirmations, reminders or updates to many customers and want them sent automatically.
- You need reporting on response times, volumes and outcomes across the team.
What are the ways to get WhatsApp Business API access?
Meta lets businesses connect on their own or through a partner. Partners come in two main types. Solution Partners, often called BSPs, can give you a credit line and invoice you for Meta's fees. Tech Providers onboard you through Meta's sign-up flow, and Meta then bills you directly for messages while the provider bills for its own software. Meta's partner documentation sets out the difference.
In practice, that leaves three routes:
| Route | Best for | Who bills Meta's message fees | Setup | Good to know |
|---|---|---|---|---|
| Cloud API on your own | Teams with a developer who want full control | Meta, to your payment method | Create a Meta app, register a number, host a webhook and build the interface | No provider fee. You build and maintain everything, and Coexistence needs a partner |
| Solution Partner (BSP) | Larger companies that want one invoice and a support contract | Usually the partner, on its credit line | The partner sets up the accounts for you | Check what comes with API access, such as an inbox or automation, and what the partner charges on top of Meta's fees |
| Platform that connects for you | Teams that want an inbox, automation or an AI agent ready to use | Meta if the platform is a Tech Provider, the platform if it is a Solution Partner | Sign in with Meta from the platform and pick or add a number | You depend on the platform's features, so check how it handles templates, handoff and your other systems |
Visito is an example of the third route: you connect your number from the Visito dashboard through Meta's sign-up flow, and your Visito plan is separate from Meta's message fees. If you are comparing API providers more broadly, our list of Twilio alternatives for WhatsApp covers twelve of them, including Meta's own Cloud API.
What do you need before you start?
Gather these before you open any setup screen. Most stalled setups are missing one of them:
- A Meta business portfolio, created at business.facebook.com, with at least one admin who has full control.
- A Facebook or managed Meta account for the person doing the setup, registered as a Meta developer if you go the Cloud API route.
- A phone number you own with a country and area code that can receive an SMS or a voice call. Short codes are not supported, and a mobile number is the easiest to verify.
- A number that is not active on WhatsApp. If it is, delete that WhatsApp account first or use Coexistence to keep the Business app on it.
- Your legal business details (name, address, phone and website) written exactly as they appear on official documents, and a website that loads over HTTPS.
- A payment method for Meta's message fees, unless a Solution Partner bills you.
- Opt-in from customers. Meta requires it before you send them templates, and the opt-in must name your business.
How do you set up the Cloud API yourself, step by step?
If you have a developer and want to connect directly, Meta's Cloud API get-started guide follows these steps:
- Create an app in the Meta App Dashboard, choose the "Connect with customers through WhatsApp" use case and attach your business portfolio.
- In API Setup, connect a Messaging account or create one. Meta also gives you a test number that can send test templates without a payment method.
- Generate a temporary access token and send the hello_world template to your own phone to confirm it works.
- Set up a webhook endpoint so your server receives incoming messages and delivery statuses.
- Create a system user in Business Settings and generate a permanent token with the business_management, whatsapp_business_messaging and whatsapp_business_management permissions. The temporary token expires quickly.
- Add your real phone number, verify it with an SMS or voice code, set a six-digit two-step verification PIN and register it for the Cloud API.
- Add a payment method, create your first templates and start building the interface your team or agent will use.
Sending a test message is the easy part. The real work comes after the last step: an inbox, assignment, storage, template management and monitoring. Budget for that before choosing this route.
How does Meta business verification work?
Business verification confirms to Meta that your portfolio belongs to a real, registered business. You can use the API without it, but at a small scale. Meta's messaging limits page says new portfolios can message 250 unique customers outside a customer service window in a moving 24-hour period. Verifying your business is one of the ways to reach 2,000. It also raises your cap from two registered phone numbers to 20 and is required before you can apply for the blue check, which Meta calls an Official Business Account.
To verify, an admin with full control opens Security Center in Meta Business Suite, clicks Start verification and enters the legal name, address, phone number and website. If Meta cannot find a matching record, it asks for documents such as a business license or articles of incorporation. You then confirm the connection by email, phone, text, WhatsApp message or domain verification.
Meta's business verification steps say a decision can take up to 14 business days, and editing your business details later means verifying again. Start verification on day one, because it is usually the slowest step. It is also not the same as Meta Verified, the paid subscription with a badge.
How do you get your display name approved?
Every API number needs a display name, the business name customers see on your WhatsApp profile. Meta reviews it against its display name guidelines, and an approved name can also show at the top of chats. The rules come down to three things: follow WhatsApp's policies, describe your real business, and show a clear link to your legal name or your public brand.
Names that get rejected tend to break one of these rules:
- A generic word or place on its own, such as "Fashion" or "New York".
- "Official" or "Verified" in the name.
- A mention of Meta, WhatsApp or Facebook.
- Promotional text, such as a discount or "best in town".
- A website or email address as the name.
- A brand that appears nowhere else. If the brand and the legal company differ, show the link on your website or use "Brand by Company".
Meta lets you change a display name up to 10 times in 30 days. After a new name is approved, the number has to be registered again within 14 days for the change to take effect.
What are message templates and when do you need them?
When a customer messages you, a 24-hour customer service window opens and you can reply with any message. Outside that window, Meta only lets you send templates: messages you write in advance and submit for approval. Confirmations, reminders, follow-ups and campaigns are all templates.
Each template has a category (marketing, utility or authentication), a language and optional variables such as {{first_name}} for details that change per customer. Categories also set what Meta charges. Meta reviews each template, with automated checks and sometimes a person, and decides within 24 hours. After that, it rates each template by how customers respond. Templates that get negative feedback or low read rates can be paused or disabled.
Meta's template review guide lists the usual reasons for rejection. Check yours against them before you submit:
- Variables written wrong, out of order, with symbols such as # or $, or at the very start or end of the message.
- Too many variables for a short message.
- Requests for full card numbers, ID numbers or other sensitive details.
- Content that breaks WhatsApp's Commerce Policy or threatens the customer.
- The same body and footer as a template you already have.
How many messages can you send?
Two different limits apply. The messaging limit counts unique customers you can reach outside a customer service window in a moving 24-hour period, and it is shared by every number in your business portfolio. It starts at 250, rises to 2,000 once you verify your business or send templates with a high quality rating to 2,000 unique customers in 30 days, and then climbs automatically to 10,000, 100,000 and unlimited. Meta raises it when your messages keep a high quality rating and you have used at least half your limit in the last seven days.
Throughput is about speed. A number can send up to 80 messages per second by default, and one message every six seconds to the same customer, with short bursts allowed. Replies inside an open customer service window do not count toward the messaging limit, so a team that mostly answers inbound questions rarely hits it.
Can you keep the WhatsApp Business app on the same number?
Yes, through what Meta calls onboarding WhatsApp Business app users, and most people call Coexistence. You keep answering from the app on your phone while software uses the API on the same number, and the chats stay in sync. During setup you can bring up to six months of one-to-one chat history and your contacts.
There are trade-offs. Meta's Coexistence documentation says only Solution Partners and Tech Providers can offer it, so you cannot set it up through the plain Cloud API on your own. Throughput is fixed at 20 messages per second, broadcast lists and disappearing messages are switched off, group chats are not synced, and linked devices are unlinked, with WhatsApp for Windows and Wear OS no longer supported as companions. If you rely on those features every day, a full API setup may suit you better, and the Coexistence setup steps show what each choice changes.
What are the most common setup problems?
These are the problems that come up most often, with the usual fix:
- "This number is already registered on WhatsApp." Delete the WhatsApp or WhatsApp Business account on that number first, or connect it through Coexistence. A banned number has to be appealed before it can be used.
- The verification code never arrives. Meta does not recommend SMS codes for landline, toll-free or VoIP numbers. Choose a voice call, and if the number sits behind a phone menu, allow the calling numbers Meta gives you and route the call to a person.
- Business verification is rejected. The details you entered do not match your documents or website. Copy the legal name and address exactly, make sure the website loads over HTTPS, then resubmit.
- The display name is rejected. Compare it with the guidelines above, edit it or appeal.
- A template is rejected. Read the reason in WhatsApp Manager, fix the variables or wording, add sample values and resubmit or appeal.
- You lost the two-step verification PIN. You can set a new one through the API without the old PIN.
- Messages stopped sending after a day. The temporary access token expired. Use a system user token.
- Incoming messages never reach your system. Check that your app is subscribed to the messages webhook field and that your endpoint is reachable from the internet.
- You cannot reply to a customer. The 24-hour window has closed, so you need an approved template.
- The limit is stuck at 250. Verify your business, or send high-quality templates to 2,000 unique customers in 30 days.
How do you put an AI agent on the WhatsApp Business API?
An AI agent on WhatsApp needs three things beyond the API connection: knowledge to answer from (your website, policies, prices and documents), actions in your own systems (checking availability, an order or a booking), and a clean handoff to a person when it should not answer. It also has to stay within WhatsApp's rules. WhatsApp's AI policy bans general-purpose AI assistants on the Business Platform but allows agents that serve your own customers.
You can build that on the Cloud API with a language model and your own code, use Meta Business Agent, which Meta now offers inside the platform, or use a platform with the agent, inbox and integrations already built. Building gives you full control and the most work. Meta's agent keeps everything with Meta. A platform trades some flexibility for speed, and WhatsApp AI agents differ mostly in how they connect to your systems and hand chats to people.
Visito is one of those platforms. Its WhatsApp AI agent answers from your content, calls your systems through native integrations or the Visito API, and passes the chat to your team in a shared inbox.
What else do people ask about the WhatsApp Business API?
Is the WhatsApp Business API free?
Meta does not charge to connect a number. You pay Meta per message according to its pricing rules, which depend on the message category and the customer's country, and any provider adds its own fee. Meta's rates are published on its platform pricing page.
Do I need a developer?
For the Cloud API on your own, yes, because you need a webhook server and an interface. Through a partner or a platform, no. You sign in with Meta, pick a number and the platform does the rest.
How long does it take to get started?
A test message takes minutes. Connecting a real number through a partner or platform is quick once your portfolio and number are ready. Business verification can take up to 14 business days, and each template review usually takes up to 24 hours.
Can I use my existing WhatsApp number?
Yes. Either delete it from the WhatsApp app and register it on the API, or keep the Business app on it with Coexistence. A number cannot be on regular WhatsApp and the API without Coexistence.
Can I send bulk messages?
Yes, with approved templates, to customers who opted in, within your messaging limit. Low-quality campaigns get templates paused and slow down limit increases, so send what customers expect.
Can I switch providers later?
Usually, yes. Before switching, ask the new provider how it moves your number, confirm who will own the Messaging account, and get your templates approved on the new account before you send.
How can you connect your WhatsApp number to Visito?
Visito connects your WhatsApp number through Meta's sign-up flow, with Coexistence if you want to keep the Business app, and puts an AI agent and a shared inbox on top. Your developers can work with the same conversations through the Visito API.
Start on the free plan with website chat and train the agent on your content. When it answers the way you want, add WhatsApp on a paid plan.
