v1.3.72 — Plugin Documentation

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.

StudioMeta AI Engine
n8n / Make / Zapier
WordPress Plugin

Overview

Everything your business needs to deploy a live AI agent on your website.

🎙️
Real-time Voice Agent
Visitors speak naturally with your AI agent over WebSocket. No phone lines, no delays — powered by StudioMeta's real-time AI engine.
💬
Intelligent Chat
A fully customizable chat widget embedded via [smva_widget] shortcode on any page or post.
Agentic Actions
Connect to n8n, Make, or Zapier to take real actions — bookings, emails, CRM updates — during any conversation.
🔒
Secure & Domain-Locked
Each license is locked to your domain. Internal tokens are never exposed publicly. Billing via Stripe.

Installation

Get up and running in under 5 minutes.

1
Download the plugin
Download studiometa-voice-ai-1.3.72.zip from your StudioMeta account or the pricing page.
2
Upload to WordPress
Go to Plugins → Add New → Upload Plugin, select the ZIP file, and click Activate.
3
Open plugin settings
Navigate to Settings → StudioMeta Voice AI in your WordPress admin panel.
4
Enter your license key
Go to the License tab, paste your license key, and click Activate License.
5
Embed the widget
Add [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.

FieldDescription
Business NameDisplayed in the widget header — use your real business name
LanguageSets the widget language and text direction. Supports RTL for Persian and Arabic.
Chat GreetingThe first message shown to visitors when they open the chat tab

My Agent

Configure your AI agent's personality, voice, and knowledge.

FieldDescription
VoiceChoose from 30 available voices — preview any before going live. See Voice Reference for the full list.
Speech SpeedSlow / Normal / Fast — affects voice call delivery pace
Voice GreetingThe first sentence the agent speaks when a voice call starts
System PromptInstructions that define your agent's personality, rules, and behavior
Knowledge BaseYour business information: services, pricing, hours, policies, FAQs
Agent TimezoneInjects the correct current date and time into the agent's context
✨ Optimize with AIAuto-rewrites and improves your system prompt and knowledge base with one click
🔍 Import from websiteCrawls your website URL and extracts business information automatically
💾 Save & Sync AgentSaves 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.

💡 Use ✨ Optimize with AI to improve your system prompt after writing a rough draft, or use 🔍 Import from website to pre-fill your knowledge base from existing site content.

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.

VoiceGenderCharacter
▶️ 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
💡 For customer-facing agents, voices like Kore, Aoede, or Alnilam (female — warm and professional) or Charon, Iapetus, or Puck (male — authoritative to friendly) tend to perform well. Always use TTS Preview with your actual greeting text before publishing.

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.

Visitor
🗣️ Makes a request
AI Agent
🤖 Calls your webhook
Your Automation
⚡ Processes action
Response
✅ Result to 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.

ℹ️ Click + Add Tool to open the tool editor. After adding or editing tools, always click 💾 Save & Sync Tools to apply changes.
FieldDescription
Tool NameA unique identifier in lowercase with no spaces (e.g. book_appointment)
DescriptionTells the agent when and why to use this tool — be specific and clear
ParametersThe information to collect from the visitor before calling the webhook
Thinking MessageWhat the agent says while waiting for the webhook response
⚠️ The tool description is critical. The agent decides whether to call a tool based entirely on this text. Write it explicitly — describe the exact situation when the tool should be used.

Widget

Customize the appearance and behavior of the floating widget on your site.

💡 Embed the widget on any page using the shortcode [smva_widget]. To show a floating widget sitewide, enable Show Floating Widget in this tab.
FieldDescription
Button PositionPlace the widget in the bottom-right or bottom-left corner of the screen
Primary ColorHex color code for the widget accent color — should match your brand
Show Floating WidgetToggle the widget on or off across your entire site
Send Conversation SummaryEmail a conversation summary to the license owner after each session ends
Default TabWhich tab opens first when the widget is clicked — Voice or Chat
Silence TimeoutSeconds of silence before automatically ending a voice call (default: 60)
Max Call DurationMaximum voice call length in minutes (default: 10)
Call CooldownMinimum wait time in seconds between voice calls (default: 0)

Dashboard

Monitor your usage and review recent conversations.

MetricDescription
Voice Minutes UsedMinutes consumed this month vs. your plan limit
Chat Messages UsedMessages consumed this month vs. your plan limit
Days RemainingDays left in the current billing period
Recent ConversationsRecent voice and chat sessions with timestamps, duration, and transcripts

Voice Call Flow

What happens from the moment a visitor starts a call.

Visitor clicks Start Call
Browser requests mic access
WebSocket connection opens
Audio streamed to backend
Agent speaks greeting
Agent needs to act
Webhook called with data
Automation processes it
Agent confirms result

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.

ℹ️ Voice calls require microphone permission and a supported browser (Chrome, Edge, or Safari). Calls end automatically on silence timeout, max duration, or when the visitor clicks End Call.

Chat Flow

How the chat widget processes messages and triggers actions.

Visitor sends message
AI processes with your prompt + KB
If action needed → webhook called
Result shown to visitor

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"
}
💡 Always read the visitor's collected data from 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."
}
⚠️ The 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.

PlanVoice MinutesChat Messages
Free Trial30 min100 msg
Voice Starter60 min
Voice Pro300 min
Chat Starter500 msg
Chat Pro2,000 msg
Bundle Starter60 min500 msg
Bundle Pro300 min2,000 msg
ℹ️ All plans include every feature. The only difference is how many minutes and messages you get per month. See studiometa.io/pricing for current pricing.

Troubleshooting

Common issues and how to resolve them.

Widget not appearing on my site

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.

Voice call not connecting

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.

Webhook not being called

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.

Agent asking for confirmation before taking action

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.

Agent not using the tool at all

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."

Agent giving wrong dates

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.

Widget styling conflicts with my theme

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.

Leads not appearing in the Leads tab

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.

StudioMeta Voice AI
Plugin Documentation — v1.3.72