← Back to Blog
whatsapp-cloud-api ai-agents official-api guide

WhatsApp Cloud API for AI Agents

This page is a map. Each section explains one part of Meta’s WhatsApp Cloud API in a few lines and points to the guide that covers it in depth.

What the WhatsApp Cloud API is

The WhatsApp Cloud API is Meta’s official platform for sending and receiving WhatsApp messages as a business: Graph API requests, a registered business number, official webhooks, template messages, and the 24-hour customer service window. It is not Baileys, WAHA, or Evolution API in its Baileys mode, which emulate WhatsApp Web.

Pipes Bot (PipesBot) is a managed connector on top of that official API. It delivers messages to your agent or SaaS through webhooks or a WebSocket, without you becoming a Meta Tech Provider to onboard your customers’ numbers.

When unofficial libraries are the wrong tool

If the number matters, unofficial clients are the wrong foundation. These posts cover why and how to leave:

Connect a number

Embedded Signup onboards a WhatsApp Business number onto the Cloud API. If the number is already on the WhatsApp Business app, the default is Coexistence, and the app stays on the phone. PipesBot can also register a number that is new to the Cloud API right after signup and handle the two-step verification PIN. See Cloud API numbers now register themselves and Onboarding in English, Spanish, and Portuguese.

On PipesBot, pool numbers are the sandbox path (5 sends per day per number). BYON, for your own number or your customers’ numbers, is +$5 per number per month on Pro and Pro+.

Receive messages: webhooks and WebSocket

Cloud API delivery is push-based. Through PipesBot you get Meta’s payload in a signed envelope (API v2), HMAC signature verification, retries, and an optional outbound WebSocket, so you don’t have to expose a port. Start with WhatsApp Cloud API webhooks for AI agents and Getting Started.

Each App has a Webhooks tab with delivery logs and manual retry, payloads are kept for 7 days, and pool numbers have a daily send limit. Details are in the October sandbox update.

Send messages, the 24-hour window, and pricing

Free-form sends need an open customer service window: the customer must have messaged you in the last 24 hours. Templates cover proactive messages.

Many pages still cite an older model of 1,000 free conversations. That is no longer how Meta bills. Since 1 October 2026, each business phone number gets 1,000 free service messages per month; after that, service messages are charged per delivery at the same rate as utility and authentication messages for the recipient’s market. Unused free messages do not roll over. See WhatsApp Service Messages in October 2026 and WhatsApp Cloud API vs Meta Business Agent: TCO.

If Meta returns 200 but the message never arrives, check Number Diagnostics.

Keep the WhatsApp Business app: Coexistence and message_echoes

Coexistence puts the same number on the phone and on the API. The limits: 20 messages per second, the app must be opened about every 14 days, groups are not available through the API, and messages sent from the phone stay free.

To give the agent the other half of the conversation, turn on message echoes (API v2, smb_message_echoes / message_echoes) and never reply to them. Coexistence numbers can also import past chats and contacts.

Build an AI agent or a product on the Cloud API

For the agent use case, read WhatsApp AI Agent on the Official Cloud API. For a specific stack, see the OpenClaw setup. For patterns, browse the use cases and the open-source pipes-bot-examples. WhatsApp usernames change how users are identified; see WhatsApp Usernames, BSUID, and API v2.

The full API reference is in the PipesBot docs.

Frequently Asked Questions

What is the WhatsApp Cloud API?

Meta’s official API for business WhatsApp messaging: registered numbers, official webhooks, templates, and the 24-hour service window. It replaces unofficial WhatsApp Web libraries for any number you can’t afford to lose.

Do I need to become a Tech Provider to use it?

Only if you onboard other businesses’ numbers onto the Cloud API yourself. A managed connector such as PipesBot is already a Tech Provider and gives you a webhook or WebSocket into your agent.

Can the Cloud API coexist with the WhatsApp Business app?

Yes. Coexistence keeps the app on the phone and the API on the same number. See the message_echoes post and the Coexistence docs. This is not the same as running Baileys on that number: Baileys and the Cloud API can’t share a number.

How do webhooks work on the Cloud API?

Meta, and PipesBot when you use the connector, POST signed payloads to your HTTPS URL. Verify the signature, dedupe, and ack quickly. The full guide is WhatsApp Cloud API webhooks for AI agents.

What changed in Cloud API pricing in October 2026?

The older “1,000 free conversations” model, still cited in many places, is no longer how Meta bills. Since 1 October 2026, service messages are charged after 1,000 free service messages per number per month. Details are in the service messages playbook and the TCO comparison with Meta Business Agent.

What is the difference between WhatsApp Business API and Cloud API?

The WhatsApp Business API is the platform API for sending and receiving WhatsApp messages as a business. The Cloud API is the Meta-hosted version of that API: Meta hosts it and provides the endpoint for incoming and outgoing messages. The older On-Premises API, which ran on your own servers, has been sunset and can no longer send messages (the final supported client expired on 23 October 2025). New integrations use the Cloud API on the WhatsApp Business Platform.

How do I get the WhatsApp Business API?

You can get access directly from Meta, by creating a Meta Business portfolio and a WhatsApp Business Account (WABA) and following Meta’s Cloud API Get Started guide. Or you can go through a Tech Provider such as PipesBot, which connects a number with Meta’s Embedded Signup. Either path uses the official Cloud API.

How do I migrate from Baileys, WAHA, or Evolution API?

Use a dual-run cutover on two numbers, then switch traffic. See the zero-downtime migration guide and the two unofficial-client posts linked above.

Get started

Start on the official WhatsApp Cloud API. Sign up at PipesBot, activate a pool number, or connect your WhatsApp Business number with BYON.