Claryflow Black Friday: 20% Off on all plans
Claryflow

blog / What the WhatsApp Official API i...

By Matheus Melo
WhatsApp

What the WhatsApp Official API is: a complete guide to cost, setup and limits

What the WhatsApp Official API is: a complete guide to cost, setup and limits

What the WhatsApp Official API is

The WhatsApp Official API is the Cloud API of the WhatsApp Business Platform, the Meta infrastructure that lets a company send and receive WhatsApp messages through a system, not only through the phone app. According to Meta documentation, it is used to send messages, make and receive calls and manage group conversations, all programmatically.

In practice, it supports team inboxes, automations and large-scale broadcasts. You do not use the API directly: it comes inside a platform, such as a CRM, that connects your number and gives you a service screen.

How much the WhatsApp Official API costs

The cost of the Official API has two parts: the Meta fee per delivered message and the monthly fee of the platform you hire. Since July 1, 2025, Meta charges per message, by category and by recipient country, and only when the message is delivered. Messages sent by the customer to the business are not charged.

CategoryWhen it is usedFee in Brazil
MarketingTemplate with a promotional goalR$ 0.3217 per message
UtilityInformational or transactional template, such as an order confirmationR$ 0.035 per message
AuthenticationIdentity verification templateR$ 0.035 per message
ServiceReply inside the 24-hour windowR$ 0.035, after 1,000 free per month per number

The values above come from the Meta table in reais, in effect since October 1, 2026, and Meta may update them. For the history of the change, read the Meta pricing update. To understand the allowance, see the 1,000 free messages article. And to simulate your bill, use the Meta impact calculator.

Meta WhatsApp pricing update: what changed and how much it costsThe 1,000 free messages allowance of the WhatsApp APIMeta billing impact calculator

Is there a free WhatsApp API?

There is no fully free Official API for commercial use, but some parts are free. Among the no-charge situations Meta lists are messages inside a window opened by an ad that clicks to WhatsApp, which can stay open for up to 7 days, and the first 1,000 service messages per month per number. Beyond that, the company pays the fee for each delivered message.

If you see an API offer with no cost and no template rules, be careful. Solutions that promise this usually rely on unofficial methods, which do not follow Meta rules and put your number at risk of being blocked.

How to get the WhatsApp Official API

The simplest way to get the Official API is to subscribe to a platform that is a Meta partner and connect your number inside it. The integration is usually done through a Meta flow called Embedded Signup, where you sign in with your Facebook account, choose the business portfolio and authorize the platform.

  • Set aside a number you control and can receive a verification code on
  • Have a business portfolio on Meta, preferably with the business verified
  • Choose a platform that is a Meta partner and create the account
  • Connect the number through the Embedded Signup flow and authorize the platform
  • Register the message templates you will need and wait for approval
  • Test the service and automations with a small group before opening to your whole base

The required documents and business verification are detailed in the article about Official API requirements. According to Meta, those who already use the WhatsApp Business app can connect the existing account and keep the app working alongside, in a model called coexistence, with history synced between the two. In this model, Meta lists limitations: groups are not synced, broadcast lists and voice and video calls are not supported, and the app must be on version 2.24.17 or higher.

Requirements to connect WhatsApp to the Official API

How many messages the Official API lets you send

A new business portfolio starts able to reach 250 different people per rolling 24-hour period outside the customer service window. Meta raises this limit in steps, and it is shared by all numbers in the portfolio. After you complete one of the paths in the table, Meta reviews your message quality and approves or denies the increase. In the following steps scaling is automatic and, once the conditions are met, the limit goes up one level within 6 hours.

StepUnique contacts limit in 24 hoursHow to get there
Initial250New portfolio
Second2,000Verify the business (you or the partner platform) or deliver 2,000 messages with high-quality templates, outside the service window, within 30 days
Third10,000Automatic scaling: high-quality messages and use of at least half the limit in the last 7 days
Fourth100,000Automatic scaling
LastUnlimitedAutomatic scaling

Is the Official API worth it?

It is worth it when the app can no longer keep up: more than one person answering, a need to reply after hours, broadcasts to a larger base or sales that depend on reminding the customer at the right time. For a one-person operation with a few contacts per week, the free app is still enough.

The full comparison, with a criteria table, is in the article about WhatsApp Business and the Official API. The practical rule is simple: if losing a conversation already costs you a sale, the API pays for itself.

WhatsApp Business or the Official API: which to choose

What to do in practice before you sign up

  • Estimate the monthly volume of each category: replies, utility notices and marketing broadcasts
  • Add the platform fee and the Meta fee to get the real monthly cost
  • Confirm the platform is an official Meta partner and works only with the Official API
  • Back up the app conversation history before connecting
  • Define opt-in: only send marketing to people who agreed to receive it

How Claryflow organizes this

Claryflow is a Meta Tech Provider and works only with the Official API. You connect your number inside the platform and start serving customers as a team in an inbox with conversation status, organize leads in a CRM with a Kanban pipeline and connect your sales platform to turn abandoned checkouts, unpaid Pix and declined cards into automatic messages.

All plans include Clary AI, the AI agent that qualifies leads and replies after hours, and unlimited leads. Plans cost R$ 154 (Starter), R$ 279 (Growth) and R$ 697 (Enterprise) per month, on top of the Meta fee.

Try it free for 3 days and connect your WhatsApp to the Official API

FAQ

What is the WhatsApp Official API?

It is the Cloud API of the WhatsApp Business Platform, the Meta infrastructure that connects a company number to a system to serve customers as a team, automate and send messages at scale.

How much does the WhatsApp Official API cost?

The cost adds the platform monthly fee and the Meta fee per delivered message. In Brazil, Meta charges R$ 0.035 per utility, authentication and service message (after 1,000 free service messages per month) and R$ 0.3217 per marketing template.

Is there a free WhatsApp API?

Not for ongoing commercial use. Meta does not charge messages inside a window opened by a free entry point or the first 1,000 service messages of the month, but other delivered messages are charged.

Can I use the Official API and the WhatsApp Business app on the same number?

You can, in the coexistence model described by Meta, where history stays synced between both. Availability depends on the platform you hire, and there are limitations, such as groups that do not sync, so confirm before connecting.