How to Create an AI Agent on WhatsApp in 10 Minutes

How to Create an AI Agent on WhatsApp in 10 Minutes (Step-by-Step)

Creating an AI agent on WhatsApp used to be a three-month project: approve Meta API, code integration, host server, test. With OpenClaw, the same delivery runs in 10 minutes from sign-up to the first real conversation. This post is the honest step-by-step guide — with the 4 hurdles you'll encounter and how to get through each one.

TL;DR: Sign-up → describe the agent in text → connect WhatsApp Business → configure 1 integration → first conversation. ~10 min. No code.

---

What You Need Before You Start

Three things (and nothing more):

1. WhatsApp Business account (the free Meta app — don't confuse it with the others).
2. Dedicated phone number. It can be fixed, virtual, or mobile — but it cannot be in use on your personal WhatsApp.
3. 10 minutes without interruption. The flow will stall if you leave during the authentication process.

You don't need a credit card on the free plan. You don't need a CNPJ (although we recommend it). You don't need to know what a webhook is.

---

Step 1 — Create the Account (1 min)

Go to openclaw.com.br, click on Create free account and fill in:

• Email
• Password
• Business name

The system creates your workspace in seconds. You'll land on the dashboard with a 3-step tour.

Common hurdle: The confirmation email sometimes ends up in the Gmail spam folder. If it doesn't arrive in 1 min, check the "Promotions" or "Spam" folder.

---

Step 2 — Describe the Agent in Natural Language (3 min)

Here's where OpenClaw diverges from most platforms. Instead of building a flowchart with drag-and-drop blocks, you describe the agent in text and the platform builds the logic.

Open Agents → + New agent. You'll see three fields:

Name

The name the customer sees. Ex: Sofia, OpenClaw Agent, Solar Clinic Assistant.

Objective

A short sentence of what the agent should do. Examples that work:

• ✅ Qualify new leads and schedule a free consultation with a consultant.
• ✅ Answer questions about our courses, apply a discount coupon, and send a payment link.
• ❌ Sell. (too generic)
• ❌ Be friendly, efficient, professional, and sell. (objective turns into a list of adjectives — bad)

Personality and restrictions

Here you give the "brand manual" in a single text block. Example that we use as a baseline:

...

Tom: casual New Zealander, friendly but professional. Use emojis sparingly (1 per message).

Always: introduce yourself in the first turn. Use the client's first name when you know it. Confirm appointments twice.

Never: promise discounts not in the catalog. Talk about competition. Invent hours or prices. Respond to health/ legal/ financial questions — forward to human.

When stuck: politely ask the person to wait and call a human via /chamar_humano.

Save. In 2 seconds you have a functional agent — still without integrations.

---

Step 3 — Connect WhatsApp Business (3 min)

This is the part that generates the most friction and where most platforms lose the user. OpenClaw shortens the official Meta flow into a linear sequence.

3.1 Start connection

In the dashboard, click on Integrations → WhatsApp → Connect. Choose:

• New number: if you're going to use a number that's not already in any WhatsApp.
• Migrate from WhatsApp Business (app): if you already have the WhatsApp Business app installed and want to transfer the number to API. Note: the app will stop working after migration.

3.2 Authenticate with Meta

OpenClaw redirects to Meta login (not Google, not personal Facebook — Business Manager account). If you've never opened Business Manager, Meta will create one for you on the spot.

Common friction #1: Your personal Facebook account needs to be an admin of the Business Manager. If nobody has given you access, you won't be able to pass this screen.

3.3 Select / create WhatsApp Business Account

Inside the Meta authentication, you choose which WABA (WhatsApp Business Account) to use. If it doesn't exist yet, Meta will create one on the spot via the embedded interface.

3.4 Verify the number

Meta will send SMS code or call to the number you're connecting. Enter the code in the OpenClaw interface.

Common friction #2: If you've already used this number in WhatsApp (personal or business app), the code won't arrive. Solution: uninstall WhatsApp from this number on your phone BEFORE starting the connection.

3.5 Configure webhook

OpenClaw configures the webhook automatically. You don't need to do anything. When the screen shows Number connected ✅, you're ready.

---

Step 4 — Plug in ONE integration (2 min)

You can skip this step and start chatting — but 95% of agents that stay online use at least 1 integration. We recommend starting with the one that generates the most value for your case:

Note: URLs, code, and HTML tags have not been translated.

CRITICAL RULES:

• Preserve ALL markdown formatting EXACTLY (headers ##, lists -, bold, italic, links, code blocks, etc.)
• Do NOT translate URLs, code, or HTML tags
• Do NOT add preamble or commentary
• Output ONLY the translated markdown, nothing else

Your Business	First-Time Integration
Clinic, consulting room, studio	Google Calendar
Infoproduct, course	Stripe or Mercado Pago
B2B Service (consulting, agency)	HubSpot or RD Station
Physical store / delivery	Google Sheets

Example — Google Calendar:

1. Integrations → Google Calendar → Connect.
2. Authorize with the Google account that has the operation's calendar.
3. Choose which calendar the agent can consult / create an event on.
4. Define the time slot (e.g. mon-fri 9am-6pm, sat 9am-1pm).
5. Save.

Done. The agent now consults available time in real-time and creates an event without human intervention.

---

Step 5 — First Real Conversation (1 min)

Grab your other phone (or ask someone), send a message to the number you connected. Test scenarios you know will happen:

• "hi"
• "how much does it cost?"
• "do you work on saturdays?"
• "I want to book"
• "I need to speak to a human"

Observe the responses. Go back to the OpenClaw panel → Conversations to see the transcription.

Adjust what didn't work: if the agent got the tone wrong or made something up, go back to the personality field and add the missing rule. The agent re-reads the description with each new message — changes apply to the next conversation.

---

The 4 Most Common Mistakes in the First 10 Minutes

1. Too generic objective. Agent with a vague objective gives a vague response. Rewrite with the concrete result you expect.
2. Forgetting negative restrictions. "Never invent a price" is more valuable than "be professional". Negative rules guide better.
3. Skipping integration and only testing with text. Agent without a calendar in the clinic example becomes decorative — customer leaves the conversation without booking anything.
4. Thinking you're ready after the first test. The first 20-30 real turns reveal patterns you didn't predict. Reserve 1 week to iterate before turning off the human attendant.

---

And After the 10 Minutes?

The agent in the air is just the starting point. The real work of maximizing results is in:

• Analyzing real conversations and refining the personality.
• Adding custom skills for specific business operations (inventory check, payment verification, etc).
• Configuring intelligent handoff when the agent needs to call a human.
• Tracking metrics of resolution vs escalation.

We cover each of these in separate posts — but first, it's worth understanding what happens inside the agent with each turn of conversation to set expectations.