Managing Contractors with Rapid Induct and Contractor Management? Using Rapid Induct to keep your workforce up-to-date with qualifications or Rapid Access to onboard your Visitors? Then this integration is for you.
Nirovision syncs trainees from Rapid Global so that when they arrive on-site, they are instantly identified by Doorkeepers or IP cameras, and cross-checked with Rapid to ensure all inductions, courses and compliance documentation are in order.
AI Checkpoints
help streamline vehicle and pedestrian entry points by automating access to compliant individuals via boom gates, turnstiles or doors.
1. How the integration works
Once the integration is enabled, it will be responsible for two main tasks:
- Keeping the Nirovision database in sync with Rapid's, by syncing new trainees and updates to existing ones.
- Leveraging a person's site-compliance status to log issues, and decide whether to grant or deny access automatically.
On this last point, it's worth clarifying that a worker's compliance in Rapid Global has two main dimensions:
- the Individual's compliance, calculated by looking at the completion status of mandatory courses, documents and forms assigned to the individual.
- the Contractor Company's compliance (when using Rapid Contractor Management), calculated by looking at the Company's compliance documentation (e.g. Workers Comp and Liability Insurance) and registration status.
Site-access compliance is defined as the combination of the individual's compliance, and his respective contractor company's compliance. Only site-compliant individuals can automatically access a site.
1.1. Profiles will be created in Nirovision for every Rapid Global Trainee, programatically.
When a new Trainee is created in Rapid Global, it will be synced to Nirovision within 60 seconds, creating a Profile. - Profiles created via this integration will display a widget with the record's Inductee ID (Rapid's internal ID) for easier cross-reference. If a Profile in Nirovision does not display the Integrations widget, then it's not in sync.
- Rapid contains a lot of personal data, but only a small portion can be synced to Nirovision, defined in the integration settings.
- Only the person's name, profile image email, phone number, company and facial recognition consent status can be synced.
- Compliance status is checked live to display the most up-to-date information.
- You can sync all Trainees from a Rapid Global account, or filter them by:
- Trainee Type, that is, the group they belong to (e.g. Contractor, Visitor, Employee).
- Site, to sync people registered against one or more sites within the account.
- Course, to sync people who have been assigned one or more courses to complete.
1.2. Updates to Rapid Global Trainees are synced to the corresponding Profile, programmatically.
- If a Trainee's details are updated in Rapid Global (e.g. a new profile image is uploaded, or a phone number is updated), it'll also be updated in Nirovision, within 60 seconds.
- If a Trainee is enrolled in Nirovision first, it'll be updated once the recorded is created in Rapid Global, based on the integration's merge settings. You can merge inductees based on email address match, phone number match or both.
- If a Trainee is deactivated in Rapid Global, or its trainee type is updated to one not included in the sync settings, it can be removed from Nirovision database or remain as disabled (to retain its historical access and status updates).
1.3. ID and compliance checks will be performed and recorded, and access will be granted or denied, every time someone is seen by Doorkeepers or IP cameras, programmatically.
π’ If all compliance requirements are met, the person will be checked in and granted access (if an access control integration is in place).
π΄ If the compliance checks fails or the person is unknown, then access will be denied (no automation will happen for them, and they won't be checked in), triggering real time alerts. iOS and Android Doorkeepers and QR Codes can be used to complete pending entry requirements onsite.
You can visualise someone's site compliance status by navigating to their Nirovision profile, and looking at the Compliance widget. Hovering over theβ will list all pending documents and courses, or any issues.
2. Before you start
Reach out to Rapid Global's support team at support@rapidglobal.com to request your site's API Key username and password. Store it safely.
Collect the site(s) Rapid GO URL(s) to offer individual's a chance to complete compliance requirements on the spot.
- Decide if you want to ask for an individual's consent to use facial recognition to check in faster coming forward. Their answer will be recorded in their Trainee profile in Rapid Global.
- If consent is given, an image will be collected for this individual's profile during their enrolment, and this image will be enrolled in the site's facial recognition database.
- If consent is denied, an image will be collected for this individual's profile, but it will not be enrolled in the site's facial recognition database. Every time this person is required to check in on-site, they will need to fill in their name, mobile and/or email, and other necessary data.
- Decide whether you want to sync all trainees from Rapid Global or only one or more subgroups of them (e.g. only Contractors). Inform your Nirovision support representative during your Onboarding call.
3. Enable the integration
On the Nirovision Web App π₯οΈ navigate to Settings > Company > API & Integrations > Integrations.
Click on the Add button next to the Rapid Global entry, and enter your Rapid Global API Key Username & Password.
You will be directed to the configuration screen that has three main sections:
Profile Sync contains settings related to syncing profiles from Rapid to Nirovision.
Decide whether to sync all Trainees or filter by Type(s), Site(s) or Course(s).
Decide how to handle excluded inductees: delete them from Nirovision's database or disable them.
Decide which properties from Trainees you'd like to sync: Name, Email, Phone, Company, Profile Image and Consent Status.
Decide whether to merge profiles based on email addresses, phone numbers or both.
Check-in & Compliance, enables checking for site-compliance in Rapid Global when checking someone in via a Doorkeeper or IP camera.
Map each Nirovision location with the corresponding Rapid Global site.
Enter the corresponding GO URL for each site.
When you're finished, click the Save button.
A green Enabled tag should now be visible next to the Rapid Global integration row, to indicate that the integration has been enabled. Profiles will start syncing immediately.
The cog wheel βοΈ now displays options to Configure, Disable and Delete the integration. Every time you Configure the integration and save your changes, it will trigger an update on the database sync.
4. How the entry process works
Compliant access via a turnstile, individual only.
Compliant access via a boom gate, individual and vehicle.
Non-compliant access via turnstile or boom gate.
5. Common issues
5.1. Compliance Issues, and how to action them
Below is a list of common reasons why someone may be stopped at an integration checkpoint, and how to address each situation.
- Compliance Issues are recorded in the Issues view of Activity. Review this article for a complete list of issues.
- Compliance Issues always result in unsuccessful check-ins, recorded as Stop events.
- Stop events can be reviewed in the Check-Ins and Events views of Activity, and can trigger real time alerts.
- You can always know in advance if someone will be stopped by looking at the person's Compliance widget.
- Review this article for a complete list of stop reasons.
π Invalid Document/Course/Induction
There is a missing or expired document/course/induction assigned to this person in Rapid Global.
- How to Confirm: Review this person's Compliance widget, or log in to Rapid Global and review this person's document statuses.
- How to Action: The worker needs to complete whatever is pending.
- If the document/course/induction can be completed onsite, the worker can scan a QR code (printed, at a truck driver entry on a tablet or Doorkeeper kiosk).
- For all other circumstances, they can log in their Rapid Global trainee portal on a computer or their mobile device.
π Invalid Profile
The profile is missing an Inductee ID, so the system cannot check this person's compliance status. There are a few circumstances than can cause this:
- A mismatch of data failed to update a profile in Nirovision (created before the Rapid record) following the Merge Settings (step 3.a), so a duplicate was created.
- This person's Trainee Type was not included in the Profile Sync settings (step 3.a).
- How to Confirm: The Integration widget does not appear on a profile that's not linked.
- How to Action: Create the worker in Rapid Global if not there already, it will be merged based on the integration's merging settings.
π Invalid Inductee ID
The profile is linked to an invalid Inductee ID, so the system cannot check this person's compliance status. This generally happens when a Trainee is deleted or merged in the Rapid Global platform.
- How to Confirm: Log in to the Rapid Global Trainee Portal and look for this Trainee, check the Notes for logs on recent updates. If you can't make sense of this status, reach out the support@rapidglobal.com for help.
- How to Action: If the profile was deleted or merged by mistake, reach out to support@rapidglobal.com to rectify. You may need to re-enrol the individual in Rapid Global, or request the Contractor Admin to do it.
π Profile is inactive
The profile is linked to a deactivated Trainee, so the system cannot check this person's compliance status. This generally happens when a person has finished their employment, or has been proactively blacklisted from a site.
How to Confirm:
Check the profile's status for a disabled banner, if you have chosen to retain deactivated trainee profiles.
If you have chosen to delete deactivated trainees from Nirovision, log in to the Rapid Global Trainee Portal and look for this individual, check the Notes for logs on recent updates. If you can't make sense of this status, reach out to support@rapidglobal.com for help.
How to Action:
Reactivate in Rapid if the individual was deactivated by mistake.
Optionally, change the integration settings if you'd like deactivated trainees to disappear from Nirovision.
π Company not compliant
The worker's contractor company is currently not compliant, so the worker cannot be granted access to site. Non-compliant companies are those that have been deactivated, manually suspended, have expired compliance documentation (e.g. Liability Insurance), or whose registration is pending in the Rapid Global platform.
How to Confirm: Log into the Rapid Global Contractor Portal and verify this Trainee's Contractor Company compliance status. If you can't make sense of this status, reach out to support@rapidglobal.com for help.
How to Action: Reach out to the Contractor Company to enquire about their registration status. No worker under their care will be deemed compliant to work on site until the company is fully compliant.
The worker has failed to complete one or more onsite requirements. These include:
- Section 10 of the Rapid Global Site Info section indicates which course(s) and/or induction(s) can be completed onsite.
- Nominating a host.
- Completing a Custom Form.
Onsite requirements can be completed on the spot by scanning a printed QR code, following Doorkeeper's instructions, or asking the individual to log in to their Rapid Global Trainee Portal.
- How to Confirm: Log into the Rapid Global Trainee Portal and verify the Section 10 Site Info requirements, host workflow and Custom Form requirements for this trainee.
- How to Action: Modify your entry requirements if one or more onsite requirement are not necessary.
5.2. Access control did not work
When an access control integration is enabled, the ultimate goal is for workers to be granted access programmatically, provided they are identified and compliant to come onsite. However, sometimes errors occur. Follow these steps to troubleshoot someone whose access wasn't granted as expected.
- Confirm a trigger was sent: look for this person's check-in in the Check-in view of Activity, and look for the Access Control trigger.
- If you see a triggered status, it means that our server or kiosk sent a signal to the controller instructing it to open the door.
- If this didn't happen, the person's credentials in the access control software may be incorrect or they may not have the appropriate permissions configured to open said door, and that's the next best thing to check.
- If credentials and permissions are ok, reach out to our support team to investigate further.
- If you see failed status, it means that an instruction was attempted to be sent to the controller, but it failed.
- If the error reads Connection failed, it meant that there is a communication issue between the controller and our server or kiosk. Rebooting the access controller is a good next step, but further actions may be needed.
- If the error reads Anti-passback, it means that the person attempted to check-in twice within a short period of time, and access was denied as a result. Adjust the anti-passback settings on the kiosk, or instruct the person to wait and try again.
- Confirm the person was checked in: if the trigger status is empty it means that no instruction was attempted to be sent to the controller. Start by confirming that the person was Checked In, by looking at their check-in status.
- If the status is In, then the person was checked in and access should have been granted. Reach out to our support team to investigate further.
- If the status is Stopped, it means that there was an error with the check-in or one or more failed entry requirements, and therefore access was not granted. There should be a reason listed next to the Stop to help you know how to action this.
- If the status is Pending, it means that there was one or more missing entry requirements that were either abandoned before completion or never attempted, and therefore access was not granted. There should be a reason listed next to the Stop to help you know how to action this.
- Confirm the person was matched: If you cannot find a check-in for this individual, it's likely that they could not be matched against a profile in the database.
- it's possible that they could not be matched because they either do not have a profile image, or the one they have is of poor quality. Follow the steps detailed in 5.4 below to troubleshoot.
- it's possible that they have no profile in the system because it was not synced from Rapid Global. Follow the steps detailed in 5.3. below to troubleshoot.
5.3. A trainee was not synced to Nirovision
The Profile Sync section of the integration settings defines which trainees are synced to Nirovision, based on Type(s), Site(s) or Course(s). If a Trainee is missing from the Profile database, it was likely excluded from the sync.
- How to Confirm: Log in to the Rapid Global Trainee Portal and look for this Trainee to confirm his Type, Site and Course. Review your integration Profile Sync settings to make sure it includes this Trainee.
- How to Action: If the settings did not include this Trainee, edit them and save your changes. Your profile database should update within a few minutes.
5.4. A trainee's profile picture was not synced to Nirovision
When a trainee uploads a profile picture to Rapid Global, the system checks it to reject some of them: non-human images (cartoons, pets) and images of very low quality (highly pixelated).
However, this process isn't infallible, so more checks are done by Nirovision before syncing them to reject:
- Group faces, that is, images than include more than one individual.
- Low quality faces, such as faces smaller than 100x100 pixels, distorted and stretched faces, partial and occluded faces and sideways faces.
If this is the case for a given trainee, then you'll find that they have a profile image in Rapid Global but not in Nirovision. Delete their profile image in Rapid Global so the worker is required to upload a new profile image the next time they sign in.
5.5. A trainee is not recognised / Access is inconsistent for a trainee
There are two usual causes behind this issue: no profile image or a low quality profile image, or a duplicate in the system.
No profile image / Low quality profile image
For someone to be recognised by kiosks and cameras, they need to have
at least one good quality profile image in Nirovision, synced from the respective Rapid Global trainee.
If the reference profile image is not good enough for our AI to recognise the individual, they will be treated as an unknown person: if seen by an IP camera, their activity will be recorded as a No Match, and won't be compliance checked or granted access.- How to Confirm: Use the No Match filter in the Events view of Activity to look for unknown activity, or the Similar filter to look for almost-matched activity.
- How to Action: If there is a Doorkeeper or QR code on site, the worker can follow the QR code to upload a new profile image in Rapid Global. The worker can also log in to their own Rapid Global Trainee Portal to upload a profile image.
Duplicate in the system
When the Nirovision AI encounters two or more matches for a given face seen by a kiosk or camera, it will log the Event as a No Match with an Ambiguous trigger, as it can't really decide which profile to match it to. As a result,
- How to Confirm: Use the Ambiguous filter in the Events view of Activity to look for duplicates.
- How to Action: Log in to the Rapid Portal to disable the duplicate trainee, which in turn will disable it in Nirovision.
5.6. A trainee was enrolled in Nirovision first, but later requires a compliance check
If someone has been enrolled in Nirovision first but later requires a compliance check, you can create a Trainee in Rapid Global and the Nirovision integration should update the record and link it, following the Merge Settings (step 3.a). You can check if a Profile has been linked to a Rapid Global Trainee by checking that the Integration widget.
5.7. Offline camera or Doorkeeper Kiosk
You can monitor the status of every camera and kiosk in your account, using the Devices page of the Web App:
6. How to disable the integration, and what happens next
On the Nirovision Web App π₯οΈ, navigate to Settings > Company > API & Integrations.
In the Integrations tab, click on the Edit button next to the Rapid Global row.
Selecting Disable will deactivate the integration, but won't delete it entirely. You can reactivate it at any time.
Selecting Delete will permanently delete the integration and unlink all Profiles.
In both cases:
No Trainee will be synced to a Nirovision profiles anymore.
Trainee updates will not update Nirovision profiles anymore.
Individuals will be checked in and out regardless of their Rapid Global compliance settings.