For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Atoms PlatformProduct OverviewDeveloper GuideAPI ReferenceMCPIntegrationsDeveloper ToolsChangelog
Atoms PlatformProduct OverviewDeveloper GuideAPI ReferenceMCPIntegrationsDeveloper ToolsChangelog
  • Get Started
    • Quick start
    • Platform overview
  • Single Prompt Agents
    • Overview
  • Conversational Flow Agents
    • Overview
      • Workflow Builder
      • Node Types
      • Conditions
      • Variables
  • Features
    • Concurrency
    • Knowledge Base
    • Webhooks
    • Widget
    • Integrations
    • Post-Call Metrics
    • Versioning
    • Variables
    • API Calls
  • Deployment
    • Phone Numbers
    • Audiences
    • Campaigns
  • Analytics & Logs
    • Overview
    • Testing
    • Conversation Logs
    • Locking
  • Integrate
    • Embed a voice agent
    • WebSocket SDK
  • Cookbooks
    • Using Cookbooks
  • Reference
    • Quick Reference
    • Glossary
  • Troubleshooting
    • Error reference
    • FAQ
    • Getting Help
LogoLogo
Voice AgentsModels
Voice AgentsModels
On this page
  • Variable Types
  • Syntax
  • Default Values
  • System Variables
  • Creating Variables
  • Extracting from APIs
Conversational Flow AgentsWorkflow Tab

Variables

Deprecated
||View as Markdown|
Was this page helpful?
Previous

Conditions & Branching

Next

General Settings

Built with

Variables let you personalize conversations with dynamic data — caller information, API responses, or values you define.

Location: Workflow tab → Variables button (top right)

Variables panel

Variables panel

Variable Types

TypeSourceExample
User DefinedVariables you create{{company_name}}, {{promo_code}}
SystemPlatform-provided (read-only){{caller_phone}}, {{call_duration}}
APIExtracted from API responses{{customer_name}}, {{account_tier}}

Syntax

Use double curly braces anywhere in prompts or conditions:

Hello {{customer_name}}! Thanks for calling {{company_name}}.

Default Values

Handle missing variables with the pipe syntax:

Hello {{customer_name|there}}!

If customer_name is empty → “Hello there!”


System Variables

VariableDescription
{{caller_phone}}Caller’s phone number
{{call_time}}When call started
{{call_duration}}Elapsed seconds
{{call_direction}}”inbound” or “outbound”
{{agent_id}}This agent’s ID
{{call_id}}Unique call identifier

Creating Variables

  1. Click Variables in the workflow tab
  2. Go to User Defined tab
  3. Click + Add Variable
  4. Enter name and default value

Extracting from APIs

In API nodes, use Extract Response Data to create variables from responses:

JSONPathVariable
$.data.namecustomer_name
$.data.tieraccount_tier