Workflows quickstart
Build a simple agent that greets users and gathers basic information using Vapi workflows.
We no longer recommend Workflows for new builds. Use Assistants for most cases or Squads for multi-assistant setups. See Assistants and Squads. Existing workflow content remains for reference.
Build a simple voice agent using Vapi’s visual workflow builder that greets users, collects their information, and demonstrates core workflow concepts like variable extraction, conditional routing, and global nodes.
Agent Capabilities:
What You’ll Build:
Developing with the Vapi CLI? You can manage workflows and test webhook integrations from your terminal:
We will create a simple information-gathering workflow that demonstrates the core features of Vapi’s workflow builder. This workflow will showcase conversation flow, variable extraction, and escalation patterns that form the foundation of more complex workflows.
Workflows vs Assistants: Workflows are visual conversation flows with branching logic and variable extraction. Assistants are single AI agents with tools and continuous conversation. This guide covers workflows specifically.
You can change the node type by selecting a different type from the dropdown at the top of the node configuration panel. For example, you can change the start node type to API Request to trigger an HTTP request as soon as the call is connected.
Prompt:
Extract Variables (expand this section):
first_namestringthe user's first namecitystringthe user's cityDevelopers can specify a phone number destination and a transfer plan, which lets them specify a message or a summary of the call to the person or agent picking up in the destination number before actually connecting the call.
Click Call in the top right to test your workflow:
Your final workflow should have: