Adding Webhook Triggers

How to add a webhook trigger. User Role required to access these settings: Administrator and Triggers Manager.

To send data using webhooks in WhosOnLocation, you must create a webhook trigger. This will configure what, when, and where information is being sent.

Webhook triggers are created the same way as other triggers but can only be set up for sign in/out events and use a specific webhook action.

Before setting up a webhook trigger you must have added at least one webhook in your webhook URLs. Click here for information on adding webhook URLs.

Adding a Webhook Trigger

  1. Go to Tools > Locations.
  2. Click View next to your location.
  3. Select Triggers from the left-hand menu.
  4. Click Create a New Trigger.

    2019-05-29_9-07-45.png
  5. Enter the Trigger Name, Click Active for Trigger Status, Select the Trigger Method.
    Please Note: For a webhook trigger you must use a sign in or out event.

    2019-05-29_9-08-33.png
  6. Click Next.
  7. Enter any Trigger Rules.

    Rules are used to narrow down the Trigger Event to more specific scenarios. If you do not have any rules, the trigger will activate every time the trigger occurs.
  8. Click Next.
  9. Add the webhook trigger action by clicking the Create a New Action button and selecting Webhook – Triggers a Webhook URL.

    2019-05-29_9-10-31.png
  10. Configure the options and test your webhook. See below for more details.
  11. Click Save & Close.

Webhook Trigger Action Details

2019-05-29_9-13-37.png

Webhook

Select the webhook you want to send data to. This should be set up in your webhook integration settings. If you are an Account Owner or IT Support user, you can add a new webhook by clicking Add New.

2019-05-29_9-16-02.png

Please Note: Clicking Add New will navigate to a new page which may delete any unsaved changes to the trigger.

Data

There are two types of data packets you can send using webhooks; full and custom.

Full

Sends all standard data which is included in the sign in event, e.g. sign in/out time and method, name, organization, etc.

Custom

Create a custom data packet to send using placeholders. You must format this data so that it will be read correctly by your third-party application inserting your own headers for each value created by the placeholders.

To enter your placeholders in the data packet:

  1. Click View available placeholders.
  2. Select the category of placeholder.
  3. Click Insert next to a placeholder you want inserted in your custom data packet.

To check how your data will send, use the testing process below. Your data packet will be displayed under the Input Data heading.

Testing

Test your webhook by sending an existing event to the webhook URL to get a response.

2019-05-29_9-19-59.png

  1. Choose a record from the dropdown menu. You can select from the last 10 sign in events for the person type chosen in the Trigger Event.

    All of the data for that event will be displayed under the Input Data.

    2019-05-29_9-24-32.png
  2. Click Send Data.

The data will be sent to your selected webhook as a test and the response will be displayed under the Response Data heading.

2019-05-29_9-27-19.png

Part of the response should have the line {"success":true} which means it has worked. If it has the line {"success":false} it means it has failed and you need to reconfigure your settings.

Advanced Settings

In most scenarios, you would send data to your third-party system using webhooks, that system would do all processing of the data and send a response back to WhosOnLocation.

An example of how you can process the response further is if you wanted to add custom QR/barcodes to your temporary badge pass.

Printing custom QR/barcodes onto a temporary badge pass is very useful when integrating your access control system with WhosOnLocation through webhooks. Enabling you to return a value from the webhook and add it to the badge pass, eg. a temporary access code allowing access to certain locations by scanning their badge pass.

Please Note:

  • You need to have a badge pass template created and active with QR/barcode for your chosen person type.
  • The longer the value the larger the printed code will be. QR codes can be any length but barcodes can only be a maximum of four characters.
  • The response you receive needs to be in JSON format to be processed.

To set up the ability to return custom data to add to your temporary badge pass, follow these steps:

  1. Test your webhook by sending data as per steps above.
  2. Copy the JSON path you want to print the value of as a QR/barcode, e.g. access_code.
  3. Click Show Advanced below the test data.

    2019-07-02_14-41-16.png
  4. Click Create a New Action.
  5. Paste the JSON path with the prefix $.
  6. Click Select an Action > Set barcode/QR value on printed pass.

    2019-07-02_14-42-24.png
  7. Click Save & Close.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request