session.event

Triggers when an event from session is handled. Currently supported events are: JSError, NetError, ErrorClick, RageClick and Custom

`JSError`

Triggers when a JS error is handled.

Example JSError payload

1{
2  "message_id": "d5932de4-a8da-4546-4439-3c640ba8dc05",
3  "webhook_id": "542de45",
4  "webhook_type": "session.event",
5  "api_version": "v1.0",
6  "account_id": "3ca3b1b",
7  "website_id": "8d53ea3",
8  "created_at": 1691161881,
9  "payload": {
10    "event_name": "JSError",
11    "value": "ProductCatalog: product is not valid",
12    "count": 1,
13    "time": 16911618810,
14    "visitor": {
15      "id": "e4d5932d-4439-4546-a8da-a8d40bc053c6",
16      "name": "John Doe",
17      "email": "john.doe@livesession.io",
18      "params": [
19        {
20          "name": "plan",
21          "value": "pro"
22        }
23      ],
24      "geolocation": {
25        "country_code": "PL",
26        "city": "Wroclaw",
27        "region": "Dolnoslaskie"
28      }
29    }
30  }
31}

`NetError`

Triggers when a network request error is handled.

Example NetError payload

1{
2  "message_id": "d5932de4-a8da-4546-4439-3c640ba8dc05",
3  "webhook_id": "542de45",
4  "webhook_type": "session.event",
5  "api_version": "v1.0",
6  "account_id": "3ca3b1b",
7  "website_id": "8d53ea3",
8  "created_at": 1691161881,
9  "payload": {
10    "event_name": "NetError",
11    "method": "GET",
12    "url": "https://api.livesession.io/products/1",
13    "status": 500,
14    "time": 16911618810,
15    "visitor": {
16      "id": "e4d5932d-4439-4546-a8da-a8d40bc053c6",
17      "name": "John Doe",
18      "email": "john.doe@livesession.io",
19      "params": [
20        {
21          "name": "plan",
22          "value": "pro"
23        }
24      ],
25      "geolocation": {
26        "country_code": "PL",
27        "city": "Wroclaw",
28        "region": "Dolnoslaskie"
29      }
30    }
31  }
32}

`ErrorClick`

Triggers when an error click is handled.

Example ErrorClick payload

1{
2  "message_id": "d5932de4-a8da-4546-4439-3c640ba8dc05",
3  "webhook_id": "542de45",
4  "webhook_type": "session.event",
5  "api_version": "v1.0",
6  "account_id": "3ca3b1b",
7  "website_id": "8d53ea3",
8  "created_at": 1691161881,
9  "payload": {
10    "event_name": "ErrorClick",
11    "messsage": "product is not defined",
12    "time": 16911618810,
13    "visitor": {
14      "id": "e4d5932d-4439-4546-a8da-a8d40bc053c6",
15      "name": "John Doe",
16      "email": "john.doe@livesession.io",
17      "params": [
18        {
19          "name": "plan",
20          "value": "pro"
21        }
22      ],
23      "geolocation": {
24        "country_code": "PL",
25        "city": "Wroclaw",
26        "region": "Dolnoslaskie"
27      }
28    }
29  }
30}

`RageClick`

Triggers when a rage click is handled.

exmple RageClick payload

1{
2  "message_id": "d5932de4-a8da-4546-4439-3c640ba8dc05",
3  "webhook_id": "542de45",
4  "webhook_type": "session.event",
5  "api_version": "v1.0",
6  "account_id": "3ca3b1b",
7  "website_id": "8d53ea3",
8  "created_at": 1691161881,
9  "payload": {
10    "event_name": "RageClick",
11    "clicks": 5,
12    "time": 16911618810,
13    "visitor": {
14      "id": "e4d5932d-4439-4546-a8da-a8d40bc053c6",
15      "name": "John Doe",
16      "email": "john.doe@livesession.io",
17      "params": [
18        {
19          "name": "plan",
20          "value": "pro"
21        }
22      ],
23      "geolocation": {
24        "country_code": "PL",
25        "city": "Wroclaw",
26        "region": "Dolnoslaskie"
27      }
28    }
29  }
30}

`Custom`

Triggers when a custom event is handled. These events are made during recording through the ls.track('EVENT') using Browser API function. The payload includes event specifics and potential validation errors for added properties.

The properties field is a map with varying value types. Value type depends on the property key. For instance, _str suffixed keys hold *string* values and _bool suffixed keys contain *boolean* values. Additional details are available in the knowledge base.

Example Custom paylod

1{
2  "message_id": "d5932de4-a8da-4546-4439-3c640ba8dc05",
3  "webhook_id": "542de45",
4  "webhook_type": "session.event",
5  "api_version": "v1.0",
6  "account_id": "3ca3b1b",
7  "website_id": "8d53ea3",
8  "created_at": 1691161881,
9  "payload": {
10    "event_name": "Custom",
11    "name": "Product added",
12    "properties": {
13      "product_id_int": 1,
14      "product_name_str": "Product 1"
15    },
16    "time": 16911618810,
17    "visitor": {
18      "id": "e4d5932d-4439-4546-a8da-a8d40bc053c6",
19      "name": "John Doe",
20      "email": "john.doe@livesession.io",
21      "params": [
22        {
23          "name": "plan",
24          "value": "pro"
25        }
26      ],
27      "geolocation": {
28        "country_code": "PL",
29        "city": "Wroclaw",
30        "region": "Dolnoslaskie"
31      }
32    }
33  }
34}