Prompt Variables
Put the caller's name, the date and other call details into greetings and instructions.
Showing instructions for Xebit VoiceCloud.Showing instructions for Xebit VoiceKit, on your own infrastructure. Switch with the selector at the top. Updated 22 October 2026.
Variables let one greeting or set of instructions fit every call. Write {{user_name}} in the greeting and, on a real call, the agent says the person's actual name. Variables work in the agent's greeting and its instructions.
Available variables
| Variable | Becomes | Example |
|---|---|---|
{{user_name}} | The caller's or contact's name | Priya |
{{user_number}} | Their phone number with the country code | +919876543210 |
{{user_email}} | Their email address | priya@example.com |
{{user_phone_country_code}} | Only the country code | +91 |
{{user_phone_without_country_code}} | Only the local number | 9876543210 |
{{user_phone_with_country_code}} | The full number; always the same as {{user_number}} | +919876543210 |
{{agent_name}} | The agent's configured name | Reminder assistant |
{{agent_number}} | The number on your SIP trunk the agent calls from | +918012345678 |
{{agent_timezone}} | The agent's time zone | Asia/Kolkata |
{{agent_current_day}} | Today's day of the week in the agent's time zone | Monday |
{{agent_current_date}} | Today's date in the agent's time zone | January 5, 2026 |
{{agent_current_time}} | The current time in the agent's time zone | 3:45 PM |
The two split phone variables are useful when the agent needs to talk about the country code and the local number separately rather than reading out one long number.
How to insert one
In the agent's settings, place the cursor in the greeting or instructions and type the variable in double curly braces, or pick it from the list of variables the editor offers.
Example
Hello {{user_name}}, thanks for calling. I have your number as {{user_number}}. Is that still the best way to reach you?On a real call this becomes: "Hello Priya, thanks for calling. I have your number as +91 98765 43210. Is that still the best way to reach you?"
When a value is missing
Not every call has every detail. Write so the sentence still works if a value is blank.
| Variable | If missing |
|---|---|
{{user_name}} | Becomes "there", so "Hello there" still reads naturally |
{{user_number}}, {{user_phone_with_country_code}} | Always present on a phone call |
{{user_phone_country_code}}, {{user_phone_without_country_code}} | Blank if the number cannot be split cleanly |
{{user_email}} | Blank |
{{agent_name}} | Becomes "Assistant" |
{{agent_number}} | Blank if the agent has no outbound number |
{{agent_timezone}} | Falls back to a default time zone; set the agent's time zone in its hours settings to be sure |
{{agent_current_day}}, {{agent_current_date}}, {{agent_current_time}} | Always present |
For values that can be blank, use conditional wording. Instead of "Your email on file is {{user_email}}", write "If you like, I can confirm the email we have on file for you."
Where variables are filled in
Variables are filled in on real calls however they start: inbound calls, campaigns, one off calls from the dashboard or admin console, and calls created through the API (Creating Calls). The caller details depend on what is known for that call: a campaign list without an email column means {{user_email}} is blank. The agent variables always come from the agent's own settings and clock.
Editing the whole prompt
These variables are for the greeting and instructions. The agent's complete instruction set, with tokens for whole blocks such as transfers and appointments, is the system prompt. See System Prompt.
Calls created through the API use https://api.voice.xebit.ai/v1; the caller details you send there fill the caller variables.
Calls created through the API use https://<your-xebit-voicekit-host>/v1; the caller details you send there fill the caller variables.
Next step
Return to Agent Prompting for general guidance on instructions.