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, which offers four ways to start: From Template is selected when the dialog opens. Pick a method, complete its options, and click Create. 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 four-method dialog.

​
Generate with AI

Select Generate with AI (“Describe your script and let AI generate it for you”) and click Create 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 Template

Select From Template (“Start with a pre-built template and customize it”), then:
  1. Choose a template from the Select a template dropdown.
  2. Choose a voice from the voice picker beneath it.
  3. Click Create.
The Create button stays disabled until both a template and a voice are selected. The new script is created as “New Script” — rename it in the editor — and copies the template’s call type, description, call flow, Call Objectives, Guidelines, Knowledge Base, Data Collection, voicemail message, and settings. Template availability depends on what has been published to your account. If the Select a template dropdown 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”), pick a script from the Select an existing script dropdown, and click Create — the button stays disabled until a script is chosen. 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 Create to open the Create New Script form: “Enter basic information to create your script. You’ll be able to configure everything else on the next page.” 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, Guidelines, Policies, Knowledge Base, Data Collection, Post-Call Analysis, 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