# AI Agent Configuration

> Shape your AI's personality, knowledge, classification rules, and handoff triggers across every channel.

Source: https://waslo.io/docs/ai-agent-configuration · Last updated: 2026-10-16

## The AI Agent Section

Open **AI Agent** in the sidebar — it has its own dedicated section (not buried in Settings). Inside, five pages:

- **AI Personality** — system prompt + welcome message
- **Classification** — how the AI scores leads: HOT / WARM / COLD, or stages you name yourself
- **Auto Follow-up** — when + how the AI re-engages quiet leads
- **Handoff to a person** — when the AI gives up and pings your team
- **Voice Replies** (Growth) — the AI answers with a voice note

The product catalog is not on this list: it lives under **Work → Catalog** in the sidebar. See [Product Catalog](/docs/product-catalog).

Each sub-page also has its own **Context Selector** at the top — letting you configure org-default behavior OR override per WhatsApp number OR per channel (Telegram, Instagram, Messenger, Outlook; Gmail is in early access).

## AI Personality

This is where you shape *who* the AI is — its identity, tone, and behavioral rules. Two ways to configure:

### Easy Setup (Wizard)

1. Open **AI Agent → AI Personality**
2. Toggle to **Easy Setup**
3. Pick a template from the gallery (14 options):

| Template | Best for |
|----------|----------|
| Sales & Lead Closing | Qualify leads, handle objections, close deals |
| Customer Support | Troubleshooting, FAQ, ticket resolution |
| Appointment Booking | Generic scheduling |
| Real Estate Agent | Property inquiries, viewings, pricing |
| E-commerce Store | Product questions, orders, returns |
| Restaurant | Reservations, menu, take-away orders |
| Beauty Salon / Spa | Service bookings, reschedules |
| Clinic / Medical | Appointment booking, FAQ, insurance |
| Auto Dealer | Test drives, model comparisons, finance |
| Education / Tutoring | Course info, enrollment |
| Travel Agency | Itineraries, last-minute help |
| Hotel & Hospitality | Room enquiries, booking links, event callbacks |
| Gym & Fitness | Memberships, free-trial booking, class schedules |
| General Assistant | Multi-purpose balanced assistant |

4. Fill in your business details — name, services, opening hours and location. These become `[PLACEHOLDERS]` in the generated prompt
5. Preview the generated instructions
6. Click **Save AI Configuration**

### Advanced Mode

Write your own system prompt from scratch. Best for niche businesses or fine control. Free-text editor with a 20,000-character limit.

**Fill every blank.** Templates contain blanks in square brackets, like `[YOUR ADDRESS]`. Waslo shows a warning listing each one and will not save instructions that still contain a blank — otherwise the agent would invent the answer.

### Welcome Message

A greeting Waslo sends only when you add a lead yourself from the **Leads** page (a toggle there lets you skip it for that lead). It is not sent to leads imported from CSV or to leads that arrive through the inbound lead webhook, and it is never sent as a reply to a customer who writes first; the agent answers those directly with its normal reply. Personalize with `{{name}}` to insert the customer's name (when known).

## Knowledge Base

Top-level sidebar item under **AI** section. This is what your AI *knows* about your business — pricing, hours, product catalog, policies, FAQs.

Supported sources:
- **Upload** PDFs, DOCX, TXT, CSV (≤50 MB each)
- **Notion** — share pages with your Waslo integration

Caps: 50 docs on PAYG, 200 on Growth.

Once indexed, every AI reply automatically retrieves and cites the most relevant chunks. The AI sees a top-priority "KNOWLEDGE BASE — your authoritative source" block at the top of every prompt.

## Lead Classification

Trains the AI to score every new lead as **HOT**, **WARM**, or **COLD** based on conversation analysis. Edit the criteria in **AI Agent → Classification**.

Defaults are sensible — tighten as you watch real conversations.

## Auto Follow-up

When **enabled**: the AI re-engages any lead that goes quiet after the agent spoke last, whatever its stage, after a configurable delay (default 24h). Sends up to N follow-ups (default 2), then gives up. See [Automated Follow-up](/docs/automated-follow-up).

When **disabled**: the AI replies once and lets the lead lapse if they don't respond.

## Human Handoff

Lets the AI step aside when:
- The customer asks for a human ("agent", "human", "موظف", or custom keywords)
- The conversation tone signals frustration
- The classification turns HOT and you want a human in the loop

When triggered: the AI stops replying on that conversation, the lead is flagged in your **Inbox**, and you get a Telegram ping (if configured).

## How the agent writes

- **Arabic dialects in text replies**: the agent mirrors the customer's dialect when it can tell it (Gulf, Egyptian, Levantine and others) and uses Modern Standard Arabic when it's unsure. If your prompt says which Arabic to use, your prompt wins.
- **No repeated greetings**: in the middle of a conversation the agent doesn't greet the customer or introduce itself again.
- **Reply language**: by default the agent replies in the language each customer writes or speaks in. To serve one market in one language, open **AI Agent → AI Personality** and choose **Reply language** — for the whole organization, or for one WhatsApp number or channel. A language chosen there wins over any language line in your prompt.

## Per-Channel + Per-Number Configuration

Every AI Agent page has a **Context Selector** that lets you scope settings to:

- **Org default** — applies to everything
- **A specific WhatsApp number** — override prompt / classification / follow-up for that number only
- **A specific channel** — override prompt for Telegram bot vs Instagram DM vs Email

Useful when, say, you want your Telegram bot to be casual but your Outlook AI to be formal.

**Turn the agent off on one number.** With a WhatsApp number selected, the **AI agent replies on this number** switch on the AI Personality page stops automatic replies on that number only. Messages still arrive in your inbox.

## Voice Replies (Growth)

On the **Growth** plan the AI can reply with a real voice note — not just text.

- **Mirror mode**: a customer voice note gets a spoken reply (in their language); typed messages still get text.
- Turn it on in **AI Agent → Voice Replies**, pick a voice per language (male / female + options), and preview it before saving.
- A text copy of every spoken reply is saved to the conversation.
- Available on WhatsApp (QR + Cloud) today. Spoken Arabic follows the customer's dialect when it can tell it (Gulf, Egyptian, Levantine and others), like text replies do.

## Product Catalog

On every plan you can give the AI a product catalog to sell from.

- Add products in **Catalog** (sidebar): name, price, an in-stock toggle, and a photo you upload (a PDF brochure too). You can also import a CSV, or sync the catalog from your Shopify, Salla, Zid or ikas store.
- The AI answers product / price / availability questions — quoting only what you added, and saying it will check when something isn't in the catalog.
- It sends a product photo when the customer asks to see it (inline on WhatsApp / Telegram / Instagram / Messenger; a link on email).
- Toggle stock per product so the AI won't pitch what's sold out.

## Next Steps

- [Lead Management](/docs/lead-management) — how leads flow through the dashboard
- [Integrations](/docs/integrations) — connect more channels
- [Human Handoff](/docs/human-handoff) — handoff triggers + escalations
