Docs
Your First Voice Agent

Your First Voice Agent

Create, configure, and test your first AI voice agent in the BusyBots dashboard.

Voice agents in BusyBots handle phone calls and web voice conversations on your behalf, powered by Retell AI. This guide walks through creating your first one.

Prerequisites

  • A BusyBots organization (created during onboarding)
  • Access to Voice Agents in your dashboard sidebar

Steps

1. Start the agent builder

Go to Voice Agents → Create in your dashboard. This opens the agent builder.

2. Choose a conversation mode

Pick how your agent should structure its conversations:

ModeBest for
Single PromptStraightforward agents driven by one system prompt — fastest to set up
Multi-StateAgents that move through distinct phases (e.g., greeting → qualify → book)
Conversation FlowComplex call logic built visually with a node-based flow builder

If you're not sure, start with Single Prompt — you can rebuild in another mode later.

3. Write the system prompt

Describe who the agent is, what it should accomplish, and any constraints (tone, topics to avoid, when to transfer to a human). Be specific — the system prompt is the biggest lever for call quality.

4. Choose a voice and language

Pick a voice from the voice library and set the agent's primary language. BusyBots supports 20+ voice languages, including full support for English, French, and Hebrew in the dashboard itself.

5. Connect a phone number (optional)

If the agent should take phone calls, assign it a phone number under Voice Agents → Phone Numbers. See Phone Numbers for details. Web voice calls don't require a phone number.

6. Save and publish

Save the agent. It's created in draft status — review the configuration, then publish it to make it live.

Verification

Use the built-in test call feature in the agent detail view to place a test call without leaving the dashboard. You should hear your agent greet you and respond according to your system prompt.

Every call — test or real — creates a full record with transcript, duration, and (if available) sentiment under Voice Agents → Call History. See Call Analytics.

Troubleshooting

Agent doesn't answer calls. Confirm a phone number is linked to the agent under Voice Agents → Phone Numbers, and that the agent is published (not still in draft).

Agent sounds off-topic or ignores instructions. Tighten the system prompt with explicit dos and don'ts. For complex branching logic, consider switching to Multi-State or Conversation Flow mode.

Call quality or latency issues. Try a different underlying LLM for the agent — model choice affects both response speed and conversational quality.

Next steps