Webhooks

Register Webhooks to receive real-time notifications from your app user’s activity. Webhooks can be used to send events for:

Geo-trigger: Entry and/or exit into a Zone/Geofence
Tempo: ETA calculations as a user moves towards a Zone
Wave: API events when a user notifies of their arrival
Hello Orders: events when the state of an order has been updated in Hello Screens

Please also note that:

Multiple Webhooks can be added to the project
Webhooks structure can be standard hierarchical or flat
Header fields can be set dynamically

Configure a Webhook

There are two ways to configure a Webhook:

Through the Canvas UI
Using Config API (Learn more here.)

Webhooks are configured at the Project level with a maximum of one webhook for each Event type.

To set up Webhooks, login to Canvas and head to the Integrations section.

1. In the Integrations section, choose a Project where you would like to add a Webhook and click on the Add button

2. In the list of the Integrations search for the Webhooks tab and click on adding a new Webhook

3. Configure Event Type, URL, Header and Body fields

4. Header Fields for the standard Webhooks can be set dynamically by adding the {} in the value field. By the way, the value itself can be set and injected from the additional event-specific Custom Event Meta Data fields. The Dynamic Webhook Headers feature will pick up that value and attach it to the Webhook outputs.

Event	Choose Event Type: Geo-triggering Wave Tempo
URL	The URL of the server where the webhooks will be received. We suggest that the service has SSL enabled.
Header Fields (optional)	Custom headers sent along with the webhook request. Keys must not contain spaces. The dynamic headers (available only for standard webhooks) will require a fixed property key, only the value can be programmatically set. By adding dynamic headers to the Webhook, you’re setting up a pattern that will be picked up and populated from the webhook request body. It can be any property name that is present in the webhook request body. For example to set a custom value included in the event you can use eventMetaData.key_name for a Geo-trigger event or customEventMetaData.key_name for a Tempo or Wave event
Body Fields (optional)	Custom fields and values which will be added to the body of the webhook when sent. Keys must not contain spaces

5. Select Add

Receiving a Webhook notification

To receive a webhook, you would need a server, cloud function or any HTTP endpoint that can accept and process POST requests.

Webhook Event Headers

You can make use of the Token Key and Token Value to add your own signature to the Webhook event. The Token Key and Token Value will be included in the Header of the HTTP request.

tokenKey: "tokenValue"

We encourage you to make use of these Key/Value tokens to sign the events with our own values to verify the origin of the events.

Example HTTP header in the request

{
    "securitytoken": "72340732BlueDOT7297329-T0",
    "contenttype": "application/json"
}

Example Dynamic headers in the request

{
    "authentication_token": "Bearer {eventMetaData.auth_key}",
    "user_id": "{installRef}",
    "HeaderKey3": "HeaderValue3"
}

Webhook request JSON structure

Created by Bluedot DevOps on January 11, 2018

Documentation