Documentation Index
Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
Use this file to discover all available pages before exploring further.
System variables are built-in and always available in flow agents and single-prompt agents. They provide call context, time, and user/agent details.
Time Variables
| Variable | Type | Description | Example Value |
|---|
current_time | string | Current time in HH:MM format | "14:30" |
current_date | string | Current date in locale format | "1/15/2026" |
current_datetime | string | Current date and time | "1/15/2026, 2:30:00 PM" |
current_timestamp | string | Unix timestamp in milliseconds | "1737820200000" |
current_day | string | Day of the month | "15" |
current_month | string | Month number (1-12) | "1" |
current_year | string | Four-digit year | "2026" |
current_weekday | string | Full weekday name | "Wednesday" |
Call Variables
| Variable | Type | Description | Example Value |
|---|
call_id | string | Unique identifier for this call | "call_a1b2c3" |
call_type | string | Type of call | "voice" |
direction | string | Call direction | "inbound" or "outbound" |
call_start_time | string | ISO timestamp when call began | "2026-01-15T14:30:00Z" |
User Variables
| Variable | Type | Description | Example Value |
|---|
user_number | string | User’s phone number | "+1 (555) 123-4567" |
user_number_area_code | string | Area code from user’s number | "555" |
Agent Variables
| Variable | Type | Description | Example Value |
|---|
agent_number | string | Agent’s phone number | "+1 (555) 000-0000" |
agent_name | string | Human-readable agent name | "Customer Support" |
agent_id | string | Unique agent identifier | "agent_001" |
Usage
Reference system variables with double curly braces:
"Good {{current_weekday}}! Your call started at {{call_start_time}}."
"You're speaking with {{agent_name}}. Caller: {{user_number}}."
