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:


  1. The system will ask you to Map Variables.

  2. Each variable used in the selected AI Voice Flow will appear.

  3. 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 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