Tutoriais
How to Create an AI Agent on WhatsApp in 10 Minutes
Tutoriais
10 min read
27 May 2026

How to Create an AI Agent on WhatsApp in 10 Minutes

From sign-up to your first conversation in 10 minutes. An honest step-by-step guide, no code required, with the 4 most common friction points and how to solve them.

Equipe OpenClaw

Equipe OpenClaw · Time de Engenharia & Produto

A Equipe OpenClaw é formada por engenheiros, designers e especialistas em IA dedicados a construir a melhor plataforma de agentes conversacionais para negócios brasileiros. Combinamos expertise…


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: getting Meta API approval, coding the integration, hosting a server, testing. With OpenClaw, the same delivery runs in 10 minutes from sign-up to the first real conversation. This post is an honest step-by-step guide — with the 4 friction points you'll encounter and how to get past each one.

TL;DR: Sign up → describe the agent in text → connect WhatsApp Business → set up 1 integration → first conversation. ~10 min. Not a single line of code.


What you need before you start

Three things (and nothing more):

  1. WhatsApp Business account (the free app from Meta — don't confuse it with the personal one).
  2. A dedicated phone number. It can be a landline, virtual, or mobile number — but it cannot be in use on personal WhatsApp.
  3. 10 uninterrupted minutes. The flow breaks if you leave in the middle of authentication.

You don't need a credit card on the free plan. You don't need a business registration number (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
  • Your business name

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

Common friction: The confirmation email sometimes lands in Gmail's spam. If it hasn't arrived in 1 min, check the "Promotions" or "Spam" folder.


Step 2 — Describe the agent in natural language (3 min)

This is where OpenClaw differs from most platforms. Instead of building a flowchart by dragging 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. E.g.: Sofia, OpenClaw Attendant, Solar Clinic Assistant.

Objective

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

  • Qualify new leads and schedule a free assessment 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. (the objective becomes a list of adjectives — bad)

Personality and restrictions

Here you provide the "brand manual" in running text. Example we use as a baseline:

Tone: casual Brazilian, close but professional. You can use emojis sparingly (1 per message).

Always: introduce yourself on the first turn. Use the customer's first name when you know it. Confirm scheduling twice.

Never: promise discounts that are not in the catalogue. Talk about competitors. Make up times or prices. Answer health/legal/financial questions — forward to a 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 causes the most friction and where most platforms lose the user. OpenClaw shortens Meta's official flow into a linear sequence.

3.1 Start connection

On the dashboard, click Integrations → WhatsApp → Connect. Choose:

  • New number: if you are going to use a number that is not yet on any WhatsApp.
  • Migrate from WhatsApp Business (app): if you already have the WhatsApp Business app installed and want to transfer the number to the API. Note: the app stops working after migration.

3.2 Authenticate with Meta

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

Common friction #1: Your personal Facebook account needs to be an admin of the Business Manager. If nobody gave you access, you cannot get past this screen.

3.3 Select / create WhatsApp Business Account

Within Meta's authentication, you choose which WABA (WhatsApp Business Account) to use. If one does not exist yet, Meta creates it on the spot through the embedded interface.

3.4 Verify the number

Meta sends an SMS code or call to the number you are going to connect. Enter the code in the OpenClaw interface.

Common friction #2: If you have already used this number on a WhatsApp (personal or business app), the code does not arrive. Solution: uninstall WhatsApp from that number on the phone BEFORE starting the connection.

3.5 Configure webhook

OpenClaw configures the webhook automatically. You do not need to do anything. When the screen shows Number connected ✅, you are ready.


Step 4 — Plug in ONE integration (2 min)

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

Your business First integration
Clinic, practice, studio Google Calendar
Info product, 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. Authorise with the Google account that has the operation's calendar.
  3. Choose which calendar the agent can query / create an event in.
  4. Set the window (e.g.: Mon-Fri 9am-6pm, Sat 9am-1pm).
  5. Save.

Done. The agent now checks available times in real time and creates events without human intervention.


Step 5 — First real conversation (1 min)

Pick up 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 dashboard → Conversations to see the transcript.

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


The 4 most common mistakes in the first 10 minutes

  1. Objective too generic. An agent with a vague objective gives vague answers. Rewrite it with the concrete result you expect.
  2. Forgetting negative constraints. "Never make up a price" is worth more than "be professional". Negative rules guide better.
  3. Skipping integration and testing with text only. An agent without a calendar in the clinic example becomes decorative — the customer leaves the conversation without having booked anything.
  4. Thinking it's ready after the first test. The first 20–30 real turns reveal patterns you didn't foresee. Set aside 1 week to iterate before switching off the human attendant.

And after the 10 minutes?

The agent being live is just the starting point. The real work of maximising results lies in:

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

We covered each of these in separate posts — but first it's worth understanding what happens inside the agent at each conversation turn to calibrate expectations.


Equipe OpenClaw

Published on 27 May 2026

Read also