Skip to main content
A voice agent handles phone and browser calls using its configured voice, languages, instructions, and tools. Creating requires agents.create; viewing requires agents.read.

​
Create your agent

  1. Open Agents and choose New agent, or press Shift+N.
  2. Select Voice agent when the type picker appears. Organizations without text agents skip this step.
  3. Choose Start from scratch or search templates by name and category.
  4. For a template, review its purpose, prompt, language, category, and voice preview before selecting Create agent.
An agent created from scratch starts with the internal name New Agent, Spanish (Latin America), a default voice, and empty instructions. Templates supply instructions and voice settings; review the in-call name, which may be N/A. Both flows automatically publish version 1. Configure and publish usable instructions before assigning real traffic. Initial maximum duration is 30 minutes, reduced to your plan’s cap where necessary: Free 3, Starter 7, Pro 30, Growth 60, Enterprise 60 minutes.

​
Use the editor

Most changes autosave to a draft. Calls keep using the published version until you select Publish. Some settings apply immediately, including the internal name, knowledge connections, calendars, board, tags, and evaluation assignments. Review the version guide before changing an active agent.

​
Manage the list

Search matches the internal name. Sort by creation or update date and choose cards or table view. The list shows up to 50 agents per page. Cards provide Test and, with edit permission, Edit. Voice agents do not have a duplicate action; create another agent and copy the prompt and settings you need. Delete an agent from Advanced → Danger zone with agents.delete. Confirmation permanently removes its draft and versions. Agent counts are limited by your plan; deleting an unused agent releases a slot.

​
Frequently asked questions

The organization may not have text agents enabled. The list then shows voice agents only.
It has a published version, but a blank agent has no instructions. Configure, publish, and test before assigning traffic.
Yes. The internal name saves immediately. The in-call name belongs to the draft.
Check the active organization and the agents.update permission.

​
See also