WhatsApp AI agent: how it works on Meta's Cloud API and how to launch one

Updated on October 7, 2026 · Reviewed by Alejandro Díaz, CEO of Agent IA SAS

A WhatsApp AI agent is software that reads each message sent to your WhatsApp Business number, works out what the customer needs and takes the next step on its own: answering from information you approved, asking a qualifying question, checking a calendar, preparing a quote or handing the chat to a person. This guide explains how it works on Meta's official WhatsApp Business Platform, what it can and can't do, how it compares with Meta's own business agent, and what to check before anyone builds one for you.

It is written for businesses that want WhatsApp conversations to end in a booking, an order or a qualified lead, including US companies whose customers write in Spanish. The mechanics below, and Meta's rules, are the same whichever provider builds your agent.

Try the agent now on WhatsApp Message us and the agent itself replies — no forms.

What makes it an agent: it acts, not just answers

A rule-based chatbot follows a decision tree designed in advance, so when a customer writes something the tree didn't anticipate, such as “do you deliver on Saturday and can I pay when it arrives?”, it loops back to the menu. A WhatsApp AI agent replaces the tree with a language model that interprets the message, surrounded by instructions and tools that limit what it may do. It reads that question as two intents, answers both from the information it was given, and decides whether to ask for an address, offer a quote or pass the chat to a person.

The word agent matters: beyond writing text, an agent calls tools. It checks open slots and creates a calendar event, looks up stock, registers an order or prepares a quote. That ability to act is what separates it from a FAQ assistant with better grammar. For a side-by-side comparison of menu bots, AI chatbots and agents, see our WhatsApp chatbot guide.

The five parts of an AI agent for WhatsApp

Any WhatsApp agent is assembled from five parts. Knowing them helps you locate the cause when an agent gives a bad answer.

• The channel: a phone number connected to a WhatsApp Business Account on Meta's Cloud API, with an approved display name and message templates.
• The language model: interprets messages and writes replies. On its own it knows nothing about your prices, service area or policies.
• Instructions and knowledge: what you sell, where, under which conditions, what the agent must never promise and when it must escalate. Most answer quality comes from here.
• Tools: connections that let the agent act, such as reading free slots in Google Calendar, checking catalog and inventory, registering an order or preparing a quote.
• The operating layer: a dashboard where your team reads conversations, takes over a chat with its history, tracks leads in a CRM and reviews analytics.

How a WhatsApp AI agent works on the Business API, message by message

The WhatsApp Business Platform is Meta's official way for companies to send and receive messages through software. Most new implementations use the Cloud API, which Meta hosts. The agent never logs into WhatsApp the way a person does in the app; it exchanges data with Meta's servers.

So whoever builds the agent, the reasoning happens on the provider's side, but everything the customer sees travels through Meta's infrastructure and follows Meta's rules. Tools that automate the regular WhatsApp app instead of the API break WhatsApp's terms and put the number at risk. This is the sequence when a customer writes:

• 1. The customer sends a message to your business number, from a saved contact, a button on your website or a Click-to-WhatsApp ad.
• 2. Meta delivers the message to your provider's server through a webhook: a notification carrying the text, the sender's number and message metadata.
• 3. The server loads the conversation history and the customer's record, then passes the new message to the agent together with its instructions and available tools.
• 4. The agent decides: answer directly, ask a question, call a tool (for example, look up open slots in Google Calendar) or transfer the chat to a person.
• 5. The reply goes back to Meta through the Cloud API, and Meta delivers it to the customer's WhatsApp.
• 6. Meta sends further webhooks with the message status (sent, delivered, read or failed), which the system records for follow-up and reporting.

What Meta's rules mean for the agent's decisions

A capable agent knows which type of message it is allowed to send at each moment. Three rules shape that choice.

The customer service window. When a customer writes, a 24-hour window opens. Inside it, the agent can send free-form messages, including buttons and lists. Once the window closes, the agent can only reach the customer with a message template approved by Meta.

Templates, categories and opt-in. Templates are pre-approved messages with variables, classified as marketing, utility or authentication. Utility covers only a specific transaction the customer requested, such as an order, a quote or an appointment; commercial reminders and re-engagement messages are marketing, even when they feel helpful. Meta reviews each template and can change its category, and every template the business sends first, utility included, requires the customer's opt-in.

Per-message pricing. Since July 1, 2025, Meta charges per delivered template message, by category and recipient country, and from October 1, 2026 it also charges service messages inside the 24-hour window. Our WhatsApp automation guide explains how each message type is charged and which messages stay free.

For the agent, this becomes logic: before every proactive message it checks whether the window is open, picks a template in the right category and language, and skips anyone who hasn't opted in or has asked to stop.

What a WhatsApp AI sales agent can take off your team's plate

Each task depends on a specific integration. Without it, the agent can talk about the task but not complete it. A useful demo test: ask something that requires a tool, such as “can I come in Thursday afternoon?”, then open the calendar and check whether the event exists. Talking about an appointment and booking one are different capabilities.

Just as important is what the agent should not do alone: negotiate outside your terms, promise delivery dates it can't verify, or answer legal, medical or financial questions beyond approved content. Write those handoff moments into the instructions.

Here is what the agent does for each task and what has to be connected:

Customers who write in more than one language

SoyAgentia's agent detects the language of every incoming message and replies in the language of the customer's last message, so a customer who switches from Spanish to English gets the next answer in English; our overview of AI agents for WhatsApp, Instagram, Messenger and TikTok explains how that works across channels. When you compare providers, ask whether the language is detected per message or locked at the start of the chat.

Knowledge in each language. If your policies and product descriptions exist in only one language, the agent translates them on the fly. That works for general questions, but anything with commercial or legal weight, such as warranty, return or payment terms, should be written and reviewed in each language before launch.

Templates per language. On the WhatsApp Business Platform each template is submitted with a language, and the same template can have versions in several languages, each reviewed by Meta. The system has to remember the customer's language so that a follow-up sent after the window closes arrives in the right version, not in whichever one was created first.

Formats and context. A customer in Houston and a customer in Madrid may both write in Spanish yet expect different currencies, date formats and time zones. Decide which conventions apply, and ask your provider how the agent handles time zones when it books appointments.

Handoff by language. When the agent transfers a chat, the person who picks it up must be able to continue in the customer's language, so decide who covers each language and during which hours.

Meta's built-in business agent vs. an agent implemented on the API

On June 3, 2026, Meta made its business AI agent available globally inside WhatsApp Business and Instagram DMs, as TechCrunch reported. Meta said it will be included in some WhatsApp Business Premium tiers and charged by tokens for larger businesses. So is a separately implemented agent still necessary?

It depends on what the conversation has to touch. Meta's agent is part of Meta's own products, so its features, availability and conditions are defined by Meta and can change; review Meta's current documentation for your country. An agent implemented on the Cloud API is built by your developers or a provider and connected to the systems you choose. Neither option is inherently superior; they cover different scopes.

A practical way to decide: take recent conversations that ended in a sale or booking and mark each step where your team had to open another system. If most steps are answers, the built-in route may be enough. If most are actions in a calendar, catalog, inventory or order system, you need integrations.

Before you launch: a readiness checklist

Going live involves Meta's requirements, which are procedural, and your own preparation, which determines whether customers get accurate answers.

• Meta business portfolio: the WhatsApp Business Account belongs to a business portfolio. Make sure your company owns it, not an employee or an agency.
• Phone number: it must receive a verification code by SMS or voice call. If it runs on the WhatsApp Business app today, you can connect it with coexistence and keep using the app for one-to-one chats; if you migrate without coexistence, the number leaves the app.
• Embedded Signup: with a technology provider that has Embedded Signup enabled, you connect the account through a Meta-hosted flow with your own login, without handing passwords to anyone.
• Display name and business verification: Meta reviews the display name, and business verification affects messaging limits and some features.
• Templates: draft the ones you will need outside the 24-hour window, such as order and appointment updates, in each language and the correct category.
• Knowledge: service area, hours, policies, where current prices come from, and topics the agent must never answer.
• Escalation rules: who takes over, in which language, during which hours, and what the agent says when nobody is available.
• Integrations: Google Calendar and your catalog and inventory data; ask which other integrations are available for your case.
• Consent capture: wherever you collect phone numbers, add a clear opt-in to receive WhatsApp messages from your business.

Risks and compliance for a WhatsApp AI agent

Consent. WhatsApp's Business Messaging Policy requires opt-in before a business contacts people: the person must agree to receive messages from your business on WhatsApp, and the opt-in must name your business. This applies to every template the business sends first, utility messages included. Requests to stop must be honored, in whatever language the customer writes them.

A path to a person. Meta's policy expects automated experiences to offer a prompt, clear and direct way to reach a human, either by transfer inside the chat or through another support channel. Design the handoff before launch, not after the first complaint.

Meta's rules on AI. Since January 15, 2026, the WhatsApp Business Solution Terms prohibit providers of general-purpose AI assistants from using the Business Solution to distribute those assistants when AI is the primary service offered, as TechCrunch reported on October 18, 2025. Agents that serve a company's own customers, answering about its products, booking its appointments or taking its orders, remain within the intended use.

Accuracy. Language models can produce answers that sound right and are wrong. Restrict the agent to approved information, define what it does when it doesn't know, and review conversations on a regular schedule.

Number quality. Customers who block or report your number affect its standing with Meta, which can lead to messaging limits. Insistent follow-up with marketing templates invites exactly those blocks and reports.

Data protection. The applicable law depends on where your business and your customers are (the GDPR in the European Union, for example), so review your obligations with your own counsel. Choosing a provider doesn't transfer that responsibility, so ask any provider:

• Whether it signs a data processing agreement with your business
• Where conversation and contact data are processed and stored
• How opt-in records and stop requests are kept
• How long data is retained, and how you can export or delete it

Questions to ask a provider before you sign

These questions focus on what changes when an agent works across several languages and, possibly, several markets. Ask for evidence in a live demo.

• Are you an authorized Meta Tech Provider with Embedded Signup enabled, and will the WhatsApp Business Account remain in my company's business portfolio?
• Does the agent detect the language of every message, and who reviews the knowledge base in each language my customers use?
• How does the system choose the template language when the 24-hour window is closed?
• Which tools can the agent call today, and can I watch one of them complete an action during the demo?
• Which payment gateway can serve my customers' country, and is electronic invoicing available where I operate?
• What does the agent do when it doesn't know the answer, and how does the person who takes over see the conversation history?
• Does the agent process voice notes and images, can chats be assigned to specific team members, and can I export my data? Get the answers in writing.
• How are Meta's per-message charges billed to me, separately or through the provider?
• Can my number stay on the WhatsApp Business app through coexistence, and what does the agent do when someone on my team replies from the phone?

What SoyAgentia's WhatsApp agent includes

SoyAgentia is an authorized Meta Tech Provider with Embedded Signup enabled. Its WhatsApp AI agents run on Meta's official Cloud API, with verified numbers and approved templates, and reply in the language of the customer's last message.

The agents check availability and create events in Google Calendar through an OAuth connection, follow up with retries, run campaigns and flows, and work with catalog, inventory, orders and quotes. Teams manage them from a no-code dashboard with a CRM, analytics and handoff to a person with the full conversation history. The same agent can also serve Instagram, Messenger, TikTok, WordPress and Shopify.

For businesses in Colombia, the agent can also send payment links through the business's own Wompi account and issue electronic invoices in its own Siigo account; those two integrations work only there. Elsewhere, the agent records the order and your team collects payment through its usual channel.

SoyAgentia is the brand of Agent IA SAS, a company based in Colombia that works with businesses in any country; founder and company details are on our English home page. Clients including Transportes Gran Bretaña and Nelly Seguros LTDA have shared video testimonials (in Spanish). To discuss your case, see current plans or message +57 300 900 6005 on WhatsApp.

Customer video testimonials

Keep reading

• AI agents for WhatsApp, Instagram, Messenger and TikTok
• WhatsApp chatbot for business
• WhatsApp automation: what to automate and how

Frequently asked questions