Skip to main content
This guide walks you through creating, configuring, and calling your first voice agent on Voiceflow — no coding required.
1

Create a new project

From the Dashboard, go to Projects → New project. Name your project, set the type to Phone call, and select Start from scratch.This opens the global agent view, where you’ll configure your agent’s high-level behavior.
2

Set up your agent's persona

In the Global agent description, click generate and describe your agent’s actions, goals, and personality. You can also customize the agent’s tone, speed, and how long it waits for a user to reply. Voiceflow will automatically create a detailed prompt in seconds.For example:
You are Alex, a calm and friendly voice support agent for AcmeCorp.
Help customers with orders, returns, billing, and product questions.
Speak naturally in short, conversational sentences — avoid long
lists or complex phrasing. Stay warm, patient, and reassuring.
If you can't resolve an issue, offer to create a support ticket.
3

Add a knowledge base (optional)

To give your agent real information to reference, click the Knowledge Base icon in the left sidebar. You can add context by:
  • Uploading documents — PDFs, text files, or CSVs (e.g., your FAQ, product catalog, or return policy).
  • Pasting a URL — Your agent will index the content directly from the page.
  • Adding text manually — Paste in key information directly.
Your agent will use this knowledge to answer questions accurately.
4

Publish and call your agent

Back in the Agent tab, click Publish in the top-right corner. To receive a call from your agent, click Call in the top-right, enter your phone number, and start speaking with your agent!
That’s it! Your agent is now deployed and available to use.

​
Tips for refining your phone agent

  • Start simple. Get a basic agent working first, then layer on complexity. You can add deterministic Workflows and agentic Playbooks to get the most out of your agent.
  • Use your knowledge base. The more relevant content you upload, the more accurate your agent’s responses will be.
  • Iterate on your prompt. Small tweaks to the system prompt can make a big difference in response quality.
  • Set up a phone number. Configure a dedicated number so your agent can be reached by simply dialing in.

​
What’s next?

You’ve built your first voice agent on Voiceflow. Now learn how to build production-grade agents with our documentation.

Playbooks

Complete specialized tasks using AI.

Workflows

Add logic and determinism to your agent.