WhatsApp Business API:the complete guide
Everything you need to decide and set up to use the official WhatsApp Business API: access, number, verification, costs, templates, campaigns and AI customer service. Written by a Meta Tech Provider and Gupshup partner.
Official partner
Meta Tech Provider
Partnership
The guide in one paragraph
To run WhatsApp across a business, the path is the official WhatsApp Business API, which Meta now offers as the Cloud API. You need a Meta business portfolio, a free number (or coexistence, which keeps the number on the app), an approved display name and a payment method. You can connect directly, through a Tech Provider platform with Embedded Signup, or through a BSP. Meta bills per delivered message, the business can reply freely for 24 hours after the customer's last message and, outside that window, can only send approved templates to people who gave opt-in.
Facts checked against Meta's developer documentation and the WhatsApp Help Center on November 16 and 17, 2026. Meta's rules change; check the links in each chapter.
- Access
- Official WhatsApp Business API (Cloud API, hosted by Meta)
- Meta billing
- Per delivered message, priced by category and country, since July 1, 2025
- Free
- Customer messages and 1,000 service messages per number each month
- Window
- 24 hours from the customer's last message; outside it, only approved templates
- Starting limit
- 250 unique contacts per 24 hours outside the window, raised by verification
- Current number
- Migrates to the API or stays on both the app and the API with coexistence
- Blue badge
- Official Business Account: verified business and 30 days on the platform
- At Tolky
- Meta Tech Provider and Gupshup partner, with AI, people and CRM on the same number
Chapter 01
WhatsApp Business app or the official API?
The official WhatsApp Business API is the Meta-authorized way to connect a number to systems, AI agents and CRMs. The WhatsApp Business app was built for one person replying from a phone. Once customer service involves a team, volume, campaigns or automation, the API is the way to go.
| Criterion | WhatsApp Business app | Official API (Cloud API) | Unofficial tools |
|---|---|---|---|
| Built for | One person or a small team on a phone | Businesses with teams, volume and systems | No one: they mimic WhatsApp Web |
| Who replies | The main phone and up to four linked devices | Several people and AI agents on the same number | One browser session |
| Automation and AI | Quick replies and simple automated messages | AI agents, flows and software integrations | Bots outside Meta's rules |
| Campaigns | Broadcast lists | Campaigns with approved templates and opt-in | Uncontrolled mass messaging |
| CRM and systems | No integration | API, webhooks and CRM | Unstable and unsupported |
| Meta cost | Free | Per delivered message | No Meta charges, with a risk of being banned |
| Risk to the number | Low | Low, if you follow the policies | High: the number can be blocked |
Signs it is time for the API
More than one person needs to reply on the same number.
Conversations get lost across phones and no one knows the customer's history.
Customers write after hours and wait until the next day.
The business wants to send notices and campaigns to an opted-in audience.
The sales team needs to see in the CRM what was discussed.
The former On-Premises API, installed on the company's own servers, was shut down on October 23, 2025. Since July 1, 2024, new numbers can only be registered on the Cloud API, hosted by Meta. There is no server to install.
Sources: On-Premises API sunset and benefits of the official API.
Chapter 02
Three paths to the official API
There are three ways to use the official API: integrate directly with the Cloud API, connect through a Tech Provider platform with Embedded Signup, or sign up through a BSP. All three lead to the same place, a number registered on the Cloud API. What changes is who handles the technology, who owns the account and who bills the messages.
| Path | How it works | Who bills the messages | Best for |
|---|---|---|---|
| Direct on the Cloud API | The business creates an app on Meta for Developers, generates tokens and builds its own integration | Meta, on the business's account | Engineering teams that will build their own system |
| Tech Provider platform | The business logs in with Meta inside the platform (Embedded Signup) and connects the number in a few screens | Meta, on the business's account | Teams that want to serve customers, sell and automate without writing code |
| BSP (Solution Partner) | A Meta partner business solution provider makes the connection and may offer its own support and billing | Depends on the contract with the BSP | Teams that prefer a contract and support from a provider |
A Tech Provider is a technology company approved by Meta to connect customers' numbers to the Cloud API through Embedded Signup. To get there, it goes through Meta's business verification and app review. According to the documentation, a Tech Provider can offer messaging services on its own to the customers it has connected, or work with a Solution Partner to offer them jointly.
Embedded Signup is the flow in which the Meta login opens inside the partner's platform. The business authorizes access, creates or picks the WhatsApp account and verifies the number without leaving the tool, and the account stays in the business's own portfolio.
What to ask any provider
Does the WhatsApp account sit in my company's portfolio or the provider's?
Does Meta bill my account directly, or are charges passed through with a fee?
Does the provider offer coexistence to keep the number on the app?
Can I take the number to another provider if I leave?
Does the provider already support the BSUID and handle contacts without a phone number?
Sources: Tech Providers at Meta and Embedded Signup overview, consulted on November 17, 2026.
Tolky is a Meta Tech Provider and a Gupshup partner
That is why Tolky connects your number to the official WhatsApp Business API in two ways: directly with Meta, through Embedded Signup, or through Gupshup, a Meta Solution Partner.
Official partner
Meta Tech Provider
Direct connection
Directly with Meta (Cloud API)
Tolky is a Meta Tech Provider: it passed Meta's business verification and app review to connect customers' numbers to the Cloud API through Embedded Signup, with no intermediary between you and Meta.
Connect with Meta button, nothing to install
WhatsApp account in your company's portfolio
Messages billed by Meta directly to your account
Coexistence when enabled for your account
Makes sense when
You want the Meta account and portfolio under your control and message billing directly with Meta.
Gupshup partnership
Through Gupshup, a Meta Solution Partner
Tolky partners with Gupshup, a messaging provider and official Meta partner (Solution Partner). Gupshup bridges the connection to the API, and Tolky uses that connection to serve customers and send campaigns.
Connection through the Gupshup account
Same Meta rules for the window, templates and pricing
The same Tolky agents, customer service, campaigns and CRM
An option for numbers already connected to Gupshup
Makes sense when
You prefer to operate through a messaging partner or your number is already connected to Gupshup.
According to Meta's documentation, a Tech Provider can offer messaging services on its own to the customers it has connected, or work with a Solution Partner to offer them jointly. Tolky does both, and on either path the number uses the official API, with the same Meta rules for the window, templates, limits and pricing.
Source: Tech Providers in Meta's documentation, consulted on November 17, 2026.
Chapter 03
What to prepare before connecting
Before any sign-up, gather five items: admin access to a Meta business portfolio, the number, the display name, the company details for verification and a payment method. Most delays come from these details, not from the technology.
| Item | What Meta requires | Where to set it up |
|---|---|---|
| Account and portfolio | A Facebook account or Meta managed account and a business portfolio in the company's name | Meta Business Suite |
| Phone number | A number with country and area code that can receive SMS or a call; short codes are not accepted | Embedded Signup or WhatsApp Manager |
| Free number | Not on another WhatsApp account, except through coexistence | WhatsApp app on the phone |
| Display name | A name tied to the brand and within Meta's guidelines | WhatsApp Manager |
| Two-step PIN | A 6-digit PIN set when registering the number | WhatsApp Manager or API |
| Payment | A payment method on the messaging account; in Brazil, billing in BRL since July 1, 2026 | Meta Business Suite |
| Common mistake | What happens | How to avoid it |
|---|---|---|
| Account created in the agency's portfolio | The business loses control of the number | Create the account in the business's own portfolio |
| Generic name or a person's name | Name rejected and sending limited | Use the brand name, the same as on the website |
| Verification details that differ from the company registration number (CNPJ in Brazil) records | Verification rejected | Copy the legal name and address from the official registration |
| Number behind an IVR | The verification code never arrives | Make sure the SMS or call reaches a person |
| Wrong currency on the account | The currency cannot be changed later | Choose BRL at creation if the business invoices in Brazil |
Sources: getting started with the Cloud API, business phone numbers and platform pricing, consulted on November 16, 2026.
Chapter 04
How to connect your number to the official API, step by step
With Embedded Signup, the connection takes five steps and can be finished the same day when the portfolio, number and name are ready. Business verification and name review can take longer, and Meta does not publish a fixed timeframe for them.
- 1
Organize the business portfolio
Confirm who is an admin of the portfolio in Meta Business Suite. The WhatsApp account needs to sit in your company's portfolio, not in an agency's or an employee's.
- 2
Choose the path and the provider
Decide whether to integrate directly, use a Tech Provider platform or sign up with a BSP. If you want to keep the number on the phone, confirm that the provider offers coexistence.
- 3
Log in with Meta and verify the number
In Embedded Signup, log in with your Meta account, pick the portfolio, create or pick the WhatsApp account and enter the number. Meta sends a code by SMS or phone call.
- 4
Set the display name and PIN
Enter the name customers will see and set the 6-digit two-step verification PIN. Keep the PIN safe: it is required to change the PIN or delete the number.
- 5
Set up payment and test
Add the payment method for the messaging account, confirm that the number is connected and run a test conversation before promoting the channel.
At Tolky: in Settings, open the WhatsApp connection, choose Meta (the Connect with Meta button) or Gupshup, log in with your Meta account, connect the number and choose which AI agent handles it. See the WhatsApp integration.
Sources: how to get the official WhatsApp API, based on Meta's documentation.
Chapter 05
Your current number: migrate or use coexistence
You do not need to change numbers: you can delete the app account and register the number on the API, or use coexistence to keep the same number on the WhatsApp Business app and the API at the same time. Coexistence is enabled through the Embedded Signup of a Meta partner that offers the feature.
| Criterion | Coexistence | Full migration |
|---|---|---|
| Number on the phone app | Stays | Leaves the app |
| Previous history | Up to 180 days of one-to-one chats synced | Not brought into the API |
| Messages sent from the app | Free | There is no app |
| Throughput | Fixed at 20 messages per second | Follows Cloud API capacity |
| Broadcast lists | Disabled; existing ones become read-only | Replaced by template campaigns |
| Groups | Stay on the app, not synced with the API | Not applicable |
| Disconnection risk | If the main phone is inactive for about 14 days | Does not depend on a phone |
| Best for | Small and mid-sized operations and gradual transitions | High volume and large teams |
Coexistence requirements and rules
WhatsApp Business app version 2.24.17 or later.
The API's 24-hour customer service window only opens with messages the customer sends after the connection; conversations on the app do not open the window.
Connecting unlinks companion devices, which must be linked again; WhatsApp for Windows and WearOS are not supported.
The platform has 24 hours after the connection to sync the history.
Availability depends on the number, the country and the provider.
At Tolky, when coexistence is enabled for your account, the number stays on the app and conversations also appear on the platform. If someone on the team replies from the phone, the AI pauses in that conversation.
Sources: onboarding WhatsApp Business app users, consulted on November 16, 2026, and WhatsApp coexistence.
Chapter 06
Business verification and messaging limits
Every new portfolio starts with a limit of 250 unique contacts per 24 hours for messages outside the customer service window, and business verification is what unlocks the next tiers. The limit does not affect people who message the business first, only the contacts the business initiates.
Messaging limit tiers (unique contacts in 24 hours, outside the window)
250
New portfolio
2,000
Verified business or high-quality sending
10,000
Next tier
100,000
Next tier
Unlimited
Top tier
How to reach 2,000: verify the business (or have verification done by the signup partner) or send 2,000 messages outside the window to unique numbers within 30 days, using high-quality templates.
The limit belongs to the portfolio, shared across all of its numbers.
Numbers per portfolio: starts with two registered numbers and rises to 20 when the business is verified or reaches the 2,000 limit.
Business verification: done in the Security Center of Meta Business Suite, with a legal name, address, phone and website that match the company's registration. Meta may ask for documents, such as the company registration number (CNPJ in Brazil) certificate.
Sources: messaging limits, business phone numbers and business verification, consulted on November 16, 2026.
Chapter 07
Blue badge: Official Business Account and Meta Verified
The Official Business Account is the status Meta grants to API numbers of verified businesses, and it shows a blue check mark next to the name. The old green badge is now blue. For businesses that only use the app, the path is Meta Verified, a paid subscription, where available.
Meta's five criteria to request the badge
The business complies with the WhatsApp Business Messaging Policy.
It has been registered on the WhatsApp Business Platform for at least 30 days.
The business portfolio that owns the number has been verified.
The number has two-step verification turned on.
The number's display name has been approved.
| Status | For whom | How to get it |
|---|---|---|
| Business account | Every number on the app or the API | Automatic when the account is created |
| Official Business Account (blue badge) | API numbers of verified businesses | Request in WhatsApp Manager, reviewed by Meta |
| Meta Verified for Business | WhatsApp Business app accounts, where available | Paid subscription, reviewed by Meta, with no guarantee of the badge |
Once approved, besides the badge, the number starts appearing in WhatsApp search. The badge does not change limits, per-message pricing or the rules for templates and opt-in. If the request is denied, a new one can only be made after 30 days. Meta always makes the final decision, and app numbers are not eligible for the status: businesses using coexistence should confirm eligibility before requesting it.
Sources: Official Business Accounts and Meta Verified on WhatsApp, consulted on November 16, 2026. Step by step in WhatsApp Official Business Account.
Chapter 08
How much the WhatsApp Business API costs
Meta has billed per delivered message since July 1, 2025, priced by category and country, and since October 1, 2026 it also bills service and utility messages inside the window. Each number gets 1,000 free service messages per month, and messages the customer sends are never billed. The platform charges for its software separately.
| Category | Typical use | How it is billed |
|---|---|---|
| Marketing | Campaigns, offers and re-engagement | Per delivered message, at the highest rate; check the official rate card |
| Utility | Confirmations, order updates and alerts | Per delivered message, including inside the window since October 1, 2026, with volume tiers |
| Authentication | Verification codes | Per delivered message, with volume tiers |
| Service | Free-form replies inside the customer service window | Per delivered message since October 1, 2026, with 1,000 free per number each month |
| Meta Business Agent | Replies from Meta's own AI agent | Per token: US$2.00 per million tokens |
Reference for Brazil: Meta's pricing page lists US$0.0068 per message for service, utility and authentication. The marketing rate varies and should be checked on the official rate card.
Currency: in Brazil, Meta has billed in BRL since July 1, 2026, with accounts switched over gradually.
No delivery charge: messages inside a free entry point window, such as the one opened by Click-to-WhatsApp ads.
When it changes: Meta only changes rates on January 1, April 1, July 1 or October 1.
What weighs most: the number of messages per conversation. Solving it in the first reply costs less than fifteen back-and-forths.
Estimate Meta's monthly cost with your volume, no sign-up needed.
Sources: platform pricing and non-template messages, consulted on November 15, 2026. A worked example with assumptions in WhatsApp Business costs in Brazil; Tolky plans on pricing.
Chapter 09
24-hour window, templates and opt-in
The 24-hour customer service window is the period, counted from the customer's last message, during which the business can reply with free-form messages. Each new message from the customer restarts the count. Outside the window, the business can only send approved templates, and always to people who gave opt-in.
| Template category | What it is for | The rule that matters most |
|---|---|---|
| Marketing | Offers, news and re-engagement | The most flexible; mixed or unclear content falls here |
| Utility | Following up on an order or a customer action | No promotional content; if it has any, it may be reclassified as marketing |
| Authentication | One-time passwords and identity verification | The most restricted: a template from Meta's library, with no URL, media or emoji |
Approval: every template goes through automatic review when created or edited; in WhatsApp Manager, it can take up to 24 hours.
Template quality: pending, high, medium or low. A low-quality template can be paused or disabled.
Opt-in: whether or not the window is open, the business can only message people who gave permission. Record when, where and for what type of content the customer agreed, and offer a simple way out.
For AI too: an AI agent can reply freely while the window is open and, after it closes, needs a template.
Sources: sending messages, templates and template categorization, consulted on November 16, 2026. Ready-made examples in WhatsApp message templates.
Chapter 10
WhatsApp campaigns without taking down your number
A safe campaign combines an opted-in audience, a template in the right category, gradual volume and someone ready to talk when the customer replies. The number's quality reflects how users received your messages over the last seven days: blocks, reports, mutes and archives count against it.
- 1
Confirm opt-in across your list
Separate the people who agreed to receive messages and remove those who asked to opt out.
- 2
Segment by intent and timing
Send to people who have a reason to read, by funnel stage, purchase history or interest.
- 3
Pick the category by the actual content
An offer is marketing; an order status is utility. Disguising an offer as a notice leads to reclassification.
- 4
Write a clear template
Use variables such as name and order, say who is writing and why the message arrived, and offer a way out.
- 5
Ramp up volume gradually
Start with part of your list, track blocks and quality, and stay within the portfolio's limit.
- 6
Be ready for the reply
When the customer replies, the window opens. Have the AI or the team ready: a campaign that does not talk back wastes the interest.
At Tolky, text campaigns go out on WhatsApp (official API) with a template or free text, variables and media, to an audience from an XLS or CSV spreadsheet, individual contacts or CRM opportunities, and replies land in AI customer service. See text campaigns.
Sources: messaging limits, consulted on November 16, 2026, and 24-hour window, templates and campaigns.
Chapter 11
AI, team and CRM customer service on the same number
With the official API, the same number can be handled by AI agents and by people, with each contact's history logged in a CRM. The setup that works is simple: the AI resolves what it can, hands off to a person when the case calls for it, and everything stays in the same history.
| Stage | What the AI does | When the team steps in |
|---|---|---|
| First reply | Replies instantly, at any hour, and understands intent without a long menu | No need to step in |
| Questions and requests | Checks the knowledge base and integrated systems | When information or permission is missing |
| Sales | Qualifies the contact and logs the opportunity in the CRM | During negotiation and closing |
| Sensitive cases | Recognizes the topic and transfers with a conversation summary | For complaints, collections and exceptions |
| After the conversation | Logs the history and can send the NPS survey | When reviewing cases and the AI's answers |
Before turning on AI for the number
Define what the AI resolves on its own and what always goes to a person.
Write the handoff rules and make sure the AI stops when someone takes over.
Build the knowledge base with the answers the team already gives every day.
Measure messages per conversation, AI resolution and first response time.
Connect WhatsApp to the CRM: WhatsApp alone is not a CRM, and an unrecorded opportunity gets lost.
Tolky is a conversational AI CRM: AI agents serve customers on WhatsApp and hand off to people with the full history, operators can pause the AI in any conversation, Flows define routing, and conversations stay linked to the contact in Tolky's own CRM, with a native HubSpot integration. Tolky's voice agent also answers calls made through WhatsApp. See WhatsApp customer service.
Sources: how to choose an AI agent for WhatsApp and WhatsApp is not a CRM.
Chapter 12
What changed in WhatsApp Business: timeline
The biggest recent changes are per-message billing, billing for service messages and the arrival of the BSUID and usernames, which mean the customer's phone number is no longer guaranteed. The CRM needs to store each contact with phone number, BSUID and username.
Jul 1, 2024
New numbers can only be registered on the Cloud API.
Jul 1, 2025
Meta replaces per-conversation billing with per-delivered-message billing.
Oct 23, 2025
The last version of the On-Premises API expires.
April 2026
The BSUID, a user identifier scoped to each business portfolio, appears in webhooks.
Jun 29, 2026
Businesses can reserve and adopt usernames.
Jul 1, 2026
In Brazil, billing switches to BRL; in July, sending by BSUID and the button to request the phone number arrive.
Oct 1, 2026
Service and utility messages inside the window become billable, with 1,000 free service messages per number each month.
Oct 23, 2026
A limit of two username changes every 14 days takes effect.
What to do now
Store each contact's phone number, BSUID and username in the CRM, with a unique internal key.
Review automations and reports that assume every contact has a phone number.
Use the request-phone-number button only when the process requires it, such as delivery or billing.
Ask your provider what is already live for the BSUID.
Sources: BSUID in Meta's documentation, BSUID and usernames on WhatsApp and what Gupshup is doing.
Chapter 13
Checklist to run WhatsApp across your business
Use this list to check whether WhatsApp is ready to run with your team, AI and campaigns. Each item maps to a chapter of this guide.
Meta business portfolio in the company's name, with two admins.
Path chosen: direct, Tech Provider or BSP, with the account in your portfolio.
Decision on the number: full migration or coexistence.
Display name matching the brand and two-step PIN stored safely.
Business verified with Meta, to move past the 250-contact limit.
Payment method in local currency (BRL in Brazil) added and cost estimated in the simulator.
Approved templates for the notices and campaigns the operation needs.
Opt-in records and an up-to-date opt-out list.
Handoff rules between AI and people, and who replies at each time of day.
Knowledge base reviewed before turning on the AI.
WhatsApp connected to the CRM, with contacts by phone number, BSUID and username.
Dashboard with messages by category, messages per conversation and number quality.
Official Business Account request after 30 days on the platform.
Blog articles about WhatsApp
The blog articles go deeper into the topics in this guide, with examples, tables and FAQs.
API and connection
4 articles
Pricing, templates and campaigns
2 articles
AI customer service
6 articles
- WhatsApp Customer Service Platform: The Ultimate Guide for Companies8 min read
- WhatsApp Chatbot: How it Works and How to Create One9 min read
- How to Choose an AI Agent for WhatsApp: A 12-Question Checklist10 min read
- Best WhatsApp AI agent platforms for businesses (2026)9 min read
- WhatsApp as a Customer Service Hub: Advantages, Risks, Implementation12 min read
- Integrate HubSpot with a WhatsApp AI Agent: Step by Step10 min read
Sales and CRM
2 articles
Questions about the WhatsApp Business API
It is Meta's official way to connect a WhatsApp number to systems, AI agents and CRMs. Today it is offered as the Cloud API, hosted by Meta, and it supports high volume, multiple people and automation on the same number.
The app was built for one person to reply from a phone, with up to four linked devices. The API connects the number to platforms, AI agents and CRMs, with templates, campaigns and team-based customer service. With coexistence, the same number can stay on both.
It is a technology company approved by Meta, after business verification and app review, to connect customers' numbers to the Cloud API through Embedded Signup. Tolky is a Meta Tech Provider.
A Tech Provider connects the customer's number to the Cloud API inside its own platform, and Meta bills the messages to the customer's account. A BSP (Solution Partner) is a Meta partner that provides access to the API and may offer its own support and billing. A Tech Provider can work with a Solution Partner, as Tolky does with Gupshup.
Yes. Tolky is a Meta Tech Provider and connects to the official WhatsApp Business API directly with Meta (Cloud API) or through Gupshup, an official Meta partner. When coexistence is enabled for your account, the number stays on the app and, if someone replies from the phone, the AI pauses in that conversation.
Meta has billed per delivered message since July 1, 2025, priced by category and country, and service and utility messages inside the window became billable on October 1, 2026, with 1,000 free service messages per number each month. Platforms charge for their software separately. Use the WhatsApp pricing simulator to estimate your cost.
No. You can delete the app account and register the same number on the API, or use coexistence, when available, to keep the number on the WhatsApp Business app and the API at the same time, with up to 180 days of history synced.
To get started, Meta asks for a business portfolio and a valid number. To verify the business and move past the limit of 250 contacts per day outside the window, you must prove the company's legal name, address and phone number, which in Brazil usually involves the company registration number (CNPJ in Brazil).
With the portfolio, a free number and the display name ready, the connection through Embedded Signup can be finished the same day. Business verification and name review can take longer, and Meta does not publish a fixed timeframe for them.
For API numbers, request the Official Business Account in WhatsApp Manager, with a verified business, an approved display name, two-step verification and at least 30 days on the platform. If you only use the app, the path is Meta Verified, when available. Meta always makes the final decision.
No. The business can only message people who gave opt-in, and outside the 24-hour customer service window only with approved templates. Campaigns without consent lead to blocks and reports, drag down the number's quality and can limit sending.
If the WhatsApp account sits in your company's portfolio, the number remains yours and can be connected to another provider by following Meta's migration process. That is why it pays to create the account in your own portfolio from the start.
Take your WhatsAppto the official API with AI
See Tolky serving customers on your number, with AI agents, people at the right moment and everything logged in the CRM. Let's talk.
