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 registration 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: Registration → describe the agent in text → connect WhatsApp Business → configure 1 integration → first conversation. ~10 min. No code.

---

What You Need Before Starting

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 cellular — 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 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:

Note: The original markdown content was translated exactly, preserving all formatting and not translating URLs, code, or HTML tags.

Tom: casual Brazilian, 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 listed 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 /cham_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 Initiate connection

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

• New number: if you're using 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 no one 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 sends 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 initiating 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 one integration. We recommend starting with the one that generates the most value for your case:

(Note: The rest of the content remains the same as the original markdown)

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	Primary 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.
4. Define the time slot (e.g. mon-fri 9am-6pm, sat 9am-1pm).
5. Save.

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

---

Step 5 — First Real Conversation (1 min)

Take 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 made a mistake or invented something, 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 Errors 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 at each turn of conversation to set expectations.