AI Agents
Create a Voice AI Agent
A complete step-by-step guide to creating, customizing, and deploying your Wittify.ai voice agent for websites and telephony systems.
Build, Configure, and Deploy Your Voice-Based AI Agent
A Voice Agent ๐ lets you hold real-time spoken conversations with customers, either:- Through a voice-enabled web widget on your website
- Over the phone via telephony integration (currently Twilio)
- Through a custom SIP connection (available on request for other telephony systems, e.g. Avaya, Cicsco, and Genesys, or mobile apps. Use the contact us form or click on support button on the top right side of the page to request a custom integration).
โ ๏ธ Important: Voice agents cannot be connected to social channels or messaging apps such as WhatsApp, Messenger, or Instagram. They are designed only for website and phone use.
1๏ธโฃ Basic Configuration โ Define Your Agentโs Identity & Behavior
This section is where you give your voice agent its identity, role, and communication rules.๐ท 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 Voice Support,Sales Voice 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 voice 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 โ 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)
- You can 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).
โ Save to continue โ Appearance
2๏ธโฃ Appearance โ Customize Your Voice Agentโs First Impression
The Appearance section controls what customers see and hear first when interacting with your voice 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 (Voice-specific) โ This is the first thing the voice agent will say when a call starts.
- Voice Agent Call to Action (CTA) โ Text inviting the user to start speaking.
- 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 voice 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 the whole call.
โ Save to continue โ Voice Settings
3๏ธโฃ Voice Settings โ Control How Your Agent Sounds & Listens ๐
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 callerโ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
These settings let you fine-tune the flow and responsiveness of the call:- End Call on Silence (seconds) โ How long to wait if no one speaks before ending the call.
- Max Call Length (minutes) โ The total duration limit for the call.
- 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).
โ Save to continue โ Knowledge Base
4๏ธโฃ Knowledge Base โ Teach Your Voice Agent
The Knowledge Base works just like for Text Agents, but remember:- Voice agents read responses aloud.
- Long answers will take longer to speak โ keep them concise.
๐ 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 knowledge-base of the Agent. 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 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 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
โ Save to continue โ Deployment
6๏ธโฃ Deployment โ Go Live ๐
๐ Website Widget
- Copy the embed code from Deployment.
- Paste it before
</body>on your website/app. - Set Allowed Domains to control where the widget loads.
๐ Phone Lines
- Connect to Twilio in the Integrations page. You will need to add your Twilio Account SID, Auth Token, and your number.
โ Testing & Go-Live Checklist
Before going live:- Test welcome message for clarity and tone.
- Call in and check voice quality.
- Try interrupting the agent mid-sentence to ensure smooth handling.
- 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.