Tutoriais
How to Create an AI Agent on WhatsApp in 10 Minutes
Tutoriais
10 min read
May 27, 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, covering 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: get Meta API approval, code the integration, host a server, test. With OpenClaw, the same deliverable 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 getting started

Three things (and nothing else):

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

No credit card needed on the free plan. No business registration number required (although we recommend it). No need to know what a webhook is.


Step 1 — Create your account (1 min)

Go to openclaw.com.br, click 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 point: The confirmation email sometimes lands in Gmail's spam. If it hasn't arrived within 1 min, check your "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 around, 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 Assistant, Solar Clinic Assistant.

Objective

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

  • Qualify new leads and schedule a free evaluation with a consultant.
  • Answer questions about our courses, apply discount coupons, and send payment links.
  • 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 plain text. Example we use as a baseline:

Tone: casual Brazilian style, friendly but professional. Emojis can be used sparingly (1 per message).

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

Never: promise discounts that aren't in the catalog. Talk about competitors. Make up times or prices. Answer health/legal/financial questions — route 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 working 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're going to use a number that isn't on any WhatsApp yet.
  • 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've 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 no one gave you access, you won't be able to 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 doesn't exist yet, Meta creates it on the spot through the embedded interface.

3.4 Verify the number

Meta sends an SMS code or phone call to the number you're connecting. Enter the code in the OpenClaw interface.

Common friction #2: If you've already used this number on a WhatsApp (personal or business app), the code won't arrive. Solution: uninstall WhatsApp from that number on the 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 all set.


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, office, studio Google Calendar
Digital 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. Authorize with the Google account that has the business calendar.
  3. Choose which calendar the agent can query / create events on.
  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)

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?"
  • "are you open on Saturdays?"
  • "I want to schedule"
  • "I need to talk to a human"

Watch the responses. Go back to the OpenClaw dashboard → Conversations to see the transcript.

Fix 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 missing rule. 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. Goal is too generic. An agent with a vague goal gives vague answers. Rewrite it with the concrete outcome you expect.
  2. Forgetting negative constraints. "Never make up a price" is worth more than "be professional." Negative rules provide better guidance.
  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 scheduled anything.
  4. Thinking it's ready after the first test. The first 20-30 real turns reveal patterns you didn't anticipate. Set aside 1 week to iterate before turning off the human agent.

And after the 10 minutes?

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

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

We cover 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 May 27, 2026

Read also