Skip to main content
DialNexa dynamic variables are call-time values used to personalize or control agent behavior. They appear as placeholders such as {{first_name}} and can be supplied by batch CSV rows, workflow leads, API calls, test calls, or defaults saved on the agent version.
Dynamic values should be true, current, and safe to speak. The agent may say them out loud.

Dynamic Variable Sources

Call-time data can arrive from several places.
SourceExample
Prompt placeholder{{first_name}} in the instruction.
Welcome messageA personalized first sentence.
Batch CSVColumns for name, due date, city, or amount.
Workflow lead variablesLead-specific values used in nodes and templates.
API requestMetadata or variables supplied by an external launcher.
Default variablesFallback values when a source is missing.

Design Variables Cleanly

1

Use stable names

Prefer first_name over name1 or customerNameMaybe.
2

Document required values

Know which variables every launch path must provide.
3

Add safe defaults

Protect calls from incomplete data.
4

Test missing data

Place calls with missing values and listen to the result.

Dynamic Variable Problems

The value was not supplied and no safe default existed.
Header does not match the expected variable key.
Lead variable key was absent or misspelled.
Destination variable was empty or incorrectly formatted.

Agent Dynamic Variables

Use variables in agents.

Default Variables

Set fallbacks.

Workflow Variables

Use variables in automation.