Dynamic data refers to special syntax variables that you can insert directly into AI agent configurations during a specific interaction or call. These variables allow you to tailor the agent’s behavior and responses to each user’s unique context—without altering the foundational structure of the conversation.

By integrating dynamic data, your AI agents become more intelligent and personalized, capable of referencing real-time or user-specific details such as the current date, caller ID.

​
💡 Why Use Dynamic Data?

Dynamic data enhances agent communication by:

  • Making greetings feel personalized.
  • Allowing references to real-time or session-specific information.
  • Enabling contextual adaptation based on the caller, time, or scenario.

​
📍 Where You Can Use Dynamic Data

Dynamic data variables can be used in various parts of your AI agent setup, depending on the type of agent you’re using.

​
🧠 For Simple Agents

You can insert dynamic variables into:

  • System Prompt: The guiding context your agent follows.
Today is {{current_date_time_utc}}
You are a helpful agent from {{company_name}}
  • Welcome Message: The initial greeting or user-facing message.
Hello, this is {{agent_name}} from {{company_name}}. How can I assist you today?

​
🤖 For Agentic AI Agents (Multi-step, context-aware agents)

Dynamic data is supported in more nuanced areas:

  • Agent Persona: Helps the agent reflect a unique, consistent personality.
  • Call Background: Provides situational context such as caller details or call purpose.
  • Prior Knowledge: Supplies the agent with pre-call intelligence.
  • Welcome Message: Enables real-time, context-driven greetings.

​
🔧 Default Dynamic Data Variables

Verbex provides a set of built-in dynamic variables that you can use without any additional configuration. These are automatically available for all agent interactions.

Variable NameDescriptionExample
{{current_date_time_utc}}Current date and time in UTC format.2025-05-31T14:23:00Z
{{call_id}}Unique identifier for the current call/session.a1b2c3d4e5
{{from_number}}The phone number or identifier of the caller/user.+15551234567
{{to_number}}The number the user has dialed—typically your agent’s line.+15559876543

​
🛠️ Tips for Using Dynamic Data

  • Always use double curly braces ({{ }}) around variable names.
  • Test agent output with sample data to ensure seamless integration.
  • In inbound calls, system-generated dynamic data (e.g., caller number, time) can be automatically passed into prompts, background, and other agent sections to provide real-time personalization.
  • In outbound calls, it’s easy to combine system dynamic data with custom data (like CRM fields, campaign context, or previous interactions) to enrich the conversation and improve targeting.

​
Exception Cases

If a custom dynamic variable is referenced in a prompt or configuration but no corresponding value is provided during runtime, the system will currently raise an error. To avoid interruption or failure, you must ensure that all referenced custom variables have values assigned when initiating the interaction.

Note: This requirement does not apply to default system dynamic variables (e.g., {{call_id}}, {{from_number}}), which are automatically populated by the platform.

Support for gracefully bypassing missing custom variable values will be introduced in a future update.