Visitor Aware offers a way to record employee check-in events for customers who have an access control system requiring their employees to badge in and out of their buildings. This integration alleviates the need for employees to complete the check-in experience using a visitor kiosk and provides an overview of all employees who are currently in the building. Employees will be recorded within the Visitor Aware Dashboard Overview screen when they have badged into the associated location.
Note: This help article provides a general overview of this integration and does not provide all the necessary steps for implementation. To setup the access control system integration with Visitor Aware, please submit a support request.
Access Control System POST Webhook
Within the access control vendor's software we will need to create a POST webhook to push employee check-in related data into Visitor Aware.
The payload must be a json object containing the following:
{
"location_id": "YOURSCHOOLSOURCEDID",
"employee_id": "12345",
"direction": "[in/out]",
"destination": "destination uuid from the url",
"notes": "Anything you want in the activity log (optional)"
}Within the payload, the fields destination and notes are optional. If a destination is sent and matches to an existing location's destination it is recorded for that badge check-in event.
Note: For the employee to be recorded in Visitor Aware there must be a location_id and employee_id match made within Visitor Aware.
An employee will be checked into the Visitor Aware location as specified in the location_id when the direction value is in. Conversely, when the direction value is out the employee will be checked out.
Employee ID Data Import
The access control system integration relies on employee IDs being assigned to the associated employee profiles within Visitor Aware. On the Import Resources page, there are two templates that accommodate employee ID values:
- visitors.csv
- employees.csv
Select the template that fits your needs being sure to consider what employee information is available to you:
- If the end goal is to solely record employees badging in and out of the building, the employee.csv template may be a more appropriate fit.
- If employees are also guardians whose information is being synced through a student information system, the visitors.csv template may be an appropriate option.
A visitor profile containing an employee ID will allow the individual to use their ID/badge to check-in to a location as an employee while also giving them the option to use their state issued ID, facial recognition, or visitor specific QR code to check-in as a visitor/guardian. In summary, the individual will either be checked in as a visitor/guardian or an employee depending on how the individual completed the check-in process.
Note: A user account is used to log into the web admin portal within Visitor Aware and is not connected in any way to the visitor/employee profile containing the employee ID.
After choosing a template, there are two options to import the data:
- Manual import (Import Resources)
- SFTP import (Visitor Aware support required)
Customers can access the Import Resources page to manually import the employee ID data or if SFTP is more ideal, please submit a support request.
Employee Photo Import (Optional)
Employee photos can be imported into Visitor Aware and saved to the corresponding employee profile. A Secure File Transfer Protocol (SFTP) process must be used to import employee photos and each employee photo must be named as the associated employee's ID number. (Example: If the employee's ID number is 1234 then the employee's photo would be 1234.jpg)
Note: If the employee checks in as a visitor, the photo taken upon check-in will replace the employee photo that was initially imported.
If an employee photo import is needed, please be sure to mention this requirement in your support request.