Guide
WhatsApp Business API: Setup and Automation Guide
The WhatsApp Business API (officially, the WhatsApp Business Platform) is programmatic access to WhatsApp for businesses. It connects the messenger to your CRM, bots, and automation so that conversations are handled by software rather than by hand. Unlike the free WhatsApp Business app, the API is built for a high volume of inquiries, multiple operators, and automatic replies around the clock. Below, we'll cover who needs it, how to connect it, and how to add an AI sales agent without a developer.
What the WhatsApp Business API is, in plain terms
WhatsApp has three products, and they're easy to mix up. Regular WhatsApp is for personal messaging. The WhatsApp Business app is a free mobile app for small businesses: a catalog, quick replies, a company profile — but everything is manual and tied to a single phone. The WhatsApp Business API isn't an app at all; it's programmatic access for companies that handle a high volume of messages.
The key thing to understand about this API: it has no chat interface of its own. It's a "pipe" that carries messages between your systems and the customer. For an agent to see the conversation, reply, and have a bot run automatically, you need software on top of the API — a provider's dashboard or an automation platform. On its own, it doesn't display anything or reply to anyone.
This product used to be called the WhatsApp Business API. Its official name is now the WhatsApp Business Platform, but in everyday use and in search, people still mostly write "whatsapp business api." It's the same thing.
The main difference between the app and the API: the WhatsApp Business app is a free mobile app for handling chats manually on a single device; the WhatsApp Business API is programmatic access with no interface of its own, built for CRM integrations, bots, and multiple operators. The app is for one person; the API is for a team and a steady flow of leads.
Who needs the WhatsApp API, and who's fine with the app
The WhatsApp Business app is enough if one person handles your chats, you get up to a couple dozen inquiries a day, and you don't need integrations. The moment a stream of leads appears, several agents are involved, or you want to automate replies, you hit a ceiling: one device, no link to your CRM, no way to connect a full-featured bot.
You need the business API when:
- you get more inquiries than your agents can work through by hand;
- you need to reply around the clock, including nights and weekends;
- you want to connect an AI sales agent that qualifies and closes leads;
- conversations need to land in your CRM and be distributed across operators;
- you rely on notification broadcasts (order status, appointments, payments) under Meta's rules.
| Criterion | WhatsApp Business app | WhatsApp Business API |
|---|---|---|
| Who it's for | Small business, 1 person | Lead flow, a team |
| Interface | Mobile app | None of its own — needs software on top |
| Devices / operators | 1 device | Multiple operators |
| CRM integration | No | Yes |
| Bots and auto-replies | Manual templates only | Full-featured bots and AI agents |
| Cost | Free | Access free, messages at Meta's rates |
How to connect the WhatsApp Business API: two paths
There are two ways to connect. The choice depends on whether you have developers and how quickly you need results.
Path 1. Directly through the Meta Cloud API
The Cloud API is the WhatsApp Business Platform hosted on Meta's side. You work with the platform directly, with no middleman between you and Meta. What you'll need:
- A Meta Business account and Business Manager.
- A phone number that is not already in use on regular WhatsApp or the Business app (you can migrate an existing number by unlinking it from the app).
- Business verification with Meta (company documents).
- Creating a WhatsApp Business Account and linking the number.
- A developer to connect the Cloud API to your CRM and other systems (everything on the API side is configured with code).
The Cloud API gives you direct control and removes the middleman. The downside: you can't do it without a developer — the API has no ready-made interface, so you have to build everything yourself. For technical details and a step-by-step guide, see Meta's official developer documentation.
The On-Premises API (where the WhatsApp server ran on your own infrastructure) is being deprecated — Meta is moving everyone to the Cloud API. Don't build new projects on On-Premises: choose the Cloud API or a provider.
Path 2. Through a partner provider (BSP)
A BSP (Business Solution Provider) is a Meta partner company that handles the technical side and gives you a ready-made dashboard or a simpler API. Official providers include Twilio, 360dialog, and Gupshup. Separately, there are third-party wrapper services like Wati and Green API: they simplify setup but are not a Meta product — it's best to confirm their status and terms on their own sites. Don't mistake a wrapper for "official WhatsApp."
Connecting through a provider is faster: they help you get verified and take the setup off your hands, leaving you to configure the scenarios. Launch often fits into a single working day.
| Criterion | Cloud API directly | Through a provider (BSP) |
|---|---|---|
| Time to launch | Days, needs a developer | Hours, with setup help |
| Developer required | Yes | Not always |
| Ready-made interface | No | Usually a dashboard included |
| Message cost | Meta's rates | Meta's rates plus a possible subscription; models vary |
| Who it's for | Teams with developers | Businesses without their own developers |
How much the WhatsApp Business API costs
The cost of the WhatsApp Business API breaks down into three parts: (1) API access — free; (2) sending messages — paid at Meta's rates, with the price depending on the country and message category; (3) the provider (BSP) or platform on top of the API — at their subscription rate. This is where the confusion comes in. Let's break down each part.
- Platform access — free. Connecting to the WhatsApp Business Platform doesn't cost anything by itself. Access and registration are free — but use isn't.
- Messages — paid at Meta's rates. Meta splits messages into four categories: marketing, utility, authentication, and service. The price depends on the customer's country and the category, and it changes from time to time. For example, marketing messages are priced higher than utility ones, while service replies inside the customer window can be free. Quoting specific figures here is pointless — always check Meta's documentation for current rates in your country.
- The provider and software on top of the API. If you connect through a BSP or use a platform with a bot, their subscription or markup is added on top. Models vary: some work on a pass-through basis with no per-message markup, while others charge a subscription fee.
Don't rely on a "per-message price" from old articles. Meta keeps changing its pricing model — for instance, the shift to charging per specific message instead of the previous 24-hour windows. Before you plan a budget, check Meta's current documentation for your country.
Message templates and the service window
With the WhatsApp Business API, you can't message a customer with anything at any time — Meta has strict rules, and it pays to understand them before you launch.
If the customer messages you first, a service window opens: for 24 hours after their message, you can reply in free-form text, without templates. This is the mode for normal conversation and support.
But if you want to message a customer first or outside the window (an appointment reminder, an order status, a promotion), you need a message template — text approved in advance by Meta. Templates go through moderation and fall into three categories: marketing, utility, and authentication. Service replies are not templates — they're free-form text inside the window. You can't send a marketing broadcast without the customer's consent — that's a fast track to getting your number banned.
Don't buy contact lists or send cold broadcasts through the WhatsApp Business API. Meta tracks complaints and number quality: a low rating means your limits get cut, and your number can be banned. Message only people who've given consent, and keep your complaint rate minimal.
The service window is convenient for inbound inquiries: if the customer messages first, an AI agent replies in free-form text with no template restrictions. That's exactly why automating inbound inquiries on the API is easier to launch than outbound broadcasts.
What to do after connecting: the API is just a pipe
Connecting the API is only half the job. Next you need software that turns the "pipe" into a working sales tool. There are three options: have agents reply manually through the provider's dashboard, commission a scripted bot from developers, or connect an AI agent.
Scripted WhatsApp bots work off a rigid tree: "press 1 for catalog, 2 for prices." The moment a customer asks a question in their own words, the bot gets lost. That's why more and more businesses choose a generative AI agent: if you're not sure how the two compare, here's a plain-English breakdown of what an AI sales agent is and where it beats a script. In short, it understands free-form text, gives substantive answers, and carries the conversation like a real agent. For how they differ and what's available on the market, see our roundup of the Top 10 AI sales agents.
How to add an AI agent to the WhatsApp Business API without code
If you want to do more than just receive messages — if you want to sell — put an AI agent on top of the API. This closes the WhatsApp Business API's weak spot: it has neither an interface nor reply logic — both come from the platform on top.
Mooon AI is a no-code platform where you build a WhatsApp bot for business with no developer. You connect WhatsApp (and Instagram and Telegram too — one subscription covers all channels), link your CRM (amoCRM, Bitrix24, MoySklad) and Google Calendar, and a generative AI agent starts working on top of the API. Here's what it does:
- Replies 24/7 to free-form customer questions, not off a rigid menu.
- Qualifies and closes leads: it clarifies the need, budget, and timeline and moves toward a deal.
- Hands a hot deal to an agent — a notification lands in Telegram with a card in your CRM.
- Speaks RU, KZ, and EN and switches languages right inside the conversation.
- Reads more than text: voice messages, product photos, receipts, PDFs.
Launch usually fits into a single day: you connect the channel, upload products and scripts, and test on real conversations. No developer needed. The API itself stays the standard WhatsApp Business API from Meta — Mooon AI works on top of it and takes on the interface, the logic, and the integrations. For a detailed walkthrough of every step, see the guide on how to launch an AI sales agent in one day.
Start with the single channel that brings in the most inbound. That's the fastest way to see how the AI agent handles common questions, and it's easier to fine-tune the scenarios before you scale.
Common mistakes when connecting
Here's where people trip up most often:
- Using a number already taken on WhatsApp. The number for the API has to be free to register: you either unlink it from the app and regular WhatsApp (migration is supported) or use a separate one.
- Confusing the app with the API. People download the WhatsApp Business app and expect CRM integrations and bots from it. These are different products — the app can't do that.
- Assuming the bot will appear on its own. The API brings neither an interface nor reply logic. Without software on top — an operator dashboard, a no-code chatbot builder, or an AI agent — it just receives and sends messages.
- Budgeting with outdated prices. Meta's rates change — a calculation based on "an article from two years ago" will let you down. Check the documentation.
- Putting a scripted bot on free-form questions. A rigid menu frustrates a customer who's writing in their own words. A live conversation needs a generative agent.
In short: the order of steps
- Decide whether you need the API or the WhatsApp Business app is enough.
- Choose your connection path: the Cloud API directly (you have developers) or a provider/platform (you need a fast, no-code start).
- Complete business verification with Meta and link a free number.
- Budget for Meta's per-message rates — per the current documentation for your country.
- Put software on top of the API: a dashboard for your agents or an AI agent for sales automation.
The WhatsApp Business API doesn't sell on its own — it just gives you access to the channel. Sales begin where an agent sits on top of the API, one that replies instantly and carries the customer all the way to a request.