Skip to main content

​
System Context

The context of each call automatically includes a set of system variables that provide essential information about the ongoing call. These variables are always available and can be used in your prompts, workflows, and integrations. 
{
  "system": {
    "agentId": "b8d9637f-ba51-4aa2-84a4-80692f7bbd17",
    "callId": "40387944-5065-483f-942c-68bae81e70ec",
    "customerId": "1e1a79ee-c6ec-4b07-89f0-9a414daaa9de",
    "date": "2025-05-13",
    "dayOfWeek": "tuesday",
    "phone": "06 12 34 56 78",
    "phoneE164": "+33612345678",
    "now": "2025-05-13 10:36:37",
    "timeHHMM": "1036",
    "year": "2025"
  }
}
VariableDescription
system.callIdUnique identifier of the ongoing call. Can be used for tracking, logging, or cross-referencing in your systems.
system.agentIdUnique identifier of the voice agent handling the call. Useful for differentiating agents in analytics or for specific configurations.
system.dayOfWeekCurrent day of the week in customer locale. Allows customizing greetings or availability based on the day.
system.phonePhone number of the interlocutor in local format, with spaces. Ideal for display or verbal communication.
system.nowCurrent date and time in ISO format, according to the configured time zone. Provides temporal context for the call.
system.phoneE164Phone number of the interlocutor in E.164 (international) format. Standardized format optimal for database searches or API calls.

​
Pre-Call Action

Before each incoming or outgoing call, you can enrich the context with additional information by configuring a pre-call action on your agent. The return of this action will be injected into the call context.
Use the caller/called phone number (system.phoneE164) from the system context to retrieve customer information from your systems.

​
Outgoing Call

​
API

When creating calls via API, a context can be provided in the request and will be injected during the call.

Initiate Outgoing Calls

View API Reference

​
Campaigns (Excel / CSV)

For mass outgoing call campaigns, you can provide the context via Excel or CSV files.
Column names in your Excel/CSV files must not contain spaces or special characters to be correctly transformed into variables. Use underscores (_) to separate words.

​
Incoming Call

​
SIP

When receiving an incoming call via a SIP connection, Volubile automatically adds to the call context all custom SIP headers starting with X-Volubile-. These headers are then available and can be utilized within the prompt.

​
Automatic Conversion

SIP headers are automatically transformed into context variables according to the following rule:
  1. The prefix X-Volubile- is removed.
  2. The remaining key is converted to lowercase.
  3. Hyphens (-) are replaced by underscores (_).
SIP HeaderConversion in Context
X-Volubile-code: 123456{"code": "123456"}
X-Volubile-client-id: CL001{"client_id": "CL001"}
X-Volubile-offer-type: premium{"offer_type": "premium"}

​
Complete Example

X-Volubile-code: ABC123
X-Volubile-client-id: CL-45678
X-Volubile-client-segment: premium
X-Volubile-campaign-id: CAMP-2025-Q2