All guides

How to Create Your First WhatsApp AI Agent (Step by Step)

Watsy Team·

Your WhatsApp number can answer customers around the clock. No more missed messages at midnight. No more “sorry for the late reply.” This guide walks you through building your first AI agent in Watsy, start to finish.

What an AI agent actually is

An agent is your business’s voice on WhatsApp. You give it a personality, a set of instructions, and a few abilities. Then it talks to customers the way you would, replies instantly, and pulls in a human teammate when a conversation needs one.

You stay in control the whole time. The agent only does what you tell it to do.

Step 1: Create the agent and give it a persona

Open your dashboard and go to AI Agents, then create a new one.

The most important field here is the instructions, sometimes called the persona or system prompt. This is where you describe who the agent is and how it should behave. Keep it clear and specific:

  • Who it is — “You are the support assistant for Layla Bakery.”
  • Tone — friendly, warm, professional. Pick what fits your brand.
  • What it does — answer questions about hours, location, and orders.
  • What it should never do — never make up prices, never promise refunds.

You do not need to write a novel. A focused paragraph beats a wall of text.

Step 2: Choose a model

Every agent runs on an AI model. Think of it as the brain. Watsy lets you pick.

  • Fast everyday models are quick and affordable. They handle the bulk of normal customer questions beautifully. Start here.
  • Frontier models are more powerful and better at tricky reasoning or nuanced replies. Reach for one when your conversations are complex or high-stakes.

You can switch models anytime, so do not overthink the first pick. Start fast, upgrade if you need to.

Step 3: Add Skills and the handoff tool

Skills are playbooks you write for specific situations, like “Returns policy” or “Booking a table.” The agent loads the right one only when a conversation calls for it. This keeps your main instructions short and your answers accurate.

You will also want the human-handoff tool turned on. This lets the agent pass a conversation to a real teammate when it is out of its depth, when a customer is upset, or when someone simply asks for a person. The teammate gets notified and can take over from the shared inbox.

Add a Skill or two now if you have policies ready. You can always add more later.

Step 4: Assign it to your WhatsApp number

An agent does nothing until it is connected to a number. In your workspace, assign the agent to the WhatsApp number you want it to answer on.

One workspace can hold many numbers, so you can run different agents for different lines if you like, for example one for sales and one for support.

Step 5: Test it in the Playground

Before any real customer sees it, test privately in the Playground. Chat with your agent exactly like a customer would.

  • Ask the easy questions. Then ask the awkward ones.
  • Check the tone. Does it sound like your brand?
  • Try a question that should trigger a handoff and confirm it does.

If something feels off, tweak the instructions and test again. This loop is where good agents are made.

Step 6: Go live

Happy with it? Turn it on. Your agent now replies to real customers on WhatsApp, day and night, in their language.

Keep an eye on the shared inbox for the first few days. You will spot small things to refine, and every tweak makes the agent sharper.

That is it. You just gave your business a tireless first responder. Start simple, watch real conversations, and improve as you go.