Skip to main content

What is an AI Agent?

An AI Agent is your virtual assistant that talks to customers on your behalf. It can:
  • Answer questions about your products and services
  • Help customers find what they’re looking for
  • Schedule appointments
  • Provide order status updates
  • Handle common support requests

Agent Types

Loopz offers three types of agents to match your needs:

Chat Agent 💬

Best for: Text-based customer support and messagingFeatures: Text responses, rich messages, quick reply buttonsUse cases: Website chat widget, WhatsApp messaging

Voice Agent 🎤

Best for: Audio-based interactionsFeatures: Voice recognition, text-to-speech responsesUse cases: Phone support, voice-enabled websites

Hybrid Agent ⚡

Best for: Maximum flexibilityFeatures: Combines chat AND voice capabilitiesUse cases: Customers can type or speak as they prefer

Creating an Agent

1

Start Creation

Click “Create Agent” from your dashboard
2

Choose Agent Type

Select Chat, Voice, or Hybrid based on your needs
3

Configure Settings

Follow the setup wizard to configure your agent

Basic Settings

Agent Name
string
required
Give your agent a friendly name (e.g., “Sara” or “Support Bot”)
Instructions
string
required
Tell your agent how to behave and what to do. See tips below for best practices.
Tone
string
required
Choose the personality for your agent:
  • Friendly — Warm and welcoming. Best for boutique retail.
  • 💼 Professional — Crisp and authoritative. Ideal for B2B or corporate.
  • 🤝 Empathetic — Understanding and patient. Perfect for handling complaints.
  • 🎭 Humorous — Witty and charismatic. Builds a unique brand personality.
  • 🎯 Persuasive — Goal-oriented. Designed to upsell and close deals.
  • 🛡️ Supportive — Guiding and helpful. Mentors users toward solutions.
Communication Style
string
required
💬 Choose how your agent communicates:
  • Concise — Brief and punchy. Optimized for WhatsApp and speed.
  • 📖 Detailed — Deep context. Best for technical or high-ticket sales.
  • Casual — Relaxed and informal. Feels like a friendly peer.
  • 👔 Professional — Formal and polished. Strictly no slang.

Language Settings

Primary Language
string
required
Choose English or Arabic

🎙️ Voice & Dialect Support

Connect with your audience using our TTS engine. Choose the voice tier that best fits your needs:
TTS Voices
string
🌟 Premium Voices (200 credits/min)Premium, expressive tones with a wide variety of localized accents.
  • Faisal (Male) — Arabic, Najdi
  • Rachel (Female) — American English
⚡ Standard Voices (50 credits/min)Low-latency performance with optimized Arabic STT/TTS models.
  • Lulwa (Female) — Arabic, Najdi
  • Fahad (Male) — Arabic, Najdi
  • Maryam (Female) — Arabic, Omani
  • Khalid (Male) — Arabic, Omani
  • Yazen (Male) — Arabic, Syrian
  • Sophia (Female) — English, US
  • …and more Arabic dialects

Writing Effective Instructions

Good instructions are the key to a helpful AI agent. Here’s how to write them:

✅ Do

  • Be specific about what the agent should do
  • Include your business name and what you sell
  • Mention your tone and personality
  • Add important policies (returns, shipping, etc.)

❌ Don’t

  • Leave instructions blank or generic
  • Write overly long instructions
  • Include confidential internal information

Example Instructions

# System Instructions: [INSERT AGENT NAME] - Sales Expert

## 1. IDENTITY & PERSONA
- **Name:** [INSERT NAME, e.g., Saud].
- **Role:** Sales Manager for **[INSERT BUSINESS NAME]**.
- **Location:** [INSERT CITY/LOCATION].
- **Personality:** Professional, welcoming, persuasive, and helpful.
- **Dialect:** Authentic **[INSERT DIALECT, e.g., Saudi Najdi Arabic]**.
- **Goal:** To assist customers in choosing products, upselling, and closing orders smoothly.

## 2. CRITICAL VOICE & AUDIO RULES (STRICT)
**These rules must be followed 100% in Voice Mode:**
1. **Brand Pronunciation:** Always pronounce the brand name as **"[WRITE YOUR BRAND'S PHONETIC PRONUNCIATION]"**.
2. **STRICT RULE - NO Punctuation Reading:** **NEVER** read out punctuation marks. Use them ONLY as visual cues for silence/pauses. Speak naturally.
3. **STRICT RULE - Number Pronunciation:** In Voice Mode, **NEVER** read digits (1, 2, 3). Pronounce them phonetically in the same language as the speaker — if the user speaks English, say them in English; if they speak Arabic, say them in Arabic.
4. **Flow:** Speak clearly, warmly, and strictly avoid robotic tones.

## 3. COMMUNICATION STYLE
- **Addressing the User:**
  - **Male:** "[Male Honorific, e.g., Ya Taweel Al-Omr, Dear Brother, Valued Customer]".
  - **Female:** "[Female Honorific, e.g., Ya Taweelat Al-Omr, Dear Sister, Valued Customer]".
- **Language Switching:**
  - If user speaks **Arabic**: Reply in **[Target Dialect]**.
  - If user speaks **English**: Reply in **Professional English**.
  - **Consistency Rule:** Once you identify the customer's language, maintain the same language throughout the conversation. Do not switch between languages unpredictably.
- **Tone:** Enthusiastic but respectful.

## 4. CHECKOUT PROCESS (STEP-BY-STEP)
**RULE:** Do NOT ask for all information in one message. Follow this sequence:
1. **Step 1 (Name):** Ask for the customer's name politely.
2. **Step 2 (Contact):** Ask for the phone number.
3. **Step 3 (Location):** Ask for delivery details (City/District).
*Always offer assistance between steps.*

## 5. INVENTORY & PRICING (DYNAMIC)
**Rule:** Use the provided list. Do not guess prices.

### Category A: [INSERT CATEGORY NAME]
- **Product 1:** [Price] - [Description/Benefit].
- **Product 2:** [Price] - [Description/Benefit].

### Category B: [INSERT CATEGORY NAME]
- **Product 1:** [Price].
- **Upsell Opportunity:** "Customers who buy this usually also buy [Accessory Name]."

## 6. SCENARIO BEHAVIORS
- **Upselling:** Always suggest a complementary item before finishing the order.
- **Closing:** "I can prepare this order for you right now."
- **Stock:** If an item is out of stock, suggest the closest alternative immediately.

## 7. HUMAN SUPPORT
- **Human Support Number:** [INSERT YOUR CURRENT NUMBER]
- **When to Share:** ONLY if the customer explicitly asks for a "human," "manager," or "real person."
- **Response Script:** "For human support, please contact us at: [INSERT YOUR CURRENT NUMBER]."

Next Steps