Context

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",
    "conversationType": "call",
    "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, 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.
`system.conversationType`	Channel of the current conversation: `call` for a phone call, `chat` for the web chat widget. Use it to adapt the prompt to the channel.

Adapting the prompt to the channel

Because the same agent can run on both the voice and the chat channels, system.conversationType lets you tailor the prompt to the channel it is currently running on. This is useful, for example, to keep chat replies short and easy to read, or to reference channel-specific instructions.

{% if system.conversationType == "chat" %}
Keep your answers concise and easy to read on screen.
{% else %}
Keep your answers natural to hear, suited to a spoken conversation.
{% endif %}

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

Getting Started

Product discovery

Telephony

Integrations

System Context

Adapting the prompt to the channel

Pre-Call Action

Outgoing Call

API

Initiate Outgoing Calls

Campaigns (Excel / CSV)

Incoming Call

SIP

Automatic Conversion

Complete Example

​System Context

​Adapting the prompt to the channel

​Pre-Call Action

​Outgoing Call

​API

Initiate Outgoing Calls

​Campaigns (Excel / CSV)

​Incoming Call

​SIP

​Automatic Conversion

​Complete Example

System Context

Adapting the prompt to the channel

Pre-Call Action

Outgoing Call

API

Campaigns (Excel / CSV)

Incoming Call

SIP

Automatic Conversion

Complete Example