Build your AI-powered
customer agent
StudioMeta Voice AI adds a real-time voice agent and AI chatbot to any WordPress site. Connect it to your automation workflows and let it capture leads, answer questions, and take actions — 24/7.
Overview
Everything your business needs to deploy a live AI agent on your website.
[smva_widget] shortcode on any page or post.Installation
Get up and running in under 5 minutes.
studiometa-voice-ai-1.3.72.zip from your StudioMeta account or the pricing page.[smva_widget] to any page or post, or enable the floating widget in the Widget tab. Configure your agent in My Agent and click Save & Sync Agent.General
Basic appearance and language settings for your widget.
| Field | Description |
|---|---|
| Business Name | Displayed in the widget header — use your real business name |
| Language | Sets the widget language and text direction. Supports RTL for Persian and Arabic. |
| Chat Greeting | The first message shown to visitors when they open the chat tab |
My Agent
Configure your AI agent's personality, voice, and knowledge.
| Field | Description |
|---|---|
| Voice | Choose from 30 available voices — preview any before going live. See Voice Reference for the full list. |
| Speech Speed | Slow / Normal / Fast — affects voice call delivery pace |
| Voice Greeting | The first sentence the agent speaks when a voice call starts |
| System Prompt | Instructions that define your agent's personality, rules, and behavior |
| Knowledge Base | Your business information: services, pricing, hours, policies, FAQs |
| Agent Timezone | Injects the correct current date and time into the agent's context |
| ✨ Optimize with AI | Auto-rewrites and improves your system prompt and knowledge base with one click |
| 🔍 Import from website | Crawls your website URL and extracts business information automatically |
| 💾 Save & Sync Agent | Saves all settings and syncs them to the AI backend |
System Prompt Tips
Your system prompt defines how the agent behaves. Be specific about what it should and should not do. Include your business name, tone of voice, topics to focus on, and any rules for taking actions.
Knowledge Base Tips
Include everything your agent needs to answer visitor questions accurately: services, pricing, hours, location, contact details, and FAQs. The more complete your knowledge base, the better your agent performs.
Voice Reference
30 voices available — use the TTS Preview button in the My Agent tab to audition any voice before going live.
| Voice | Gender | Character |
|---|---|---|
| ▶️ Puck Click to play sample |
Male | Upbeat, playful, energetic |
| ▶️ Charon Click to play sample |
Male | Deep, measured, authoritative |
| ▶️ Kore Click to play sample |
Female | Warm, steady, professional |
| ▶️ Fenrir Click to play sample |
Male | Confident, direct, bold |
| ▶️ Aoede Click to play sample |
Female | Smooth, melodic, friendly |
| Orbit | Male | Neutral, clear, calm |
| ▶️ Zephyr Click to play sample |
Female | Light, bright, conversational |
| Perseid | Male | Thoughtful, refined, composed |
| ▶️ Callirrhoe Click to play sample |
Female | Gentle, expressive, warm |
| ▶️ Autonoe Click to play sample |
Female | Clear, articulate, poised |
| ▶️ Enceladus Click to play sample |
Male | Strong, resonant, grounded |
| ▶️ Iapetus Click to play sample |
Male | Calm, deliberate, trustworthy |
| ▶️ Umbriel Click to play sample |
Male | Soft, understated, neutral |
| ▶️ Algieba Click to play sample |
Male | Rich, smooth, self-assured |
| ▶️ Despina Click to play sample |
Female | Lively, upbeat, approachable |
| Erinome | Female | Clear, precise, composed |
| ▶️ Algenib Click to play sample |
Male | Crisp, focused, efficient |
| Rasalased | Male | Gentle, measured, reassuring |
| ▶️ Laomedeia Click to play sample |
Female | Bright, natural, engaging |
| ▶️ Achernar Click to play sample |
Female | Soft, clear, refined |
| ▶️ Alnilam Click to play sample |
Female | Warm, steady, confident |
| ▶️ Schedar Click to play sample |
Male | Deep, authoritative, calm |
| ▶️ Gacrux Click to play sample |
Male | Mature, composed, deliberate |
| ▶️ Pulcherrima Click to play sample |
Female | Elegant, smooth, polished |
| ▶️ Achird Click to play sample |
Male | Friendly, approachable, neutral |
| ▶️ Zubenelgenubi Click to play sample |
Male | Low, grounded, trustworthy |
| ▶️ Vindemiatrix Click to play sample |
Female | Clear, professional, bright |
| ▶️ Sadachbia Click to play sample |
Male | Warm, conversational, relaxed |
| ▶️ Sadaltager Click to play sample |
Male | Confident, smooth, engaging |
| ▶️ Sulafat Click to play sample |
Female | Lively, expressive, vibrant |
Automation
Connect your agent to n8n, Make, Zapier, or any webhook to take real actions during conversations.
How It Works
When a visitor asks the agent to do something (book an appointment, check availability, send a quote), the agent collects the required information and calls your webhook URL. Your automation platform handles the action and returns a result. The agent relays the result back to the visitor.
Webhook URL
Paste your webhook URL from n8n, Make, or Zapier into the Webhook URL field and click Save Webhook.
Agent Tools
Tools define what actions your agent can perform. Each tool has a name, a description that tells the agent when to use it, a list of parameters to collect from the visitor, and a thinking message shown while the webhook is processing.
| Field | Description |
|---|---|
| Tool Name | A unique identifier in lowercase with no spaces (e.g. book_appointment) |
| Description | Tells the agent when and why to use this tool — be specific and clear |
| Parameters | The information to collect from the visitor before calling the webhook |
| Thinking Message | What the agent says while waiting for the webhook response |
Widget
Customize the appearance and behavior of the floating widget on your site.
[smva_widget]. To show a floating widget sitewide, enable Show Floating Widget in this tab.
| Field | Description |
|---|---|
| Button Position | Place the widget in the bottom-right or bottom-left corner of the screen |
| Primary Color | Hex color code for the widget accent color — should match your brand |
| Show Floating Widget | Toggle the widget on or off across your entire site |
| Send Conversation Summary | Email a conversation summary to the license owner after each session ends |
| Default Tab | Which tab opens first when the widget is clicked — Voice or Chat |
| Silence Timeout | Seconds of silence before automatically ending a voice call (default: 60) |
| Max Call Duration | Maximum voice call length in minutes (default: 10) |
| Call Cooldown | Minimum wait time in seconds between voice calls (default: 0) |
Dashboard
Monitor your usage and review recent conversations.
| Metric | Description |
|---|---|
| Voice Minutes Used | Minutes consumed this month vs. your plan limit |
| Chat Messages Used | Messages consumed this month vs. your plan limit |
| Days Remaining | Days left in the current billing period |
| Recent Conversations | Recent voice and chat sessions with timestamps, duration, and transcripts |
Voice Call Flow
What happens from the moment a visitor starts a call.
Audio Pipeline
All voice communication runs over a plain WebSocket — no WebRTC. The browser captures and sends 16 kHz PCM audio (base64-encoded) to the backend, which processes it through StudioMeta's real-time AI engine. The agent's audio response (24 kHz PCM, base64-encoded) is streamed back to the browser in real time.
Chat Flow
How the chat widget processes messages and triggers actions.
The chat widget maintains full conversation history within the session. If an action is required, the agent collects all necessary information before calling the webhook — it will not call the tool until it has everything it needs.
Automatic Lead Capture
In both voice and chat modes, the agent automatically collects visitor name, phone, and email mid-conversation. Captured leads appear instantly in your Leads tab — no extra configuration required.
Webhook API Reference
The data format sent to your automation platform and what it expects back.
Tool Call Request
Sent to your webhook when the agent calls a tool — during both voice and chat.
{
"event": "voice_tool_call", // or "chat_tool_call"
"tool_name": "your_tool_name",
"tool_args": {
// parameters your tool defined
// e.g. name, email, phone, date, service...
},
"call_id": "call_abc123",
"license_key": "SM-XXXX-XXXX-XXXX",
"business_name": "Your Business Name",
"site_url": "https://yourwebsite.com",
"timestamp": "2026-05-13T13:00:00.000Z"
}
tool_args, not from the top level of the request body. Top-level fields are metadata about the request.
Call Completed Request
Sent to your webhook automatically when a voice call ends, for logging or email summaries.
{
"event": "call_completed",
"license_key": "SM-XXXX-XXXX-XXXX",
"customer_email": "[email protected]",
"duration_min": 3,
"transcript": "user: ...\nassistant: ...",
"ended_at": "2026-05-13T13:05:00.000Z"
}
Required Response Format
Your webhook must return a JSON object with a result field. The agent reads this and relays it to the visitor.
{
"result": "Your appointment has been booked for Saturday at 3:00 PM."
}
result value should be a natural language sentence. The agent reads it aloud (in voice) or displays it (in chat) directly to the visitor. Keep it clear and friendly.
Plans & Limits
Voice minutes and chat messages reset on the first of each month.
| Plan | Voice Minutes | Chat Messages |
|---|---|---|
| Free Trial | 30 min | 100 msg |
| Voice Starter | 60 min | — |
| Voice Pro | 300 min | — |
| Chat Starter | — | 500 msg |
| Chat Pro | — | 2,000 msg |
| Bundle Starter | 60 min | 500 msg |
| Bundle Pro | 300 min | 2,000 msg |
Troubleshooting
Common issues and how to resolve them.
Make sure the license is activated and shows "Active" in the License tab. Verify that Show Floating Widget is enabled in the Widget tab, or confirm the [smva_widget] shortcode is present on the page. Clear your browser cache and any WordPress caching plugins.
Allow microphone access in your browser when prompted. Confirm you have voice minutes remaining in the Dashboard tab. Use a supported browser: Chrome, Edge, or Safari. Check that your site is served over HTTPS — mic access requires a secure context.
Verify the Webhook URL is correct and your workflow is active (not in draft/test mode). Make sure Agent Tools are defined and you clicked Save & Sync Tools. Check that the tool description clearly tells the agent when to use it — a vague description may cause the agent to skip the tool.
Add this to your System Prompt: "Once you have all required information, call the tool immediately without asking for confirmation." This prevents the agent from adding an unnecessary confirmation step.
The tool description is what the agent uses to decide when to call the tool. Rewrite it to be very explicit — for example: "Call this tool when the user wants to book, reschedule, or cancel an appointment and has provided their name, email, phone, and preferred date."
Make sure Agent Timezone is correctly set in the My Agent tab. The plugin automatically injects the current date and time into the agent's context. In your automation workflow, always resolve relative dates using the actual server timestamp.
The widget uses scoped CSS with the #smw prefix and a high z-index to avoid conflicts. If you notice visual issues, check your theme's global CSS for rules targeting *, input, button, or fixed-position elements.
Lead capture is automatic — the agent collects name, phone, and email during conversation and saves them as the fields come in. If leads are missing, check the Event Logs in the Debug tab for any capture errors.