Variables

Overview

Use dynamic variables in the system prompt or any message in the dashboard with double curly braces (e.g., {{name}}).

To set values, make a phone call request through the API and set assistantOverrides. You cannot set variable values directly in the dashboard.

For example, set the assistant’s first message to “Hello, {{name}}!” and assign name to John by passing assistantOverrides with variableValues:

1
{
2
  "variableValues": {
3
    "name": "John"
4
  }
5
}

Using dynamic variables in a phone call

1
{
2
  "assistantId": "your-assistant-id",
3
  "assistantOverrides": {
4
    "variableValues": {
5
      "name": "John"
6
    }
7
  },
8
  "customer": {
9
    "number": "+1xxxxxxxxxx"
10
  },
11
  "phoneNumberId": "your-phone-id"
12
}

Default Variables

These variables are automatically filled based on the current (UTC) time, so you don’t need to set them manually in variableValues:

Advanced date and time usage

You can use advanced date and time formatting in any prompt or message that supports dynamic variables in the dashboard or API. We use LiquidJS for formatting - see their docs for details.

Format a date or time using the LiquidJS date filter:

1
{{"now" | date: "%A, %B %d, %Y, %I:%M %p", "America/Los_Angeles"}}

Outputs: Monday, January 01, 2024, 03:45 PM

Examples:

• 24-hour time:

  1
  {{"now" | date: "%H:%M", "Europe/London"}}

  → 17:30
• Day of week:

  1
  {{"now" | date: "%A"}}

  → Tuesday
• With customer number:

  1
  Hello, your number is {{customer.number}} and the time is {{"now" | date: "%I:%M %p", "America/New_York"}}

Common formats:

## Using dynamic variables in the dashboard
To use dynamic variables in the dashboard, include them in your prompts or messages using double curly braces. For example:

Hello, {{name}}!

When you start a call, you must provide a value for each variable (like `name`) in the call configuration or via the API/SDK.
<Note>
Always use double curly braces (`{{variableName}}`) to reference dynamic variables in your prompts and messages.
</Note>
</rewritten_file>