What are Dynamic Variables?
Dynamic variables help you personalize AI Voice calls using real-time customer data.
For example, instead of saying “Hello!” the agent can say: “Hello {{first_name}}!”
These values are automatically taken from your uploaded campaign list and injected into the conversation during calls.
Where Can I Use Dynamic Variables?
You can use variables in:
| Area | Usage |
|---|---|
| AI Conversational Flow (Message Nodes) | Personalize any dialogue the AI voice speaks |
| Auto Dialer Campaigns | Map variable names with column headers of your uploaded data |
How to Create and Manage Variables?
Go to Global Settings. >> Navigate to Call & SMS Settings >> Open In Call Settings >> Select Dynamic Variables
Rules for Creating the Dynamic Variables:
| Rule | Description | Error |
|---|---|---|
| Must be lowercase | No capital letters allowed | “Variable name must be in lowercase.” |
| Use underscore for two words | e.g., customer_name | “Use underscore (_) to separate words.” |
| No spaces | Avoid names like customer name | “Use underscore (_) to separate words.” |
| No special characters | e.g., @,#,$ not allowed | “Variable name cannot contain any special characters.” |
Default Variables: You will already see - first_name, last_name, email_id, phone_number. You can edit or delete them.
How to Use Variables in Conversations?
Inside the AI Voice workflow text box, insert variables using double curly brackets:
Example:
“Hi {{first_name}}, welcome to CallHippo!”
🔎 Tip: Use {{}} to reference any dynamic variable.
Mapping Variables During Campaign Setup
When you assign an AI Voice Agent to an Auto Dialer campaign:
- The system will ask you to Map Variables.
- Each variable used in the selected AI Voice Flow will appear.
- You’ll match each variable with a column from your uploaded CSV/Excel.
📌 Note: Mapping all variables is not mandatory. You can skip if not needed.
Example
If your flow uses: {{name}}, {{email}}, {{pan}}, you will map all three to your CSV headers like:
| Variable | Map To (Column Header) |
|---|---|
| name | Lead Name |
| Email Address | |
| pan | PAN Number |
What If Data Is Missing?
If a value is missing for a customer, the AI will auto-adjust the sentence.
📌 Example:
Message → “Hey {{first_name}}, how are you?”
If no name is available, the AI will say:
👉 “Hey there, how are you?”
Deleting a Dynamic Variable
You cannot delete a variable if it’s being used in:
- AI Workflows
Auto Dialer Campaign Mapping
🛑 If attempted, you will see an error:
“Please change/delete this variable from associated AI Voice Workflows before deleting.”
Once removed from the workflow, the AI will stop expecting this data automatically.
Important Notes
✔ Applicable only for AI Auto Dialer / Batch Outbound Calling
✔ No impact on call logs
✔ Variables must be defined first in Global Settings before use