Events
The Events endpoint allows you to retrieve all the Contact's location events and application events from your Cloud4Wi account.
List of Events:
"signup": a Contact is created in your Cloud4Wi account, either when a person signs up from the guest WiFi, a Kiosk or via APIs
"visit": a Contact leaves a location after a visit. The event includes the visit metadata such as location and durations
"login": a Contact authenticates to a WiFi network, either on the guest WiFi, WPA2-Enterprise or Passpoint
"promo": a Contact clicks on a call to action in the Promo Page interstitial content. See Promo Page documentation.
"survey": a Contact responds to a survey. See Survey documentation
"send_email": an email has been sent via Campaign
"open_email": an email sent via Campaign has been opened
"click_email": a trackable link of an email sent via Campaign has been clicked
"send_sms": an SMS has been sent via Campaign
"click_sms": a trackable link of an SMS sent via Campaign has been clicked
Endpoints
List all events for an organziation id
List all Events, including Visits, WiFi connections and application events, of an Organization Retrieve all events og of the given organization . Role: Organization Manager Scope: organization_read, events_read
GEThttps://explore.cloud4wi.com//v1/organizations/{cid}/events
Path parameters
cid*string
id of the organization (aka tenant)
Query parameters
Response
Response
Body
statusstring
OK
generatedstring
date time of response
countnumber
eventsarray of object
Request
const response = await fetch('https://explore.cloud4wi.com//v1/organizations/{cid}/events', {
method: 'GET',
headers: {},
});
const data = await response.json();Response
{
"status": "text",
"generated": "text",
"count": 0,
"events": [
{
"type": "text",
"id": "text",
"visit": {
"startAt": "text",
"startAtLocal": "text",
"timezone": "text",
"duration": 0
},
"signup": {
"source": "text"
},
"email": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"email": "text"
},
"sms": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"phone": "text",
"prefix": "text"
},
"survey": {
"campaignId": "text",
"campaignName": "text",
"answerId": "text",
"questions": {
"question_1": "text"
},
"answers": {
"answer_1": "text"
}
},
"promo": {
"type": "text"
}
}
]
}List all events of a specific Contact
List all events, including WiFi Connections, Visits and applicaiton events of a given Contact Id Role: Organization Manager Scope: organization_read, events_read
GEThttps://explore.cloud4wi.com//v1/organizations/{cid}/customers/{id}/events
Path parameters
cid*string
id of the organization (aka tenant)
id*string
id of the user (ID of the table w.USERS) passed inside the JWT received at login
Query parameters
Response
Response
Body
statusstring
OK
generatedstring
date time of response
countnumber
eventsarray of object
Request
const response = await fetch('https://explore.cloud4wi.com//v1/organizations/{cid}/customers/{id}/events', {
method: 'GET',
headers: {},
});
const data = await response.json();Response
{
"status": "text",
"generated": "text",
"count": 0,
"events": [
{
"type": "text",
"id": "text",
"visit": {
"startAt": "text",
"startAtLocal": "text",
"timezone": "text",
"duration": 0
},
"signup": {
"source": "text"
},
"email": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"email": "text"
},
"sms": {
"campaignId": "text",
"communicationId": "text",
"channel": "text",
"campaignName": "text",
"phone": "text",
"prefix": "text"
},
"survey": {
"campaignId": "text",
"campaignName": "text",
"answerId": "text",
"questions": {
"question_1": "text"
},
"answers": {
"answer_1": "text"
}
},
"promo": {
"type": "text"
}
}
]
}Data example
Example of the response of the endpoint https://explore.cloud4wi.com//v1/organizations/{cid}/events
{
"generated": "2022-11-15T15:50:54Z",
"count": 20,
"events": [
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "arriving",
"id": "bd849965350413bc81e19aa5ff1be7ebl"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:09Z",
"createdAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "9e6391ce506c7ee7eb4c689b622feed3l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:09Z",
"createdAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "a419b0bef205cb25a7615011ecf72940l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:41:30Z",
"createdAtLocal": "2022-07-21T11:41:30Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "de2d683824f367234fe7734a4246cd32l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:53:49Z",
"createdAtLocal": "2022-07-21T11:53:49Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "4578cad147be31ceb6c5417f5439f8b2l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T18:53:49Z",
"createdAtLocal": "2022-07-21T11:53:49Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "visit",
"id": "de8a7434d907e640cf1e80c347a420bel",
"visit": {
"startAt": "2022-07-21T18:41:09Z",
"startAtLocal": "2022-07-21T11:41:09Z",
"timezone": "America/Los_Angeles",
"duration": 15
}
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home"
},
"when": {
"createdAt": "2022-07-21T18:56:23Z",
"createdAtLocal": "2022-07-21T11:56:23Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "arriving",
"id": "998ce4b66e5de87acf2241876f5dec52l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T19:52:38Z",
"createdAtLocal": "2022-07-21T12:52:38Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "4bd9bbe6e3e084adee2ffe73c88bd10fl"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T19:52:38Z",
"createdAtLocal": "2022-07-21T12:52:38Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "972c9bc632809246f7a3e03dfbbf83f7l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T22:56:42Z",
"createdAtLocal": "2022-07-21T15:56:42Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "login",
"id": "486e6dd99a9baf7528f9635ccc14a2b3l"
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-07-21T23:06:15Z",
"createdAtLocal": "2022-07-21T16:06:15Z",
"timezone": "America/Los_Angeles"
}
},
{
"organizationId": "155d60f21dc1938562900a0e201d54f6",
"customerId": "f4c6be2cebc56bf4b8a16a2d463d5b60",
"event": {
"type": "signup",
"id": "05ef4b6d8f936b36ce0c3f71c40494cdl",
"signup": {
"source": "wifi"
}
},
"where": {
"locationId": "ff808081803ff92a01821d4cfd856805",
"locationName": "Ivan Home",
"hotspotId": "5da63f1da1f3a290306314b6273d6382"
},
"when": {
"createdAt": "2022-06-15T11:10:13Z",
"createdAtLocal": "2022-06-15T13:10:13Z",
"timezone": "America/Los_Angeles"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "85bf512b7ff0466143dfbdd1ad0cdefdg",
"visit": {
"startAt": "2022-10-04T15:37:24Z",
"startAtLocal": "2022-10-04T17:37:24Z",
"timezone": "Europe/Rome",
"duration": 0,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:37:39Z",
"createdAtLocal": "2022-10-04T17:37:39Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "9b534ae5c33e6bfc25b1ad768c979384g",
"visit": {
"startAt": "2022-10-04T15:42:49Z",
"startAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:42:49Z",
"createdAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "e0679cb0c6e3bc2aac64b0639cc9b967g",
"visit": {
"startAt": "2022-10-04T15:42:49Z",
"startAtLocal": "2022-10-04T17:42:49Z",
"timezone": "Europe/Rome",
"duration": 0,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:43:25Z",
"createdAtLocal": "2022-10-04T17:43:25Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "8634d19a67f96d95d6154d31ea18effbg",
"visit": {
"startAt": "2022-10-04T15:43:41Z",
"startAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T15:43:41Z",
"createdAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "200cf048d1386556ab29c0ba119cc3f5g",
"visit": {
"startAt": "2022-10-04T15:43:41Z",
"startAtLocal": "2022-10-04T17:43:41Z",
"timezone": "Europe/Rome",
"duration": 85,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T17:09:10Z",
"createdAtLocal": "2022-10-04T19:09:10Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "24335a5ae56255b68bb68a34f90d6cb6g",
"visit": {
"startAt": "2022-10-04T18:48:41Z",
"startAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-04T18:48:41Z",
"createdAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_visit",
"id": "e2b34225b2572f19d818094fa48de580g",
"visit": {
"startAt": "2022-10-04T18:48:41Z",
"startAtLocal": "2022-10-04T20:48:41Z",
"timezone": "Europe/Rome",
"duration": 659,
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-05T05:47:59Z",
"createdAtLocal": "2022-10-05T07:47:59Z",
"timezone": "Europe/Rome"
}
},
{
"customerId": "8e62ca2305981e75854dcba1b6491bf5",
"event": {
"type": "geo_arriving",
"id": "95e3124a20b3b1d5a7380af3b53fa212g",
"visit": {
"startAt": "2022-10-05T07:27:26Z",
"startAtLocal": "2022-10-05T09:27:26Z",
"timezone": "Europe/Rome",
"properties": {
"appId": "62d86f755d146f00012297ea",
"appBundle": "com.cloud4wi.toolkit",
"projectId": "62d86f0068c4fc0001c4d63f",
"appOs": "android"
}
}
},
"where": {
"geofenceName": "Emi home",
"geofenceMetadata": [],
"geofenceId": "968bb2b8184f46af916e27aa619791f2",
"geofenceExtId": "Emilia",
"geofenceJSON": {
"type": "Circle",
"coordinates": [
10.517064,
43.675929
],
"radius": 100
}
},
"when": {
"createdAt": "2022-10-05T07:27:26Z",
"createdAtLocal": "2022-10-05T09:27:26Z",
"timezone": "Europe/Rome"
}
}
]
}
Last updated