Web Hooks

Web Hooks

Web hooks allow you to define custom functions in Javascript which are triggered by a HTTP post operation from your back-end systems.  Within your Javascript function you can translate an incoming JSON post to an appropriate Intilery event based on your entity configuration.

Web hooks are processed immediately.  Generated events flow through the standard Intilery event pipeline.

Properties of a web hook

To create a webhook, the following input is required: -

  • Web hook name
  • Javascript function
  • Optional http headers returned on successful responses from your web hook

Once saved, your web hook is available immediately. The web hook screen will show you the full url for your new end-point that you can copy/paste into your system.

Javascript Function

Your function should accept the incoming JSON object and return an appropriate Intilery event.  An example function is shown below.

function(incoming) {
  return {
    "Visit": {
      "Email": "my.email@domain.com"
    },
    "EventAction": "My Event Action", 
    "EventName": "My Event Name", 
    "EventData": {
      "Customer.First Name": "John",
      "Customer.Last.Name":
    }
  };
}

Url

The url for your web hook is generated automatically and will look something like this.  You can copy this to your clipboard using the button next to the field.

https://your.intilery.analytics.domain/1/5b60317977c8d3ca59301c11

Header configuration

Successful calls to your web hook will return a HTTP 200 response along with any static headers you have configured.  Adding headers to your web hook is optional.

Still need help? Contact Us Contact Us