Tempo webhook

Register Tempo Webhooks to receive real-time ETA notifications from your customers. As your customers get closer to their Destination to collect their order, Bluedot will send a notification every minute, so your team is ready to go.

Configure a Tempo Webhook

1. Add a New Webhook

Under Your Account, choose

2. Add the Webhook Details

Property	Description
Project	Select the Project you’ll receive the events from
Event	Select Tempo
Event Structure	Select Standard. If you’d like to send the Tempo updates to Tealium check this guide.
URL	The URL of the server where the webhooks will be received. We suggest that the service has SSL enabled.
Header Fields (Optional)	Add any extra parameters you’d like to be included in the header of the request. For example, this is a good place to add a security token to authorize the incoming events.
Body Fields (Optional)	Add any extra parameters you’d like to be included in the body of the request.

3. Save

You can also configure a Tempo Webhook through Config API (Information on using the Config API for registering a Webhook can be found here.)

Endpoint

Description

Add Tempo Webhooks to a Project

When creating or editing a Project you can add Tempo Webhooks within the tempo property.

Endpoint: https://config.bluedot.io/prod1/projects

Example of adding a Tempo Webhook:

"tempo": { 
    "webhooks": [{ 
        "type": "tempo", 
        "url": "<webhook URL goes here>" 
    }] 
}

Webhook request JSON structure

Update JSON request

{
    "deviceType": "iPhone12,3",
    "os": "iOS",
    "osVersion": "7.0",
    "customerApplicationId": "au.com.bluedot", 
    "sdkVersion": "1.11.0",
    "appBuildVersion": "1.11.2",
    "customEventMetaData": {
        "key1": "value1",
        "key2": "value2"
    },
    "eventTime": "2020-05-21T05:44:04Z",
    "longitude": 144.123123123,
    "latitude": -33.123123123,
    "destinationId": "store ID",
    "eventType": "tempoUpdate",
    "eta": 900, 
    "etaDirection": "greaterThan",
    "installRef": "1111111-2222-3333-4444-555555555555",
    "projectId": "1111111-2222-3333-4444-555555555555",
    "triggerChainId": "11111111-2222-3333-4444-555555555555",
    "notificationType": "tempo",
    "zoneId": "1111111-2222-3333-4444-555555555555",
    "zoneName": "Store 123", 
    "zoneCustomData": {
        "key1": "value1",
        "key2": "value2"
    }
}

Stop JSON request

{
    "deviceType": "iPhone12,3",
    "os": "iOS",
    "osVersion": "7.0",
    "customerApplicationId": "au.com.bluedot", 
    "sdkVersion": "1.11.0",
    "appBuildVersion": "1.11.2",
    "customEventMetaData": {
        "key1": "value1",
        "key2": "value2"
    },
    "eventTime": "2020-05-21T05:44:04Z",
    "destinationId": "store ID",
    "stopReason": "stoppedByCustomerApp", 
    "eventType": "tempoStop",
    "installRef": "1111111-2222-3333-4444-555555555555",
    "projectId": "1111111-2222-3333-4444-555555555555",
    "triggerChainId": "11111111-2222-3333-4444-555555555555",
    "notificationType": "tempo",
    "zoneId": "1111111-2222-3333-4444-555555555555",
    "zoneName": "Store 123",
    "zoneCustomData": { 
        "key1": "value1",
        "key2": "value2" 
    }
}

Tempo Webhook Field description

Field name	Description	Data type	Example
appBuildVersion	The app build version of the application using the Point SDK which triggered the check-in.	String	"1.11.2"
customerApplicationId	The application's package name.	String	"io.bluedot"
customEventMetaData	Key/Value pairs passed from the application to Bluedot Point SDK. This will not be returned as part of the request if no data set on the Mobile SDK.	JSON	{ "orderId":"Order 123" }
destinationId	The ID associated with the location setup in Canvas for the Zone.	String	"Store-123"
deviceType	The type of device that triggered the Tempo event.	String	"iPhone 9,3" "samsung SM-N950F"
eta	The estimated time of arrival of the user to the store in seconds.	Number	300
etaDirection	The direction of estimation – whether the device is more than or less than the number of seconds provided.	String	"greaterThan" "lessThan"
eventTime	Records the time the event reaches the Bluedot platform.	String	"2020-05-21T05:44:04Z"
eventType	This field denotes the type of event being relayed from our servers to yours. For a stop of Tempo the type will be “tempoStop”.	String	"tempoUpdate" "tempoStop"
installRef	A randomly issued installation reference, not tied to any personally identifiable data (PID) on the user’s device.	String	"44c2d0b8-0004-47fc-830d-b73e9ff706f6"
latitude	Latitude component of the coordinate of the current Tempo event.	Number	30.2672042
longitude	Longitude component of the coordinate the current Tempo event.	Number	-97.7447926
notificationType	This field denotes the type of notification being relayed from our servers to yours. For an Tempo event the type will be “tempo”.	String	"tempo"
os	The OS of the device that triggered the ETA event.	String	"android" "iOS"
osVersion	The OS Version of the device that triggered the Tempo event.	String	"8.0.0"
projectId	The identifier of the project with which the SDK is logged into the app.	String	"4647e4eb-f908-4d3d-82e9-4959d59923b0"
sdkVersion	The Point SDK version number being used in the application which has triggered the Tempo event.	String	"15.5.0"
stopReason	This field denotes the reason the Tempo service stopped running.	String	- invalidDestinationId: Passing an invalid destinationId to the start Tempo tracking SDK method. The SDK will return an error at the client level and at the same time, this event will be fired by our webhooks. - stoppedByCustomerApp: The stop Tempo tracking method is executed. - expired: Tempo service has been tracking the device for 30 minutes, and it hasn’t arrived at the destination. This expiring time is customizable. Check with your CX representative if you’d like to update it. - sdkLogout: The SDK’s reset method is executed.
triggerChainId	triggerChainId can be used to connect the ETA updates coming through for one set from start to finish.	String	"c8965662-d67f-49e8-abf9-0bada6c153d1"
zoneId	The unique identifier of the zone associated with the destinationId.	String	"4647e4eb-f908-4d3d-82e9-4959d59923b0"
zoneName	The name of the zone associated with the destinationId.	String	"Zone Name"