​
Creating a Hybrid AI Agent

A Hybrid Agent combines both voice and text capabilities, giving users the flexibility to chat or speak naturally. Follow this guide to set up your hybrid agent from start to finish.

​
🧩 1. Basic Configuration

​
Required Fields:

  • Agent Name: Internal reference for your AI agent.
  • Core Instructions: Describe the main goal of this agent. You can use pre-built (or pre-defined templates) such as customer support agent, sales agent, technical support agent, live chat companion agent, lead qualification agent, hr specialist agent, and marketing agent.
  • Starter Questions:
    • Shown as clickable prompts to guide users
  • Temperature:
    • Controls creativity: 0 = more accurate, 1 = more creative

​
🎨 2. Appearance Settings

You can fully customize how your chatbot appears:
  • Bot Avatar: Upload a profile image (.jpg, .png, .webp).
  • Accent Color: Widget’s theme color.
  • Position: Left, Center, or Right of the screen.
  • Font: Pick a font for all widget text (e.g., Times New Roman).
  • Widget Behavior:
    • Toggle Wittify branding visibility.
    • Toggle whether the widget opens automatically.

​
🌐 3. Voice Settings

  • Voice Selection: Pick a voice provider (e.g., ElevenLabs voice like “Sarah”).
  • Auto Detect Language: Automatically switch language based on user speech.
  • Toggle Allow Interruption: Allow user to interrupt while the agent is speaking.

​
🔧 Advanced Settings

  • End call on silence: If there’s no audio input from the user for 60 seconds, the call will automatically end.
  • Max call length: The AI call will automatically end after 10 minutes, regardless of the conversation state.
  • Time before widget pop up: Time delay before the AI widget appears on the screen after a trigger event.
  • min_speech_duration: The shortest time the AI considers as valid speech from the user.
  • min_silence_duration: Defines how long a pause must be before the AI interprets it as “silence” and possibly takes action.

​
📚 4. Knowledge Base

​
📁 Upload Files

Upload .PDF, .DOC, or .XLS (up to 100MB) Paste a link to ingest public content directly.

​
❓ Add FAQs

Create question-answer pairs to train your hybrid agent on key use cases. Click Upload and Train after each content type.

​
⚙️ 5. Languages

  • Choose the languages your bot can respond in (e.g., English, Arabic, Spanish, and/or French).

​
Advanced Options

  • Header Title: Label shown at the top of the chatbot.
  • Header Subtitle / Tagline: Short tagline shown directly under the header title. Use it to communicate the bot’s purpose.
  • Welcome Message: Displayed when the agent first opens. Should invite the user to engage naturally.
  • Text Input Field Placeholder: This is the placeholder text inside the input box before the user types.
  • Disclaimer Text: A line displayed to notify users of potential limitations or errors in AI behavior.

​
🔌 6. Integrations

Wittify Hybrid Agents support third-party tools:
  • Salesforce For managing customer support
  • Google Calendar, Calendly, Cal for appointment scheduling
Click Connect and authorize the integration.

​
🌐 7. Embed & Activate Agent

​
Deployment Options:

  • Website Embed: Copy the provided <script> to your site
  • Allowed Domains: Restrict widget visibility to specific URLs

​
Connect Messaging Platforms:

  • WhatsApp
  • Instagram
  • Messenger

​
✅ Final Step

Click Save Changes to activate your Hybrid Agent.
🚀 Your bot is now live — fully enabled for voice and text!