Built-in Variables

variables are automatically available in every call. They are populated at the start of the call and can be used anywhere in your flow for routing, logic, prompts, or conditions.

Built-in variables in the system exist in three types: always-available variables (present in all calls), VoIP-specific variables (only in VoIP calls), and voice-specific variables (only in voice calls).

Always Available

These variables are available in all calls.

time

• Type: String

• Description: Current time in ISO 8601 format.

• Use case: Time-based routing or logging.

---

weekday

• Type: String

• Description: Day of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday).

• Use case: Business hours logic or weekday/weekend branching.

---

isVoiceCall

• Type: String (true or false)

• Description: Indicates whether the current call is a voice call.

• Use case: Conditional logic for voice-specific flows.

---

callId

• Type: String

• Description: Unique identifier for the call.

• Use case: Logging, tracking, or referencing the call in external systems.

---

callType

• Type: String

• Description: Type of the call (e.g., web, VoIP, or other configured call types).

• Use case: Channel-based routing.

---

Available in VoIP Calls Only

These variables are only present for VoIP-based calls.

phoneNumber

• Type: String

• Description: Caller’s phone number in E.164 format.

• Use case: Caller identification or CRM lookups.

---

agentPhoneNumber

• Type: String

• Description: Agent’s phone number in E.164 format.

• Use case: Multi-number routing or tracking.

---

direction

• Type: String (inbound or outbound)

• Description: Indicates whether the call was received or initiated.

• Use case: Separate flows for inbound vs outbound calls.

---

Available in Voice Calls

detectedGender

• Type: String

• Possible values: male, female, unknown, child

• Description: Gender detected from the caller’s voice. This remains undefined until enough audio has been collected.

• Use case: Personalization or analytics.

Usages

Built-in variables can be used in node prompt, edge conditions,...etc.

1. Node Prompt:

1. Edge Conditions