System Token Categories

How System Tokens Are Organized

System tokens are organized into categories, each contributing a set of tokens describing one facet of a
call or lead. The categories are loaded at application start, and every token in them becomes a valid system token name.

The Token Categories

• Call tokens - Call-level attributes: status, hangup cause, routing path, UUID.
• Duration tokens - Timing fields: total duration, hold duration, agent duration, IVR duration, billable minutes.
• Buyer tokens - Winning buyer attributes: name, ID, bid price, external record ID.
• Offer tokens - Offer attributes: name, ID, external record ID.
• Number tokens - Inbound number attributes.
• Schedule tokens - Originating schedule attributes.
• Lead tokens - Lead attributes (for lead-driven flows).
• Traffic Source tokens - Traffic source attributes.
• Geographical tokens - Caller geography: country, state, city, zip code, area code, country code, prefix, suffix, state name, country name, province.
• Caller Count tokens - Repeat-caller counts: how many times the caller has called in the last 1 day, 7 days, 30 days and 90 days.
• Time tokens - Current time tokens: current hour and minute, current weekday, call start time in UTC.
• DNC tokens - DNC and suppression state for the caller.
• Identification tokens - Caller identification data.
• Instant Agent tokens - Off-hook / instant-agent routing state.
• Recording tokens - Recording URL tokens for the full call recording, the agent recording, and the buyer recording.
• Transcription tokens - Transcription text and JSON tokens for the full call, the consumer-and-agent segment, and the consumer-and-buyer segment.

Token Types

Most tokens are strings. A subset is explicitly numeric and gets coerced to a number when posted to downstream systems. Examples: call ID, total duration, payout, revenue, provider cost, quality percentage, billable minutes.