Variables

View as MarkdownOpen in Claude

Variables let you insert dynamic values into prompts, conditions, and API calls. Use them to personalize conversations, pass data between systems, and create dynamic flows.


Syntax

{{variable_name}}

Variables are replaced with actual values at runtime.


Variable Types

TypeSourceExample
SystemPlatform-provided{{caller_phone}}, {{call_duration}}
User DefinedYou create{{company_name}}, {{promo_code}}
APIFrom API responses{{customer_name}}, {{account_tier}}

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

Default Values

Handle missing variables with fallbacks:

Hello {{customer_name|there}}!

If customer_name is empty → “Hello there!”


Implementation

Variables work in both agent types with slight differences in how they’re configured.