DocsTrain your agentAI Agent Configuration

AI Agent Configuration

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

Last updated October 16, 2026

The written guide below is always the most up-to-date version.
On this page
AI Agent Configuration — Waslo dashboard

The AI Agent Section

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

The AI Agent section in the sidebar with its 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.

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):
TemplateBest for
Sales & Lead ClosingQualify leads, handle objections, close deals
Customer SupportTroubleshooting, FAQ, ticket resolution
Appointment BookingGeneric scheduling
Real Estate AgentProperty inquiries, viewings, pricing
E-commerce StoreProduct questions, orders, returns
RestaurantReservations, menu, take-away orders
Beauty Salon / SpaService bookings, reschedules
Clinic / MedicalAppointment booking, FAQ, insurance
Auto DealerTest drives, model comparisons, finance
Education / TutoringCourse info, enrollment
Travel AgencyItineraries, last-minute help
Hotel & HospitalityRoom enquiries, booking links, event callbacks
Gym & FitnessMemberships, free-trial booking, class schedules
General AssistantMulti-purpose balanced assistant
  1. Fill in your business details — name, services, opening hours and location. These become [PLACEHOLDERS] in the generated prompt
  2. Preview the generated instructions
  3. Click Save AI Configuration
Easy Setup showing the generated instructions before saving

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.

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.
The Reply language setting on the AI Personality page

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
The Context Selector choosing a specific WhatsApp number

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

Was this page helpful?

Still stuck?Talk to our team

Related guides

Ready to get started?

75 free credits on signup — no card needed.

Get Started →