Skip to main content

Sine Integration

FairTest integrates with Sine (by Honeywell) to use site check-in data for random selections. When employees sign in at a Sine kiosk or app, FairTest automatically receives that data and can use it as the pool for drug and alcohol testing selections.

How It Works​

  1. Sine sends a webhook to FairTest each time someone checks in or checks out at a site
  2. FairTest records the check-in and maps it to a location using the External ID you configure in Sine
  3. When you run a selection using Sine Signed In, FairTest looks at who is currently checked in today and selects from that pool
  4. Employees are matched between Sine and FairTest by email address

Setting Up the Integration​

Step 1: Enable Sine in FairTest​

  1. Go to Setup > Integrations
  2. Click Configure next to Sine
  3. Optionally enter a Visitor Type to filter by (e.g. "Staff") — leave blank to accept all visitor types
  4. Click Enable Sine

FairTest will generate a Webhook URL and API Key for you. You'll need these in the next step.

Step 2: Configure Webhooks in Sine​

You need to set up a webhook in Sine for each site you want to track. Repeat the following for every site:

  1. In Sine, go to Locations and select a site
  2. Click Settings > Integrations
  3. Click Add a new WebHook
  4. Fill in the following:
    • Name — anything you like (e.g. "FairTest")
    • URL — paste the Webhook URL from the FairTest setup page
    • API Key — paste the API Key from the FairTest setup page
    • External ID — paste the FairTest Location ID from the table on the setup page (this tells FairTest which location the check-ins belong to)
  5. Under Visitor Types, tick the types you want to track (e.g. "Staff", "Contractor")
  6. Under Events, tick:
    • Check-in Success
    • Check-out Success
  7. Click Save

Step 3: Test It​

After saving the webhook in Sine, do a test check-in at the site. You should see the check-in data appear in FairTest when you run a selection.

Finding Your Location IDs​

The FairTest Location IDs are shown on the Sine integration setup page (Setup > Integrations > Sine). Each location has a copy button next to its ID.

These IDs are what you enter as the External ID in each Sine webhook configuration — this is how FairTest knows which location a check-in belongs to.

Running a Sine-Based Selection​

  1. Go to Selections and click New Selection
  2. Choose Sine Signed In as the pool type
  3. Optionally filter by a specific Location
  4. Choose your selection method (percentage or count)
  5. Run the selection

FairTest will query everyone who has checked in today and not yet checked out, match them to your employees by email, and run the random selection from that pool.

Important Notes​

  • Email matching — employees must use the same email address in both Sine and FairTest for matching to work. If an employee checks in with a different email, they won't be included in the selection pool.
  • Check-out tracking — if an employee checks out before the selection is run, they will not be included in the pool. Only people currently signed in are eligible.
  • Multiple sites — you can set up webhooks for as many Sine sites as you need. Each one maps to a different FairTest location via the External ID.
  • Visitor type filtering — if you set a visitor type filter in FairTest (e.g. "Staff"), only check-ins of that type will be recorded. This is useful if you have multiple visitor types but only want to select from employees.

Managing the Integration​

  • Enable/Disable — toggle the integration on or off without losing your webhook configuration
  • Change visitor type — update the visitor type filter at any time from the setup page
  • Disconnect — removes the integration from FairTest. Existing check-in data is preserved. You will need to remove the webhooks from Sine separately.

Troubleshooting​

No one is showing as signed in:

  • Check that the webhook is configured correctly in Sine (URL, API Key, Events)
  • Verify the External ID matches a FairTest Location ID
  • Ensure the correct Visitor Types are ticked in Sine
  • Confirm employees have checked in today and haven't checked out

Employees not matching:

  • Check that the employee's email in FairTest matches the email they use when signing in via Sine
  • Ensure the employee record is marked as active in FairTest

Related Articles: