barsThe Event object

Events are generated by some Voxity resources when important actions occurred in your agent. When this happens, a new Event object is created.

For a list of event types, including sample events, see the section Event types. Events are represented as JSON objects and they all have a similar structure, and the same top-level fields.

The following fields appear in all events sent by Voxity and comprise the Event object.

{
    "version": "0",
    "id": "event identifier",
    "type": "event name",
    "agentId": "event agent",
    "description": "event description",
    "createdAt": "event date and time",
    "data": {
        "object": {
            JSON Object
        },
        "previousAttributes": {
            JSON Object
        }
    }
}

Attributes

Name
Type
Description

version

string

By default, this is set to "0" in all events.

id

string

Unique identifier for the event.

type*

string

Type of the event (e.g. customer.created).

agentId*

string

The ID of the agent associated with the event.

description

string

A human readable description of the event.

createdAt

string

The date and time (in UTC ISO 8601 formatarrow-up-right) when the event was created.

data*

object

An object that contains information about the event.

data.object*

object

Object containing the API resource relevant to the event.

data.previousAttributes

object

Object containing the names of the updated attributes and their values prior to the event.

circle-info

The contents of the data field are different depending of the event type. For examples of events generated, see Event types.

Last updated