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, or let it book real appointments straight onto your calendar — 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.7.11.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 the 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 — also used for appointment booking |
| 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 |
Voice Reference
Use the TTS Preview button in the My Agent tab to audition any voice before going live. The voice list is pulled live from the StudioMeta AI Engine, so new voices appear automatically — no plugin update required.
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 (check a quote, send a document, update a record), 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. check_order_status) |
| 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 |
Appointments
Let the agent check your availability and book real appointments — no calendar tool or webhook required to get started.
Working Hours
Turn on Enable Appointments and set the hours you’re open for each day of the week. Use Copy Monday to all to fill the rest of the week in one click. Add how long an appointment lasts, how much buffer time you need between appointments, your minimum notice period, and how far ahead visitors may book. Times are shown and booked in your Agent Timezone, set in the My Agent tab.
| Field | Description |
|---|---|
| Working Hours | Open/close time per day — leave a day blank to stay closed |
| Slot Length | How long a single appointment lasts, in minutes |
| Buffer | Minimum gap kept between two consecutive appointments |
| Minimum Notice | How soon before a slot a visitor may still book it |
| Booking Horizon | How many days ahead visitors are allowed to book |
| 7-Day Preview | Shows exactly what the agent will offer visitors over the next week, before anyone hears it |
Google Calendar Sync (optional)
Click Connect Calendar to link your Google Calendar — there is no API key, no developer console, and nothing to paste. Once connected:
- Busy times on your calendar are automatically kept off what visitors are offered
- Every appointment the agent books also appears on your calendar
- Disconnect at any time from the Appointments tab, or by revoking access from your Google Account
Bookings
Every appointment the agent books appears in the Bookings list on this tab, alongside the visitor’s name, email, and requested time. Visitors receive a confirmation email with a calendar file (.ics) and a cancellation link, plus a reminder before the appointment.
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 Quality
Calls run in real time with no noticeable delay — StudioMeta’s voice engine handles the audio automatically, so there’s nothing to configure or install.
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 tool or webhook — it will not act 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 custom 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
},
"call_id": "call_abc123",
"license_key": "SM-XXXX-XXXX-XXXX",
"business_name": "Your Business Name",
"site_url": "https://yourwebsite.com",
"timestamp": "2026-07-29T13:00:00.000Z"
}tool_args, not from the top level of the request body.
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": "Here is the information you asked for."
}result value should be a natural language sentence — the agent reads it aloud or displays it directly to the visitor.
check_availability, book_appointment, cancel_appointment) are handled internally and never call your webhook — nothing to configure on your end beyond the Appointments tab.
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 | 100 min | 1,000 msg |
| Voice Pro | 300 min | 2,500 msg |
| Chat Starter | — | 2,000 msg |
| Chat Pro | — | 5,000 msg |
| Bundle Starter | 100 min | 2,000 msg |
| Bundle Pro | 300 min | 5,000 msg |
| Premium | 300 min | 5,000 msg |
| Enterprise | 300 min | 10,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.
Confirm Enable Appointments is turned on and at least one day has working hours set. Check the 7-day preview in the Appointments tab to see exactly what the agent has to offer — an empty preview means your working hours, minimum notice, or booking horizon are ruling out every upcoming slot.
This happens if access was revoked from your Google Account permissions page, or a refresh token expired. Click Connect Calendar again to reauthorize. Booking keeps working from your working hours alone the entire time — a disconnected calendar never blocks new appointments.
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.
Make sure Agent Timezone is correctly set in the My Agent tab — it’s also what appointment times are booked and displayed in. The plugin automatically injects the current date and time into the agent’s context.
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.