Context - Documentation

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"
  }
}

Variable	Description
`system.callId`	Unique identifier of the ongoing call. Can be used for tracking, logging, or cross-referencing in your systems.
`system.agentId`	Unique identifier of the voice agent handling the call. Useful for differentiating agents in analytics or for specific configurations.
`system.dayOfWeek`	Current day of the week in customer locale. Allows customizing greetings or availability based on the day.
`system.phone`	Phone number of the interlocutor in local format, with spaces. Ideal for display or verbal communication.
`system.now`	Current date and time in ISO format, according to the configured time zone. Provides temporal context for the call.
`system.phoneE164`	Phone 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 the User-to-User header and all other 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:

The prefix X-Volubile- is removed.
The remaining key is converted to lowercase.
Hyphens (-) are replaced by underscores (_).

SIP Header	Conversion in Context
`User-to-User: 6796`	`{"user_to_user": "6796"}`
`X-Volubile-code: 123456`	`{"code": "123456"}`
`X-Volubile-client-id: CL001`	`{"client_id": "CL001"}`
`X-Volubile-offer-type: premium`	`{"offer_type": "premium"}`

Complete Example

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

{
    "user_to_user": "6796",
    "code": "ABC123",
    "client_id": "CL-45678",
    "client_segment": "premium",
    "campaign_id": "CAMP-2025-Q2"
}

​System Context

​Pre-Call Action

​Outgoing Call

​API

Initiate Outgoing Calls

​Campaigns (Excel / CSV)

​Incoming Call

​SIP

​Automatic Conversion

​Complete Example

System Context

Pre-Call Action

Outgoing Call

API

Campaigns (Excel / CSV)

Incoming Call

SIP

Automatic Conversion

Complete Example