# Wirevox Documentation > Official documentation for building and operating Wirevox AI voice and chat agents. ## Getting started - [Create your first voice agent](https://docs.wirevoxai.com/docs/getting-started/create-your-first-voice-agent): Verified workflow for creating, configuring, browser-testing, publishing, assigning a number to, and starting an inbound voice agent. - [Understand the agent editor](https://docs.wirevoxai.com/docs/getting-started/understanding-agent-editor): Detailed reference for the inbound voice-agent prompt editor, configuration, functions, testing, drafts, publishing, and version actions. ## Workspaces, members, and permissions - [Workspaces, members, and permissions](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions): Topic overview for boundaries, membership, roles, invitations, agency hierarchy, lifecycle, and access troubleshooting. - [Understand workspace types and isolation](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/types-and-isolation): Standard, agency, and subaccount workspaces; resource isolation; membership; billing; and URL scope. - [Create, configure, and switch workspaces](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/create-configure-and-switch): Independent creation, business preferences, active-workspace priority, browser storage, and agency switcher behavior. - [Understand roles and permissions](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/roles-and-permissions): Enforced Owner, Admin, Member, and Viewer permissions for standard, agency, and subaccount contexts. - [Invite and manage workspace members](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/invite-and-manage-members): Paid-plan team access, secure seven-day invitations, acceptance, resend, revocation, role changes, removal, and sole-owner protection. - [Manage agency workspaces and subaccounts](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/agencies-and-subaccounts): Parent-child hierarchy, owner invitations, support dashboard access, branding, status, packages, and credit allocation. - [Leave or delete a workspace](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/leave-and-delete): Membership removal, ownership guards, destructive deletion, cascades, agency child restrictions, and pre-deletion checks. - [Test and troubleshoot workspace access](https://docs.wirevoxai.com/docs/workspaces-members-and-permissions/test-and-troubleshoot): Acceptance testing and diagnosis for scope, roles, forbidden actions, invitations, ownership, support access, and deletion. ## Agent lifecycle - [Agent lifecycle](https://docs.wirevoxai.com/docs/agent-lifecycle): Topic overview for creation, status, drafts, autosave, publishing, versions, testing, runtime selection, duplication, export, and deletion. - [Create an agent](https://docs.wirevoxai.com/docs/agent-lifecycle/create-an-agent): Voice and Chat channels, directions, templates, Vox creation, initial state, workspace scope, defaults, and plan limits. - [Understand agent status and delivery](https://docs.wirevoxai.com/docs/agent-lifecycle/status-and-delivery): Draft, Paused, Active, publication, phone assignment, Website Chat deployment, and runtime eligibility. - [Edit and autosave agent drafts](https://docs.wirevoxai.com/docs/agent-lifecycle/drafts-and-autosave): Draft initialization, continuous saving, forced flushes, versioned fields, operational metadata, and unpublished changes. - [Publish and manage agent versions](https://docs.wirevoxai.com/docs/agent-lifecycle/publish-and-versions): Validation, atomic publication, function/tool snapshots, history, restoration, and discarding changes. - [Test draft and published behavior](https://docs.wirevoxai.com/docs/agent-lifecycle/testing-and-runtime-versions): Draft tests, published calls, version-pinned website sessions, shared tests, and post-publish verification. - [Duplicate, export, and delete agents](https://docs.wirevoxai.com/docs/agent-lifecycle/duplicate-export-and-delete): Current-draft duplication, reset delivery, JSON boundaries, retained shared resources, and destructive deletion. - [Test and troubleshoot the agent lifecycle](https://docs.wirevoxai.com/docs/agent-lifecycle/test-and-troubleshoot): Acceptance tests and diagnosis for limits, saving, publishing, activation, versions, functions, copies, and deletion. ## Voice agents - [Voice agents](https://docs.wirevoxai.com/docs/voice-agents): End-to-end topic overview for inbound voice-agent design, configuration, context, actions, testing, delivery, and operation. - [Understand inbound voice agents](https://docs.wirevoxai.com/docs/voice-agents/inbound-voice-agents): Live-call requirements, routing and admission sequence, published runtime, call opening, context, and the current outbound boundary. - [Configure a voice agent](https://docs.wirevoxai.com/docs/voice-agents/configure-a-voice-agent): Call design, prompt editor, Modular and Realtime architectures, editor sections, autosave, and cost review. - [Add knowledge, variables, and functions](https://docs.wirevoxai.com/docs/voice-agents/knowledge-variables-and-functions): Context-layer selection, variable safety, retrieval grounding, function attachment, prompt rules, and version boundaries. - [Test and optimize voice behavior](https://docs.wirevoxai.com/docs/voice-agents/test-and-optimize): Draft browser testing, scenario matrix, controlled tuning, evidence inspection, and live-path validation. - [Publish, connect, and operate](https://docs.wirevoxai.com/docs/voice-agents/publish-connect-and-operate): Version publication, phone assignment, activation, live verification, monitoring, billing, and change management. - [Troubleshoot voice agents](https://docs.wirevoxai.com/docs/voice-agents/troubleshooting): Layered diagnosis for creation, saving, publishing, routing, speech, grounding, actions, call endings, and cost. ## Testing and publishing - [Testing and publishing](https://docs.wirevoxai.com/docs/testing-and-publishing): Controlled release path from saved draft through private and shared tests, atomic publication, live verification, and restoration. - [Plan an agent test](https://docs.wirevoxai.com/docs/testing-and-publishing/plan-an-agent-test): Repeatable scenarios, evidence, layered diagnosis, pass criteria, and production release gates. - [Run a private browser test](https://docs.wirevoxai.com/docs/testing-and-publishing/private-browser-tests): Saved-draft behavior, microphone and billing requirements, stored records, live tools, and limits of browser evidence. - [Create and control shared test links](https://docs.wirevoxai.com/docs/testing-and-publishing/shared-test-links): Frozen snapshots, attempts, expiration, duration, tool permissions, billing, bearer-token safety, and revocation. - [Validate and publish a draft](https://docs.wirevoxai.com/docs/testing-and-publishing/validate-and-publish): Pre-publish review, diagnostics, optional version metadata, atomic publication, and post-publish requirements. - [Manage versions and restore safely](https://docs.wirevoxai.com/docs/testing-and-publishing/versions-and-restoration): Version history, draft discard, restore-then-republish rollback, and emergency expectations. - [Verify and monitor production](https://docs.wirevoxai.com/docs/testing-and-publishing/production-verification): New-call smoke testing, version pinning, post-release metrics, and rollback decisions. - [Troubleshoot testing and publishing](https://docs.wirevoxai.com/docs/testing-and-publishing/troubleshooting): Diagnosis for stale snapshots, unavailable links, missing tools, billing gates, blocked publishing, old live behavior, and incomplete restoration. ## Security, privacy, and data retention - [Security, privacy, and data retention](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention): Verified access, data-flow, privacy, retention, deletion, limitation, and secure-operation guidance without unsupported compliance claims. - [Understand authentication and workspace isolation](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/authentication-and-access): Supabase authentication, tenant authorization, roles, agency access, invitations, public tokens, and access reviews. - [Understand data flows and stored records](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/data-flows-and-storage): Stored data categories and provider flows for Modular, Realtime, knowledge, Vox, and external actions. - [Configure caller disclosure and data minimization](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/caller-privacy-and-consent): Customer-configured voice disclosure, collection minimization, prompt rules, Beta Chat privacy notices, and testing. - [Protect knowledge, files, and web content](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/knowledge-files-and-web-content): Extraction, embeddings, public URL safeguards, prompt injection, temporary Vox files, images, and custom voices. - [Protect integrations, functions, and secrets](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/integrations-functions-and-secrets): Vault credential storage, least privilege, action defenses, Vox approvals, disconnection, and rotation. - [Understand retention and deletion](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/retention-and-deletion): Current retention boundaries, resource deletion, cascade effects, external-provider cleanup, and request handling. - [Review current security boundaries](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/current-boundaries): Verified controls, known implementation gaps, unsupported compliance claims, policy drift, and regulated-data restrictions. - [Operate securely and respond to incidents](https://docs.wirevoxai.com/docs/security-privacy-and-data-retention/secure-operations): Deployment review and containment steps for identities, secrets, agents, public links, and misdirected data. ## System prompts - [System prompts](https://docs.wirevoxai.com/docs/system-prompts): Topic overview and recommended authoring sequence. - [Write an effective system prompt](https://docs.wirevoxai.com/docs/system-prompts/writing-effective-system-prompts): Wirevox prompt structure, runtime compilation, model-specific guidance for OpenAI, Grok, and Gemini, variables, functions, grounding, testing, and a production template. ## Models and architecture - [Models and architecture](https://docs.wirevoxai.com/docs/models-and-architecture): Topic overview for selecting and changing the voice-agent execution architecture. - [Compare Modular and Realtime](https://docs.wirevoxai.com/docs/models-and-architecture/modular-vs-realtime): Execution paths, tradeoffs, shared controls, switching behavior, and migration checklist. - [Choose a model](https://docs.wirevoxai.com/docs/models-and-architecture/choose-a-model): Current selectable model inventory and an evaluation-based selection process. - [Review configuration compatibility](https://docs.wirevoxai.com/docs/models-and-architecture/configuration-compatibility): Architecture and provider support matrix for speech, language, interruption, voice-delivery, and lifecycle controls. ## Voices, languages, and speech - [Voices, languages, and speech](https://docs.wirevoxai.com/docs/voices-languages-and-speech): Topic overview for voice selection, language routing, speech recognition, delivery controls, and testing. - [Choose a voice](https://docs.wirevoxai.com/docs/voices-languages-and-speech/choose-a-voice): Modular and Realtime compatibility, previews, speaking speed, custom voice cloning, and selection checks. - [Configure languages and bilingual behavior](https://docs.wirevoxai.com/docs/voices-languages-and-speech/languages-and-bilingual): Primary language behavior, Modular bilingual routing, Realtime limitations, and language test cases. - [Configure speech recognition](https://docs.wirevoxai.com/docs/voices-languages-and-speech/speech-recognition): Current Modular transcription options, patience, recognition key terms, and controlled evaluation. - [Configure voice delivery](https://docs.wirevoxai.com/docs/voices-languages-and-speech/voice-delivery): Personality, expressiveness, adaptive delivery, reactions, pitch, pronunciation, and provider-specific controls. - [Test and troubleshoot speech](https://docs.wirevoxai.com/docs/voices-languages-and-speech/test-and-troubleshoot): End-to-end test cases and diagnosis for recognition, timing, language routing, delivery, and custom voices. ## Conversation behavior and call controls - [Conversation behavior and call controls](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls): Topic overview for greetings, turn taking, interruptions, silence, lifecycle limits, transfers, and call endings. - [Configure turn taking and interruptions](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls/turn-taking-and-interruptions): Modular response timing, word thresholds, backchannel filtering, and Realtime provider-native interruption. - [Configure silence and call limits](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls/silence-and-call-limits): Silence prompting, inactivity hang-up, configured duration, and the system safety cap. - [Design greetings and conversation flow](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls/greetings-and-flow): Inbound greeting execution, transferred and outbound boundaries, and recoverable call-flow design. - [Transfer and end calls safely](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls/transfers-and-endings): Phone and agent destinations, warm handoff, closing behavior, and current voicemail limitations. - [Test and troubleshoot call behavior](https://docs.wirevoxai.com/docs/conversation-behavior-and-call-controls/test-and-troubleshoot): Regression tests and diagnosis for timing, interruption, silence, transfer, greeting, and hang-up issues. ## Phone numbers and call routing - [Phone numbers and call routing](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing): Topic overview for number inventory, one-to-one agent assignment, routing, lifecycle, and go-live order. - [Search for and acquire a number](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/search-and-acquire): Live provider inventory, country and number-type search, plan allowances, purchase confirmation, and included-number boundaries. - [Assign a number and activate an agent](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/assign-and-activate): Workspace and publication prerequisites, assignment, status, reassignment, deletion, and draft behavior. - [Understand inbound routing](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/inbound-routing): Active-number lookup, published configuration, eligibility checks, ring delay, credit protection, and caller context. - [Understand outbound caller identity](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/outbound-caller-identity): Assigned-number caller ID, outbound call sequence, SMS origin, transfer dependencies, and current scope. - [Release and reclaim numbers](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/release-and-reclaim): Unassignment, 30-day grace, billing effects, reclamation, permanent release, and subscription changes. - [Test and troubleshoot routing](https://docs.wirevoxai.com/docs/phone-numbers-and-call-routing/test-and-troubleshoot): Real-network testing and diagnosis for search, purchase, assignment, inbound, outbound, transfer, and grace issues. ## Calls, logs, and analytics - [Calls, logs, and analytics](https://docs.wirevoxai.com/docs/calls-logs-and-analytics): Topic overview for voice call records, transcripts, outcomes, contacts, analytics, and credits. - [Review Call Logs](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/call-logs): Workspace filtering, call fields, transcript expansion, ledger events, refresh behavior, and current recording/export limits. - [Understand transcripts, summaries, and outcomes](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/transcripts-summaries-and-outcomes): Captured utterances, tool-confirmed outcomes, fixed OpenAI post-call analysis, failure behavior, and reliability guidance. - [Understand contacts and leads](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/contacts-and-leads): Caller creation and enrichment, fields, filters, statuses, and outcome mapping. - [Read workspace analytics](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/workspace-analytics): Time ranges, KPI formulas, charts, conversion boundaries, and validation. - [Reconcile credits and call costs](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/credits-and-costs): Ledger-backed voice and tool usage, per-agent duration aggregation, runtime rate selection, and reconciliation. - [Compare browser tests and live calls](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/browser-tests-and-live-calls): Draft and published configuration, persistence, billing, tool safety, and post-call differences. - [Operate and troubleshoot logs safely](https://docs.wirevoxai.com/docs/calls-logs-and-analytics/test-privacy-and-troubleshooting): Production validation, common failures, privacy, data lifecycle, and reliability practices. ## Credits, plans, and billing - [Credits, plans, and billing](https://docs.wirevoxai.com/docs/credits-plans-and-billing): Topic overview for plans, balances, metered usage, subscriptions, add-ons, invoices, and payment controls. - [Compare plans and limits](https://docs.wirevoxai.com/docs/credits-plans-and-billing/plans-and-limits): Current plan families, live-price source of truth, agent limits, included numbers, credits, trials, and capacity. - [Understand credit balances and renewals](https://docs.wirevoxai.com/docs/credits-plans-and-billing/credit-balances-and-renewals): Included and purchased balances, deduction order, resets, reservations, carryover, and zero-balance behavior. - [Calculate voice-agent usage](https://docs.wirevoxai.com/docs/credits-plans-and-billing/voice-agent-usage): Modular and Realtime formulas, duration aggregation, configuration snapshots, live calls, and browser tests. - [Understand Website Chat, Vox, and tool usage](https://docs.wirevoxai.com/docs/credits-plans-and-billing/chat-vox-and-tools): Message and token pricing, Vox searches and attachments, reservations, SMS, transfers, and external fees. - [Read Workspace Usage](https://docs.wirevoxai.com/docs/credits-plans-and-billing/workspace-usage): Live balances, date-filtered ledger categories, daily history, carryover, and agent attribution. - [Manage top-ups and subscriptions](https://docs.wirevoxai.com/docs/credits-plans-and-billing/top-ups-and-subscriptions): Stripe Checkout, trials, upgrades, downgrades, cancellation, payment methods, invoices, and dunning. - [Manage add-ons and concurrent calls](https://docs.wirevoxai.com/docs/credits-plans-and-billing/add-ons-and-concurrency): Recurring capacity changes, proration, runtime boundaries, and phone-number add-ons. - [Understand agency and subaccount billing](https://docs.wirevoxai.com/docs/credits-plans-and-billing/agency-and-subaccounts): Agency packages, credit allocation, subaccount attribution, permissions, and current enforcement boundaries. - [Troubleshoot billing and usage](https://docs.wirevoxai.com/docs/credits-plans-and-billing/troubleshooting): Checkout, balance, ledger, usage, plan, capacity, invoice, and payment-lock diagnosis. ## Vox platform assistant - [Vox platform assistant](https://docs.wirevoxai.com/docs/vox-platform-assistant): Topic overview for Vox models, routing, capabilities, approvals, research, files, chats, integrations, usage, and limits. - [Understand models, routing, and context](https://docs.wirevoxai.com/docs/vox-platform-assistant/models-routing-and-context): Grok and OpenAI provider switching, request modes, bounded context, research reuse, and provider-neutral architecture. - [Review capabilities and permissions](https://docs.wirevoxai.com/docs/vox-platform-assistant/capabilities-and-permissions): Live workspace reads, supported changes, tenant permissions, and current status boundaries. - [Approve and run Vox actions](https://docs.wirevoxai.com/docs/vox-platform-assistant/approvals-and-actions): Single-use approval cards, expiry, integrity checks, multiple mutations, and per-turn tool budgets. - [Build agents, prompts, and functions with Vox](https://docs.wirevoxai.com/docs/vox-platform-assistant/agents-prompts-and-functions): Draft creation, full prompt replacements, prompt context, function attachment, and exact markers. - [Research websites and build knowledge](https://docs.wirevoxai.com/docs/vox-platform-assistant/research-and-knowledge): Public search, website scanning, selected-page reading, temporary research context, and durable ingestion. - [Upload files and images to Vox](https://docs.wirevoxai.com/docs/vox-platform-assistant/files-and-images): Supported formats, staging, image analysis, storage, retention, and knowledge ingestion. - [Use Vox chats, history, and cancellation](https://docs.wirevoxai.com/docs/vox-platform-assistant/chats-history-and-cancellation): Lazy thread creation, thread URLs, history limits, send behavior, progress, typing, and stop semantics. - [Connect integrations with Vox](https://docs.wirevoxai.com/docs/vox-platform-assistant/integrations): Live integration catalogs, secure connection flows, combined provider functions, attachment, and prompt rules. - [Understand Vox usage and limits](https://docs.wirevoxai.com/docs/vox-platform-assistant/usage-and-limits): Credit formula, reservations, messages, context, tools, research, attachments, actions, and knowledge boundaries. - [Test and troubleshoot Vox](https://docs.wirevoxai.com/docs/vox-platform-assistant/test-and-troubleshoot): Acceptance tests and diagnosis for facts, searches, actions, prompts, functions, approvals, cancellation, and usage. - [Connect Wirevox to ChatGPT](https://docs.wirevoxai.com/docs/vox-platform-assistant/chatgpt-and-mcp): Authenticated connector setup, workspace permissions, approval-backed changes, privacy, and troubleshooting. ## Variables and context - [Variables and context](https://docs.wirevoxai.com/docs/variables-and-context): Topic overview for configured facts, live context, knowledge, and action results. - [Configure prompt variables](https://docs.wirevoxai.com/docs/variables-and-context/configure-variables): Naming, inserting, updating, publishing, and securing custom prompt variables. - [Understand runtime context](https://docs.wirevoxai.com/docs/variables-and-context/runtime-context): Prompt compilation order for variables, date and time, caller details, knowledge, functions, and channel rules. - [Troubleshoot variable references](https://docs.wirevoxai.com/docs/variables-and-context/troubleshooting): Resolve warnings, missing values, stale live facts, shadowing, Vox validation errors, and oversized variables. ## Functions and integrations - [Functions and integrations](https://docs.wirevoxai.com/docs/functions-and-integrations): Capability model for workspace connections, reusable functions, agent attachments, prompt policy, testing, and publishing. - [Choose a function type and execution stage](https://docs.wirevoxai.com/docs/functions-and-integrations/function-types-and-stages): Reusable categories, current integration actions, and pre-, during-, and post-conversation behavior. - [Create and attach functions](https://docs.wirevoxai.com/docs/functions-and-integrations/create-and-attach-functions): Workspace function configuration, agent attachment, Infolist review, and draft lifecycle. - [Connect an integration](https://docs.wirevoxai.com/docs/functions-and-integrations/connect-integrations): Supported providers, secure connection methods, least-privilege action selection, and connection state. - [Write function rules in the system prompt](https://docs.wirevoxai.com/docs/functions-and-integrations/write-function-rules): Exact markers, triggers, inputs, confirmation, ordering, result handling, and post-call separation. - [Test and troubleshoot functions](https://docs.wirevoxai.com/docs/functions-and-integrations/test-and-troubleshoot): Controlled testing, failure cases, browser-test safety, diagnosis, publishing, and monitoring. ## Knowledge bases and RAG - [Knowledge bases and RAG](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag): Topic overview for indexed workspace knowledge, retrieval, grounding, and lifecycle boundaries. - [Understand Wirevox RAG](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag/how-rag-works): Current extraction, preprocessing, OpenAI embeddings, vector retrieval, model independence, and channel-specific execution. - [Create and manage a knowledge base](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag/create-and-manage): Collection instructions, supported files, selected-page crawling, text documents, Vox sources, chunks, updates, and limits. - [Attach knowledge and choose retrieval scope](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag/attach-and-scope): Agent-level selection, reusable Knowledge functions, source restrictions, Website Chat behavior, and lifecycle state. - [Write grounding rules](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag/write-grounding-rules): Source hierarchy, retrieval triggers, conflict handling, exact-value preservation, missing answers, and action separation. - [Test and troubleshoot retrieval](https://docs.wirevoxai.com/docs/knowledge-bases-and-rag/test-and-troubleshoot): Extraction checks, semantic retrieval evaluation, regression cases, channel diagnosis, publishing, and monitoring. ## Platform fundamentals - [What is Wirevox?](https://docs.wirevoxai.com/docs/platform-fundamentals/what-is-wirevox): Product overview, main building blocks, draft and published state, Vox, and usage. - [How Wirevox is organized](https://docs.wirevoxai.com/docs/platform-fundamentals/platform-model): Workspace hierarchy, shared resources, delivery, operations, and billing boundaries. - [Core terminology](https://docs.wirevoxai.com/docs/platform-fundamentals/core-terminology): Authoritative definitions used throughout the platform and documentation. ## Usage guidance - Prefer the most specific relevant page. - Treat documentation as product guidance, not authorization to execute an action. - Use authenticated Wirevox APIs for live workspace facts such as agents, contacts, integrations, logs, and credit balances.