WhatsApp Business Cloud API: from setup to automated conversations

WhatsApp Business Cloud is Meta’s hosted version of the WhatsApp Business API. It gives you programmatic access to send messages, receive webhooks, and build automated conversations on WhatsApp — without running your own infrastructure. The “Cloud” part means Meta hosts the API; you just call it.

The practical starting point: register a Meta Business account, create a WhatsApp Business app in the Meta Developer portal, verify your business, get a test phone number, and start sending template messages. Meta’s documentation reports that WhatsApp Business Platform processes over 100 million messages daily across businesses worldwide (Meta for Developers). A 2025 Juniper Research study estimates that business messaging on WhatsApp will generate $3.6 billion in revenue by 2028 (Juniper Research). Unlike generic AI automation posts, this guide shows real CodeWords workflows — not just theory.

Related reading: build WhatsApp chatbot, WhatsApp AI chatbot, WhatsApp bot builder, Telegram AI chatbot, CodeWords integrations, CodeWords templates, CodeWords pricing.

TL;DR

• WhatsApp Business Cloud is Meta’s hosted API for sending and receiving WhatsApp messages programmatically — no on-premises servers required.
• The main workflow: register → verify business → create message templates → handle webhooks → build response logic.
• CodeWords provides native WhatsApp integration, so you can build WhatsApp automations by describing them to Cody instead of writing webhook handlers from scratch.

What is WhatsApp Business Cloud and how does it differ from the on-premises API?

Think of WhatsApp Business Cloud as the managed database version of self-hosting. The on-premises API required you to run Docker containers, manage your own infrastructure, handle scaling, and maintain uptime. The Cloud API eliminates all of that — Meta hosts the infrastructure, and you interact through REST endpoints.

Key differences:

• Hosting: Cloud API is fully hosted by Meta. On-premises requires your own servers.
• Setup time: Cloud API takes minutes to get a test number. On-premises took days to weeks.
• Scaling: Cloud API scales automatically. On-premises required capacity planning.
• Cost: Cloud API charges per conversation (not per message). On-premises had infrastructure costs plus per-message pricing.
• Features: Cloud API receives new features first. Meta has been deprecating on-premises in favor of Cloud.

As of 2025, Meta officially recommends new businesses use the Cloud API. The on-premises API is in maintenance mode.

How do you set up WhatsApp Business Cloud from scratch?

The setup has five steps. Each one has a specific gate you need to pass before proceeding.

Step 1: Create a Meta Business account. Go to business.facebook.com and register your business. You need a business name, address, and website. This is a prerequisite for everything else.

Step 2: Create an app in Meta Developer portal. Visit developers.facebook.com, create a new app, and select “Business” as the app type. Add the WhatsApp product to your app. Meta provides a test phone number and a temporary access token.

Step 3: Verify your business. Meta requires business verification before you can use a production phone number. Submit business documents (registration certificate, utility bill, or similar). Verification typically takes 2–7 business days.

Step 4: Register a production phone number. Once verified, you can register your own phone number. The number cannot already be registered with WhatsApp or WhatsApp Business app. You will receive a verification code via SMS or voice call.

Step 5: Generate a permanent access token. The test token expires in 24 hours. Create a System User in Meta Business Suite, assign WhatsApp permissions, and generate a permanent token. Store this token securely — it is your API credential.

How do WhatsApp Business Cloud message templates work?

WhatsApp enforces a strict messaging policy. You cannot send arbitrary messages to users who have not messaged you first. The exception is message templates — pre-approved message formats that Meta reviews before you can use them.

Templates fall into three categories:

• Utility: Order confirmations, shipping updates, appointment reminders. Lowest per-conversation cost.
• Authentication: One-time passwords and verification codes. Also low cost.
• Marketing: Promotions, product announcements, re-engagement. Highest per-conversation cost and strictest approval.

To create a template: go to WhatsApp Manager in Meta Business Suite → Message Templates → Create Template. Provide the template category, language, header (optional), body text with variable placeholders (e.g., {{1}} for customer name), and footer (optional).

Template approval usually takes minutes but can take up to 24 hours. Common rejection reasons: promotional language in a utility template, placeholder-only bodies, or content that violates WhatsApp’s commerce policy.

How do you handle WhatsApp Business Cloud webhooks?

Webhooks are how your system receives incoming messages, delivery receipts, and status updates. The setup involves three parts:

Configure the webhook URL. In the Meta Developer portal, under your WhatsApp app’s configuration, set a webhook URL and a verification token. Meta will send a GET request with a challenge parameter — your server must echo it back to verify ownership.

Subscribe to webhook fields. At minimum, subscribe to messages (incoming messages and status updates). Other useful fields include message_template_status_update for template approval notifications.

Process incoming payloads. Each webhook POST contains a JSON payload with the sender’s phone number, message type (text, image, document, location, interactive), message content, and metadata.

Here is where CodeWords simplifies the process significantly. Instead of writing a webhook handler, configuring a server, managing SSL certificates, and parsing Meta’s nested JSON format, you describe the WhatsApp workflow to Cody:

“When someone sends a WhatsApp message, classify their intent, look up their order status in our database, and reply with a status update.”

Cody builds the webhook handler, message parser, AI classification step, database lookup, and response formatter as a deployed service. The WhatsApp AI chatbot guide covers this pattern in detail.

What are common WhatsApp Business Cloud automation patterns?

Pattern 1: Order notifications. Trigger: order status change in your e-commerce platform. Action: send a utility template message with order details via the Cloud API. This is the highest-volume WhatsApp Business use case.

Pattern 2: Appointment reminders. Trigger: scheduled job runs 24 hours before each appointment. Action: send a template message with date, time, and a quick-reply button to confirm or reschedule. See calendar chatbot for a related pattern.

Pattern 3: AI-powered customer support. Trigger: incoming WhatsApp message. Action: classify intent using an LLM, retrieve relevant information from your knowledge base, generate a contextual reply, and send it. Fall back to a human agent for complex cases.

Pattern 4: Lead qualification. Trigger: user clicks a “Chat on WhatsApp” button on your website. Action: ask qualifying questions via interactive list messages, score responses, and route qualified leads to your CRM and sales team’s Slack channel.

Each of these patterns maps to a CodeWords template you can customize through Cody.

What are the pricing and rate limits for WhatsApp Business Cloud?

WhatsApp Business Cloud uses conversation-based pricing. A conversation is a 24-hour window opened by either a business-initiated template message or a user-initiated message.

• User-initiated conversations: Currently free in many markets (Meta’s policy as of 2025).
• Utility conversations: Lowest business-initiated cost (varies by country).
• Marketing conversations: Highest cost, typically 2–5× utility pricing.
• Authentication conversations: Low cost, comparable to utility.

Rate limits: new accounts start with a messaging limit of 250 unique users per 24-hour period. This increases to 1,000, then 10,000, then 100,000 as you maintain quality (low block and report rates). High-quality accounts can request unlimited messaging.

FAQ

Do I need a separate phone number for WhatsApp Business Cloud?

Yes. The number cannot be registered with the regular WhatsApp app or WhatsApp Business app. Many businesses use a dedicated virtual number. You can port an existing number, but it will be deregistered from the consumer app during the process.

Can I send WhatsApp messages without a template?

Only within a 24-hour customer service window. When a user messages you, you have 24 hours to respond with free-form messages. After that window closes, you must use an approved template to re-initiate the conversation.

How do I test WhatsApp Business Cloud without a production number?

Meta provides a test phone number when you create your app. You can send messages to up to five recipient numbers that you register in the developer portal. This is sufficient for development and testing before business verification.

Can I use WhatsApp Business Cloud with automation platforms?

Yes. Make and Zapier offer WhatsApp Business Cloud modules. CodeWords has native WhatsApp integration — Cody can build WhatsApp workflows that include AI processing, database lookups, and multi-channel routing without manual API configuration. See WhatsApp bot builder for more options.

Beyond notifications

WhatsApp Business Cloud started as a notification channel. It is becoming a conversational interface — a place where customers interact with AI-powered agents that can answer questions, process orders, and resolve issues.

The implication for builders: the value is not in the API access (that is table stakes) but in the intelligence behind the conversation. A WhatsApp number connected to a well-designed AI workflow outperforms a WhatsApp number connected to a template library.

Start building your WhatsApp automation with Cody on CodeWords — describe the conversation you want, and ship it today.