Accessing Integration Settings

  1. Select Sites from the side-menu.

2. Select the Site you wish to integrate.

3. Select the Integrations tab at the bottom of the sidebar

4. The Integrations page will appear. When you have no integrations configured, it will appear the same as the picture below:

Adding a WebHook

Click on the + on WebHook under Available Integrations. The Add a new WebHookmodal will appear.

Note: If you need more information on webhooks, either click on the ‘?’ button in the top-right of the modal or read the information provided below

Configuration

  • Name: Used to identify the integration on rejected passes and the integrations page.

  • External ID: This field can be used to match up sites in the external system.

  • URL: The publicly accessible endpoint that Sine will call out to. We recommend using HTTPS.

  • API Key: Provide an identifier that Sine will pass through in the x-sine-auth header on requests. Use this key to verify that requests are coming from Sine.

  • Rejection Message: Users may set a rejection message in the case that the check-in attempt was unsuccessful. This will display on the iPad in the case that their details do not correspond to the WebHook server, preventing them from checking in. Customize this message from the Rejection message box from the Configuration page.(Optional): You can leave this field blank to display the default rejection message that your web-hook returns (for example, “You have been rejected by a Sine service.”). Alternatively, you can insert “%EXTERNAL_REJECTION_MESSAGE%” into the message, and the web-hook will automatically replace this with your default rejection message. An example of this is “%EXTERNAL_REJECTION_MESSAGE% Please ring for assistance” which will display something along the lines of “You have been rejected by a Sine service. Please ring for assistance“

  • Visitor Types: Select the desired visitor types that you want to capture events for. An example would be ‘Contractor’ only if using this WebHook for inductions.

  • Events: Select at least one event that you want this integration to run.
    No event type is reliant on another event type.
    Check-in Request Triggered before a Pass is created. Allows the integration to reject a pass with a rejection message or optionally add additional information to accepted passes. This is normally the most useful event for integrations.
    Check-in Success: Triggered after a pass has successfully been created. An integration can not mutate a pass off this event. This event will include answers to any entry forms configured on the site.
    Check-out Success: Triggered when a pass is checked out or expires. An integration cannot mutate a pass off this event. This event will include answers to any exit forms configured on the site.

  • Events (Enterprise Plans only)
    Check-in Request with Details Triggered before a Pass is created. Allows the integration to reject a pass with a rejection message or optionally add additional information to accepted passes. This contains additional Check-in details.
    Check-in Approval Pending Triggered before a Pass is created and where an approval is in Pending.
    Invitation Create Triggered when an invitation is created for a Visitor.
    Invitation Update Triggered when an invitation is updated for a Visitor.
    Invitation Delete Triggered when an invitation is deleted for a Visitor.

  • Status: whether the integration is active or not.

Request Specification

The following applies to all events:

  • Request will always be a POST.

  • Request will be application/json.

  • Responses must be application/json.

  • Responses must be a 200.

  • Sine is a cloud based service running on AWS. Integration endpoints must be open to the internet and use the x-sine-auth header for authentication.

The following applies to the Check-in Request event:

  • Request Format

  • Rejected Response Format

  • Success Response Format

  • This is a real time integration, the check-in process will be interrupted until the integration request has received a response.

  • If the response to the integration request is anything other than a 200 the check-in process will be aborted.

The following applies to the Check-in Success event:

  • Request Format

The following applies to the Check-out Success event:

  • Request Format

Example Invitation Create event:

Testing

The webhook responses can be easily tested using the following method:

  1. Go to https://webhook.site/ and it will provide you with a URL that you can use, then paste that URL in to the Integration URL field.

  2. Enter any value into the External ID and API Key fields for now.

  3. Create an invitation or Check-in with Sine. You will see the response on the webhook.site page.
    (Note, some webhooks are only available in Enterprise plans).

IP Ranges

Requests will come from the following addresses:

  • 13.55.33.1

  • 13.55.196.118

  • 13.55.216.196

Did this answer your question?