AI Agents
Create a Hybrid AI Agent
A complete step-by-step guide to creating, customizing, and deploying your Wittify.ai hybrid text-and-voice agent for websites and web-based applications.
Build, Configure, and Deploy Your Hybrid AI Agent
A Hybrid AI Agent ๐๐ฌ lets you interact with customers in both text and voice modes in real time. It can be used:- On websites with the hybrid widget.
- Inside web-based applications.
โ ๏ธ Important: Hybrid agents cannot be connected to social channels, messaging apps (WhatsApp, Messenger, Instagram), or telephony systems (including Twilio).
They are designed only for websites and web-based apps.
1๏ธโฃ Basic Configuration โ Define Your Agentโs Identity & Behavior
This section is where you give your hybrid agent its identity, role, and communication rules.It combines both text agent and voice agent configuration elements.
๐ท Agent Name (Required)
- Internal use only โ This name appears in your Wittify dashboard, not to customers.
- Choose a clear, descriptive name so you can identify the agent later (e.g.,
Website Hybrid Support,Sales Hybrid Bot โ EN/AR). - Avoid generic names like โAgent 1โ โ be specific so your team knows its purpose.
- This name is not shown to end users.
๐ง Core Instructions (Required)
This is the System Prompt โ the โbrainโ of your hybrid agent. Think of it as training a new employee: you must clearly explain how they should do their job. Include:- Role & Goal โ Whatโs the main purpose? Support, sales, bookings, lead qualification, etc.
- Tone & Style โ Warm, professional, formal, casual, energetic โ match your brandโs voice.
- Language & Dialect โ Be specific (e.g., English โ US, Arabic โ Saudi, Arabic โ Egyptian).
- Speech Style (for voice responses) โ Should the agent give short and concise answers or longer, detailed explanations?
- Boundaries โ Topics it must avoid (e.g., no legal or medical advice, no personal opinions).
- Compliance Requirements โ Reference company policies or industry regulations it must follow.
๐ก Guidance:
- Be precise โ vague instructions cause inconsistent answers.
- Write in full sentences.
- If your business requires disclaimers, include them here.
๐ Use Pre-Built Templates (Optional)
- Start faster by applying a ready-made role (e.g., Customer Support Agent, Sales Agent).
- After applying, edit the Core Instructions to match your specific business needs and policies.
- Templates save time, but always customize for accuracy.
๐จ Creativity Level (Temperature)
Controls how precise or creative the agent is:- 0.0 โ 0.3 โ Deterministic, factual answers (best for policies, FAQs).
- 0.4 โ 0.6 โ Balanced, flexible but reliable (good for most customer service).
- 0.7 โ 1.0 โ Highly creative, more varied responses (marketing, brainstorming).
2๏ธโฃ Appearance โ Customize Your Hybrid Agentโs First Impression
The Appearance section controls what customers see and hear first when interacting with your hybrid agent.๐ Conversation Interface Language
- Supports up to 4 interface languages at the same time.
- Auto-detects the website language and adjusts RTL/LTR text direction.
- Customize for each selected language:
- Header Title โ Shown at the top of the widget.
- Header Subtitle / Tagline โ Short phrase under the title.
- Welcome Message โ
- (For Text): First text message shown in the chat window.
- (For Voice): First sentence the agent will speak when a voice conversation starts.
- Voice Call to Action (CTA) โ Text inviting the user to start voice interacting, e.g., โSpeak with our Voice Agentโ.
- Disclaimer Text โ Shown below; e.g., โThis AI agent can make mistakes. Check important information.โ
๐จ Branding
- Company Logo โ Appears in the widget header.
- Bot Avatar โ The visual icon representing your hybrid agent.
- Primary Color โ Matches your companyโs branding.
- Font โ Select your preferred font style.
- Widget Position โ Left, Center, or Right on your website.
- Powered by Wittify โ Option to hide (available in Premium plan only).
๐ก Pro Tip: Keep the welcome message friendly and short โ it sets the tone for both text and voice interactions.โ Save to continue โ Voice Settings
3๏ธโฃ Voice Settings โ Control How Your Agent Sounds & Listens ๐
Hybrid agents support voice just like a voice agent, so here you define the voice personality, call flow, and interaction rules.๐ค Select Voice
- Choose from multiple male and female multilingual voices.
- Click Play ๐ to preview each voice.
- Click Use Voice to apply your choice.
- Custom Test Script โ Type up to 140 characters to preview the voice with your own text.
- Example: โWelcome to our company! How can I assist you today?โ
๐ Core Voice Options
- Enable Auto Detect Language โ The agent automatically detects and responds in the userโs language.
- Allow Interruption โ Customers can interrupt the agent while itโs speaking.
Enabling this makes conversations feel more natural and human-like.
โ Advanced Voice Settings
Fine-tune the flow and responsiveness of voice interactions:- End Call on Silence (seconds) โ How long to wait if no one speaks before ending the voice session.
- Max Call Length (minutes) โ The total duration limit for the voice session.
- Time Before Widget Pop-Up (seconds) โ How soon the widget appears after page load.
- Min Speech Duration (seconds) โ Minimum length of user speech to be registered (avoids false triggers from short noises).
- Min Silence Duration (seconds) โ Minimum pause before the agent starts speaking (prevents cutting the user off too quickly).
4๏ธโฃ Knowledge Base โ Teach Your Hybrid Agent
The Knowledge Base works just like for Text and Voice Agents combined.Key Notes:
- Hybrid agents display responses in text and read them aloud in voice mode.
- Long answers will take longer to speak โ keep them concise for better voice experience.
- Your agent can only answer well if it has accurate and updated knowledge.
๐ Files
- Upload PDFs, Word docs, Excel sheets, or text files (max 100MB each).
- Click Upload & Train to process the content.
๐ Links
- Add trusted URLs โ such as your website, help center, FAQs, or policy pages.
- The content of the added URLs will be added to the agentโs knowledge base.
To update the content of a specific page, remove and re-add the URL.
โ FAQs
- Add specific Q&A pairs for precise, controlled answers.
- Useful for pricing, shipping, policies, etc.
๐ก Tip: Keep your Knowledge Base updated regularly to avoid outdated responses.
5๏ธโฃ Integrations & Tools โ Connect to Your Systems
Link your hybrid agent to external systems or enable Wittifyโs built-in tools.๐ Built-in Tools
- Lead Data Collection:
- Enable to collect name, email, and phone automatically.
- Add a custom lead request message, and give instructions to the agent on how to behave.
- Captured leads appear in your Inbox.
๐ External Integrations
- CRMs โ Salesforce, Zendesk (send leads/tickets automatically).
- Booking โ Google Calendar, Calendly (real-time scheduling).
๐ Coming Soon
- MCP Server โ Connect to almost any system.
- Search Tool
- Advanced Ticketing
Note: Each integration card includes a Connect button and may show which agent types it supports. Follow the in-app flow to authorize the connection.โ Save to continue โ Deployment
6๏ธโฃ Deployment โ Go Live ๐
๐ Website Widget
- Copy the embed code from the Deployment page.
- Paste it before
</body>on your website/app. - Set Allowed Domains to control where the widget loads.
โ Testing & Go-Live Checklist
Before going live:- Test welcome message for clarity and tone in both text and voice modes.
- Check voice quality and text accuracy.
- Try interrupting the agent mid-sentence in voice mode.
- Test silence timeout settings.
- Verify lead collection and recordings in Inbox.
Notes
- You can edit and re-deploy at any time; remember to Save each step.
- Keep your Knowledge Base accurate and up to date to avoid hallucinations.
Deactivate Agent (anytime)
From the Deployment page, use Deactivate to temporarily disable the agent without deleting its configuration.โธ You can deactivate an agent anytime from the Deployment page.