Nightly Data Dumps

For Enterprise customers, ServiceBell offers nightly data dumps of all visitor activity we logged for that day. Data will be uploaded to your storage provider of choice with a consistent format and naming scheme so that you can automate integrating the data into your own custom tooling.
Contact our sales team at [email protected] to get your organization set up with data dumps.
Example Data
1
{
2
 "version": "1.0.0",
3
 "start_time": 1632787200000,
4
 "end_time": 1632873600000,
5
 "users": {
6
 "1495955663": {
7
 "id": "1495955663",
8
 "email_address": "[email protected]",
9
 "display_name": "Will O'Beirne",
10
 "title": "Sales Representative",
11
 "active": true
12
 }
13
 },
14
 "unique_visitors": {
15
 "e63fbcf8-6be1-4f5b-bd1c-023db6afc4fb": {
16
 "id": "e63fbcf8-6be1-4f5b-bd1c-023db6afc4fb",
17
 "custom_id": "some-clickup-id",
18
 "custom_metadata": {
19
 "display_name": "Visitor Name",
20
 "email": "[email protected]",
21
 "any_other_custom_key": 123
22
 }
23
 }
24
 },
25
 "unique_visitor_sessions": {
26
 "00a631ba-ccba-4994-a52f-0d6c2bb69608": {
27
 "id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
28
 "session_group": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
29
 "unique_visitor_id": "e63fbcf8-6be1-4f5b-bd1c-023db6afc4fb",
30
 "referrer": "http://google.com/",
31
 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0.3 Safari/605.1.15",
32
 "start_time": 1632937435000,
33
 "end_time": 1632937477000
34
 }
35
 },
36
 "unique_visitor_session_actions": [
37
 {
38
 "id": "2147483409",
39
 "action": "REQUESTED_HELP",
40
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
41
 "timestamp": 1632937436000
42
 },
43
 {
44
 "id": "1058988876",
45
 "action": "ALERT",
46
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
47
 "timestamp": 1632937437000
48
 },
49
 {
50
 "id": "2085049932",
51
 "action": "PAGE_VISIT",
52
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
53
 "timestamp": 1632937438000,
54
 "data": {
55
 "url": "https://website.com",
56
 "url_title": "Test Website - Homepage"
57
 }
58
 },
59
 {
60
 "id": "1256524328",
61
 "action": "FEEDBACK",
62
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
63
 "timestamp": 1632937439000,
64
 "data": {
65
 "stars": 5
66
 }
67
 }
68
 ],
69
 "unique_visitor_session_interactions": [
70
 {
71
 "id": "1056417425",
72
 "kind": "SPYING",
73
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
74
 "user_id": "1495955663",
75
 "start_time": 1632937436000,
76
 "last_seen": 1632937436000,
77
 "accepted": true,
78
 "accept_time": 1632937439000
79
 },
80
 {
81
 "id": "77869321",
82
 "kind": "VIDEO",
83
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
84
 "user_id": "1495955663",
85
 "start_time": 1632937437000,
86
 "last_seen": 1632937457000,
87
 "accepted": true,
88
 "accept_time": 1632937438000
89
 },
90
 {
91
 "id": "325040803",
92
 "kind": "TAKEOVER",
93
 "session_id": "00a631ba-ccba-4994-a52f-0d6c2bb69608",
94
 "user_id": "1495955663",
95
 "start_time": 1632937436000,
96
 "last_seen": 1632937436000,
97
 "accepted": false
98
 }
99
 ]
100
}
101
​
Copied!
Additional Notes
Semantic versioning
Data dumps provide a version number that you can use to determine if your processor is able to handle the data. We use semantic versioning, with the following justifications:
Patch - Fixes to issues in our reporting. The schema did not change in any meaningful way, but issues that were present in past exports may have been fixed.
Minor - New keys or types of entries were added that provide more information, but the data is fully backwards compatible.
Major - Meaningful and potentially breaking changes have happened in the structure of the schema.
Treat IDs as Strings
Despite some IDs being numeric, they should all be treated as strings as we may update their format in the future, and any numeric operations may break as a result.
Sessions & Session Groups
Sessions are single socket connections to the ServiceBell widget. Any full page load or disruption in the socket connection (e.g. going offline, being load balanced to a different server) will start a new session.
Session groups are collections of sessions that happened close together. Session groups are identified by using the ID of the earliest occurring session in the group, for instance sessions "A" and "B" that happened in close succession would both have session_group: "A".
Midnight Cutoff
Sessions that span the gap of the midnight cutoff may be in two days worth of dumps. A session that was ongoing at midnight will have an unset end_time. 
Interaction Acceptance
All unique_visitor_session_interactions have an accept and accept_time field, even if there is no UX flow for "accepting" the interaction (e.g. answering a proactive call, allowing a takeover.) This is to allow for granular permissions and compatibility with all UX flows in case we change what a user can or cannot accept in the future.
Interactions that have no acceptance UX will always be accept: true with an accept_time that matches start_time.
New Actions & Interactions
New types of unique_visitor_session_action and unique_visitor_session_interaction will be added in the future as ServiceBell provides more ways to interact with visitors. These will result in minor version bumps, but should be backwards compatible if you filter or ignore unknown actions and interactions out.
Integrations - Previous
Slack
Last modified 2mo ago
Copy link
Contents
Example Data
Additional Notes