Skip to main content

​
Overview

Every voice assistant in Voxworks starts with a script. To create one, open Call Scripts in the sidebar (under Voice Agent Settings) and click New script — either the button in the toolbar or the dashed New script card at the bottom of the list. Both open the Create New Script dialog. The dialog has two parts. At the top, three option cards: Below the cards is a browser with two tabs, Templates and Existing Scripts, where you pick the template or script to copy. The dialog opens on the Templates tab with no card selected — choosing a template is its own way to start. The main button changes with your choice: Create makes the copy straight away when a template or existing script is selected, and Next opens a short form for Generate with AI or New Script (Back returns you to the cards). Whichever path you choose, you land in the script editor with your new script open and ready to configure — see the Editor Guide. You can also start a script from the Dashboard: the Actions menu includes a New Call Script shortcut, which opens a standalone Create Call Script form rather than the full dialog.

​
Generate with AI

Select Generate with AI (“Describe your script and let AI generate it for you”) and click Next to open the Generate Script form. You give it a script name, the call direction, who the assistant will be talking to, a voice, and a description of the script’s goal — optionally grounding it in your website and uploaded knowledge documents (PDF, DOCX, PPTX, TXT, Markdown, CSV, or JSON). Voxworks then generates a full conversation script from your inputs. Generation runs in the background — you can watch its progress step by step, or close the dialog and the script will appear in the scripts list when ready. The full walkthrough of every field and what the generator produces is on the AI Generation page.

​
From a template

The Templates tab lists the templates published to your account, each as a card with a thumbnail, name, description, call type and voice. Narrow the list with: Select a template and click Create. The new script is named after the template and uses the template’s voice — rename it or switch voice in the editor. It copies the template’s call type, description, call flow, Call Objectives, Guidelines, Knowledge Base, Data Collection, voicemail message, and settings. If nothing matches your filters the tab reads No published templates match these filters. Template availability depends on what has been published to your account; if the list is empty, use Generate with AI or From Existing instead.

​
From Existing

Select From Existing (“Copy one of your existing scripts as a starting point”) — or open the Existing Scripts tab — then pick a script from the list and click Create. The button stays disabled until a script is chosen. The list has the same Search box and All / Inbound / Outbound filter as the Templates tab. Duplicating copies everything about the original:
  • Name — the copy is named after the original with a ” - Copy” suffix
  • Call type, voice, and description
  • The main flow and (if present) the pre-call flow, duplicated as independent copies — editing the copy’s flow never changes the original
  • Call Objectives, Guidelines, Knowledge Base, Post-Call Analysis, voicemail message, and all script settings
One behaviour to be aware of: sub-flows referenced by the original script are shared with the copy rather than duplicated. Editing a shared sub-flow affects every script that uses it — the editor warns you when you open one. See Sub-Flows for how shared flows work.

​
New Script — creating from scratch

Select New Script (“Start from scratch with a blank script”) and click Next to open the Create New Script form: “Enter the basic information below. You can configure the rest after the script is created.” Click Create & Continue to create the script and open it in the editor. A from-scratch script starts deliberately minimal:
  • Max Call Duration (seconds) is set to 600 (10 minutes) — adjustable under the Settings tab’s Call Settings
  • The call flow, Call Objectives, Guidelines, Knowledge Base, and voicemail message are all empty, ready for you to build
Work through the editor tabs — Script, Behaviour & Knowledge (Guidelines, Policies and Knowledge Base), Post-Call Analysis (including Data Collection), and Settings — to build it out. The Editor Guide covers each one.

​
The Scripts page

The Scripts page lists every call script on your team, with a live count badge next to the heading. The toolbar gives you: Clicking any script — in either view — opens it in the editor.

​
Card view

Each card shows the script at a glance:
  • Type icon and label — green for Inbound, brand-coloured for Outbound
  • Name (scripts without a name show “Untitled script”), with an AI Receptionist badge if the script belongs to a receptionist
  • Voice and when the script was last Updated
  • Description, or “No description” if none is set
  • Up to five objective badges, with a “+N” badge when there are more

​
Per-script stats

The right side of each card shows call statistics for the script, covering all of its calls: Stats load a moment after the page opens; a dash (—) means the data hasn’t loaded yet or the script has no calls.

​
List view

List view shows one compact row per script — name, description, and voice. Hover a row to reveal its quick actions:
  • Test — opens the Test Call dialog so you can try the script immediately, without leaving the page. See Test Calls
  • Edit — opens the script in the editor (the same as clicking the row)

​
Next Steps

  • Editor Guide — tour the script editor you land in after creating a script
  • AI Generation — every field of the Generate Script form and what the generator builds
  • Test Calls — try your new script on a real call before going live
  • Script Settings — call type, duration limits, voice, and the rest of the Settings tab