Skip to content
Complete WhatsApp Business guide

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.

Meta

Official partner

Meta Tech Provider

Partnership

Gupshup
Short answer

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.

CriterionWhatsApp Business appOfficial API (Cloud API)Unofficial tools
Built forOne person or a small team on a phoneBusinesses with teams, volume and systemsNo one: they mimic WhatsApp Web
Who repliesThe main phone and up to four linked devicesSeveral people and AI agents on the same numberOne browser session
Automation and AIQuick replies and simple automated messagesAI agents, flows and software integrationsBots outside Meta's rules
CampaignsBroadcast listsCampaigns with approved templates and opt-inUncontrolled mass messaging
CRM and systemsNo integrationAPI, webhooks and CRMUnstable and unsupported
Meta costFreePer delivered messageNo Meta charges, with a risk of being banned
Risk to the numberLowLow, if you follow the policiesHigh: 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.

PathHow it worksWho bills the messagesBest for
Direct on the Cloud APIThe business creates an app on Meta for Developers, generates tokens and builds its own integrationMeta, on the business's accountEngineering teams that will build their own system
Tech Provider platformThe business logs in with Meta inside the platform (Embedded Signup) and connects the number in a few screensMeta, on the business's accountTeams 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 billingDepends on the contract with the BSPTeams 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.

Official partnerships

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.

Meta

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

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.

ItemWhat Meta requiresWhere to set it up
Account and portfolioA Facebook account or Meta managed account and a business portfolio in the company's nameMeta Business Suite
Phone numberA number with country and area code that can receive SMS or a call; short codes are not acceptedEmbedded Signup or WhatsApp Manager
Free numberNot on another WhatsApp account, except through coexistenceWhatsApp app on the phone
Display nameA name tied to the brand and within Meta's guidelinesWhatsApp Manager
Two-step PINA 6-digit PIN set when registering the numberWhatsApp Manager or API
PaymentA payment method on the messaging account; in Brazil, billing in BRL since July 1, 2026Meta Business Suite
Common mistakeWhat happensHow to avoid it
Account created in the agency's portfolioThe business loses control of the numberCreate the account in the business's own portfolio
Generic name or a person's nameName rejected and sending limitedUse the brand name, the same as on the website
Verification details that differ from the company registration number (CNPJ in Brazil) recordsVerification rejectedCopy the legal name and address from the official registration
Number behind an IVRThe verification code never arrivesMake sure the SMS or call reaches a person
Wrong currency on the accountThe currency cannot be changed laterChoose 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. 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. 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. 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. 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. 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.

CriterionCoexistenceFull migration
Number on the phone appStaysLeaves the app
Previous historyUp to 180 days of one-to-one chats syncedNot brought into the API
Messages sent from the appFreeThere is no app
ThroughputFixed at 20 messages per secondFollows Cloud API capacity
Broadcast listsDisabled; existing ones become read-onlyReplaced by template campaigns
GroupsStay on the app, not synced with the APINot applicable
Disconnection riskIf the main phone is inactive for about 14 daysDoes not depend on a phone
Best forSmall and mid-sized operations and gradual transitionsHigh 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.

StatusFor whomHow to get it
Business accountEvery number on the app or the APIAutomatic when the account is created
Official Business Account (blue badge)API numbers of verified businessesRequest in WhatsApp Manager, reviewed by Meta
Meta Verified for BusinessWhatsApp Business app accounts, where availablePaid 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.

CategoryTypical useHow it is billed
MarketingCampaigns, offers and re-engagementPer delivered message, at the highest rate; check the official rate card
UtilityConfirmations, order updates and alertsPer delivered message, including inside the window since October 1, 2026, with volume tiers
AuthenticationVerification codesPer delivered message, with volume tiers
ServiceFree-form replies inside the customer service windowPer delivered message since October 1, 2026, with 1,000 free per number each month
Meta Business AgentReplies from Meta's own AI agentPer 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.

Open the simulator

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 categoryWhat it is forThe rule that matters most
MarketingOffers, news and re-engagementThe most flexible; mixed or unclear content falls here
UtilityFollowing up on an order or a customer actionNo promotional content; if it has any, it may be reclassified as marketing
AuthenticationOne-time passwords and identity verificationThe 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. 1

    Confirm opt-in across your list

    Separate the people who agreed to receive messages and remove those who asked to opt out.

  2. 2

    Segment by intent and timing

    Send to people who have a reason to read, by funnel stage, purchase history or interest.

  3. 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. 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. 5

    Ramp up volume gradually

    Start with part of your list, track blocks and quality, and stay within the portfolio's limit.

  6. 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.

StageWhat the AI doesWhen the team steps in
First replyReplies instantly, at any hour, and understands intent without a long menuNo need to step in
Questions and requestsChecks the knowledge base and integrated systemsWhen information or permission is missing
SalesQualifies the contact and logs the opportunity in the CRMDuring negotiation and closing
Sensitive casesRecognizes the topic and transfers with a conversation summaryFor complaints, collections and exceptions
After the conversationLogs the history and can send the NPS surveyWhen 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.

  1. Jul 1, 2024

    New numbers can only be registered on the Cloud API.

  2. Jul 1, 2025

    Meta replaces per-conversation billing with per-delivered-message billing.

  3. Oct 23, 2025

    The last version of the On-Premises API expires.

  4. April 2026

    The BSUID, a user identifier scoped to each business portfolio, appears in webhooks.

  5. Jun 29, 2026

    Businesses can reserve and adopt usernames.

  6. Jul 1, 2026

    In Brazil, billing switches to BRL; in July, sending by BSUID and the button to request the phone number arrive.

  7. Oct 1, 2026

    Service and utility messages inside the window become billable, with 1,000 free service messages per number each month.

  8. 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.

Frequently asked questions

Questions about the WhatsApp Business API

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.