WhatsApp Business API, explained for small teams
How the WhatsApp Business Platform works for a small team: setup, the 24-hour window, templates, Meta's per-message pricing, messaging limits and opt-in.
On this page
WhatsApp has two products for businesses, and they work very differently. This guide explains the difference, what you need to set up the API side, and the rules that catch small teams out: the 24-hour window, templates, pricing, messaging limits and opt-in.
The Business app vs the Business Platform
The WhatsApp Business app is a phone app built for small business owners. It helps you show your products, greet people when they start a chat, and reply when you’re away (WhatsApp Business).
The WhatsApp Business Platform is an API. Its Cloud API lets software send messages through Meta’s Graph API and receive them through webhooks (Meta). Meta’s documentation for it is written for developers. In practice, a small team uses the platform through a provider whose inbox is built on the API.
| Business app | Business Platform (Cloud API) | |
|---|---|---|
| Built for | Small business owners | Developers and the software they build |
| Where you use it | On a phone | In an inbox or tool built on the API |
| How incoming messages arrive | In the app | As webhooks to your software |
One number can’t normally be on both. A number already in use with WhatsApp must be deleted from WhatsApp before you can register it on the platform (Meta). The exception: some providers can connect an existing Business app number to the Cloud API. You keep using the app for one-to-one chats, and history stays in sync (Meta). Ask your provider whether it supports this before you delete anything.
What you need to get started
- A Meta business portfolio. It holds your WhatsApp assets, and you can’t use the platform without one (Meta).
- A phone number that meets the rules. It must be yours, have a country and area code (short codes are not supported), and be able to receive a voice call or SMS for the verification code (Meta). Once registered, the number still works for normal calls and texts, just not in a WhatsApp app. New portfolios can register two numbers. The cap rises to 20 once your business is verified or reaches the 2,000 messaging limit.
- A display name. You set it when you register the number. When you reach a higher messaging limit, Meta checks it against its display name guidelines. If it’s rejected, you can edit it or appeal. You can change it up to 10 times in 30 days (Meta).
- Business verification. It’s optional to start, but it matters. Verification is one way to raise your messaging limit from 250 to 2,000 (Meta). It also raises the template cap from 250 to 6,000 per account, provided a number has an approved display name (Meta).
- A payment method. Without one, Meta delivers service messages only within the monthly free tier described below (Meta).
The 24-hour customer service window
When a customer messages or calls your business number, a 24-hour customer service window opens. Each new message or call from them resets it to 24 hours. While it’s open, you can send any message: text, images, documents. When it’s closed, you can only send an approved template (Meta).
This shapes daily work. Answer quickly, and resolve things in the same window where you can. If the window closes before you’re done, send a utility template about their open request. If they reply, a new window opens.
There’s one special case. If someone messages you from a click-to-WhatsApp ad on Android or iOS and you reply in time, a free entry point window opens. It can stay open for up to 7 days, and Meta doesn’t charge for marketing, utility, authentication or service messages inside it (Meta).
Templates and their categories
Templates are pre-approved messages with variables, such as an order number. Each template has a name and a language, and you can keep one name across several languages (Meta). Every template falls into one of three categories (Meta):
- Marketing: awareness, offers, retargeting, relationship messages. Templates that mix utility and promotion, or whose content is unclear, also count as marketing.
- Utility: must be non-promotional, and either tied to a specific user request or transaction or essential to the user. Order confirmations and account alerts fit here.
- Authentication: one-time codes that verify a user’s identity.
Review and quality
Review combines automated checks with manual review, and a decision can take up to 24 hours. Common rejection reasons include malformed variables such as missing braces, a template that starts or ends with a variable, duplicate wording, and asking for sensitive data such as full card numbers (Meta).
Approval isn’t permanent. If a template reaches the lowest quality rating, Meta pauses it for 3 hours, then 6 hours the next time, and disables it on the third (Meta).
A note for US teams
The rule covers marketing templates. Utility and authentication templates and free-form replies fall outside it. For promotions to US customers, plan on another channel.
How Meta charges, as of November 2026
Since July 1, 2025, Meta charges per message, not per conversation. You pay only for delivered messages from your business to customers. Messages customers send you are free. Rates depend on the message category and the recipient’s country calling code (Meta).
On October 1, 2026, Meta resumed charging for two kinds of messages that had been free. Every business phone number now gets 1,000 free service messages a month, which don’t roll over. The 1,001st service message in a month is charged. Utility templates sent inside an open window are now charged too (Meta).
| Message type | When you can send it | Meta’s charge |
|---|---|---|
| Marketing template | Any time, to opted-in users | Per delivered message |
| Utility template | Any time, to opted-in users | Per delivered message, inside or outside the window |
| Authentication template | Any time, to opted-in users | Per delivered message |
| Service message (free-form reply) | Only inside an open window | First 1,000 a month per number free, then per message |
| Any of the above in a free entry point window | Inside that window | Free |
Utility and authentication messages get volume tiers that lower the rate as monthly volume grows. Meta changes prices only on January 1, April 1, July 1 or October 1, with at least a month’s notice for rate changes. Solution providers and directly integrated businesses whose billing country is India must move their WhatsApp billing to rupees by December 31, 2026 (Meta). Check Meta’s current rate card for your customers’ countries before you budget.
What a message costs through a provider
Meta’s fee is only part of the bill: your provider adds its own. Telnyx, for example, passes Meta’s fees through unchanged and adds $0.004 per message, with no platform fee, minimum spend or contract. For the North America market, it lists Meta’s rates as of November 15, 2026 at $0.0250 for a marketing template, $0.0034 for a utility template and $0.0034 for an authentication template (Telnyx).
Here is one month for a small US team with one number. It’s an example, not a quote:
| Messages sent | Meta’s fee | Provider fee at $0.004 |
|---|---|---|
| 400 utility templates, to reopen conversations | 400 × $0.0034 = $1.36 | $1.60 |
| 800 replies inside open windows | $0, inside the 1,000 free service messages | $3.20 |
| Total | $1.36 | $4.80 |
That is $6.16 for 1,200 messages, about half a cent each. Two things change the sum most: whether your replies stay inside the free service allowance, and how many templates you send to reopen windows that closed.
Messaging limits
A messaging limit is the number of unique customers you can message outside a customer service window in a moving 24-hour period. It’s set for the whole business portfolio, so all your numbers share it (Meta).
- New portfolios start at 250.
- You reach 2,000 by verifying your business, having your partner verify it, or sending 2,000 delivered template messages to unique users outside customer service windows within 30 days, using high-quality templates.
- After that, the limit steps up to 10,000, 100,000 and unlimited. It rises automatically when your quality is high and you’ve used at least half your limit in the last 7 days. Each step happens within 6 hours.
Replies inside an open window don’t count, so a team that mostly answers inbound messages is less likely to reach the limit.
Opt-in
You need opt-in before you message anyone on WhatsApp. It can be general rather than WhatsApp-specific, as long as it follows local law. It must make clear that the person is agreeing to messages from your business, and it must name your business. SMS, a web form, an IVR flow and a signed paper form all work (Meta).
Meta also suggests collecting opt-in by message category, explaining how to opt out, and honoring those requests. People can block or report you, and Meta rate-limits businesses whose quality stays low.
Common mistakes
- Deleting your Business app number too early. Check whether your provider can connect it to the API first.
- Adding a promo line to a utility template. Mixed content counts as marketing.
- Planning marketing templates for US customers. They aren’t delivered to US numbers.
- Treating replies as free. Service messages are free only up to 1,000 a month per number.
- Skipping the payment method. Service messages stop at the free tier without one.
- Messaging cold lists. It breaks the opt-in rule, and blocks and reports lower your quality, which can pause templates and keep your messaging limit from rising.
- Letting windows lapse. A free-form follow-up after 24 hours fails, so keep a short utility template ready to re-open the conversation.
How KNOQRA handles this
KNOQRA puts WhatsApp and SMS threads in one inbox, and each contact has a full timeline. The composer shows whether the 24-hour window is open. When it’s closed, you pick an approved template by its Meta template name and language. Consent is logged per channel in an append-only record, STOP and START work per channel, and the setup page checks your WhatsApp registration status. Broadcasts are planned but not built yet.
KNOQRA sends WhatsApp through Telnyx, with no fixed monthly fee. It is on the Pro ($39 a month) and Max ($79 a month) plans: you pay Meta’s fee plus 0.4¢ a message on Pro, which is the arithmetic in the example above, or plus 0.3¢ on Max. A $10 activation is credited back to your WhatsApp balance. Starter ($15 a month) covers calls and SMS only. See pricing.
Sources
- WhatsApp Business: WhatsApp Business app
- Meta for Developers: About the WhatsApp Business Platform
- Meta for Developers: Business phone numbers
- Meta for Developers: Onboard WhatsApp Business app users (coexistence)
- Meta for Developers: Display names
- Meta for Developers: Messaging limits
- Meta for Developers: Template fundamentals
- Meta for Developers: Pricing on the WhatsApp Business Platform
- Telnyx: WhatsApp pricing
- Meta for Developers: Template categorization
- Meta for Developers: Template review
- Meta for Developers: Template pausing
- Meta for Developers: Per-user marketing template message limits
- Meta for Developers: Get opt-in for WhatsApp
Fees and rules change: check the source before you rely on a number. This post is general information, not legal advice.