> ## 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

> Platform-provided variables for time, call, user, and agent

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}}."
```

See [Template Syntax & Naming](./syntax-and-naming) for rules and [Availability & Context](./availability-and-context) for where system variables apply.