← All release notesView Actions & Events docs
Event Streaming timestamp field corrected: use interactionEventTS for event time
The Event Streaming field and event reference docs previously told integrators to use eventTS to calculate durations between lifecycle events — queue time, ring time, talk time, and wrap-up time. That was incorrect: eventTS is the time the interaction was first offered (queue entry), and it carries the identical value on every event for a given interaction. Subtracting one event's eventTS from another's always evaluates to zero. The field that carries the event's own time is interactionEventTS.
What changed
eventTSis now documented as the interaction's offer/queue-entry time — constant across every event for that interaction — not as a per-event timestamp.- The queue time, ring time, talk time, and wrap-up time recipes now use
interactionEventTS. - The Go, Java, Python, and Node.js interaction-timeline code samples now read
interactionEventTS, and handle the event types where it's absent —GuestChatEnd,AgentUpdate,AgentLoginUpdate, andAgentProvChange— by falling back tomsgInfo.timestampinstead of defaulting to zero, which could previously decode as 1 January 1970. - A new Choosing a Timestamp section explains when to use
interactionEventTS,eventTS, ormsgInfo.timestamp, and notes that the two epoch-second fields are truncated rather than rounded.
See the updated docs:
This is the release entry. For the full feature documentation, use the docs link above.