Before You Begin

• Admin access to an Avigilon (previously known as OpenPath) account to update Video Reader devices and add rules.
  • This article assumes that the Video Readers have already been added to your Avigilon environment and have set up correctly.
• Account Admin access to your Maptician environment. This only applies if you are configuring the integration on your own without assistance from Maptician.

Hardware Requirements

To properly use this feature, your Avigilon environment needs to be configured with at least one Avigilon Video Reader Pro.

Configure QR Read Event Forwarding in Avigilon

1. Log in to your Avigilon admin portal: https://access.alta.avigilon.com/
2. Using the left navigation bar, go to: Config > Rules

   

3. Select the + icon to create a new rule.

4. In the Create rule panel, we recommend entering the following information:
   1. Info - This section can be adjusted to your desired specifications
      1. Name: QR Code Detected
      2. Description: When a Video Reader detects a visitor’s QR code, it sends the event to Maptician for validation. If the QR code is valid, Maptician will authorize and trigger the door to unlock.
   2. Trigger
      1. Type: Event Forwarder
      2. Event: Video device - QR code detected
   3. Action
      1. Target URL: https://{subdomain}.maptician.com/ext/inbound/openpath/webhooks/visitor/
5. Click the Save button.

Configure Video Readers for QR Code Recognition

1. Using the left navigation bar, go to: Devices > Video readers

2. Click on the video reader you want to edit.
3. Click on the Video tab.
4. Under the Detection Settings section, toggle on the Enabled QR code recognition setting.
5. Scroll down and click the Save button.
6. Repeat the steps above for all Video Readers needing to scan QR codes.

Add Avigilon Credentials in Maptician

1. Add your Avigilon credentials in your Maptician environment: Settings > Environment > OpenPath Integration
   1. If you need help entering your Avigilon/OpenPath credentials in Maptician, view our Avigilon setup guide and just follow the steps for how to Enter the Avigilon credentials into Maptician.
2. Check the Enable OpenPath Visitor Management checkbox.

3. Click the Save Changes button.
   1. This will automatically create a user in your Avigilon environment named {Maptician Subdomain} Visitor Access Controller with the email address of developer+{subdomain}@maptician.com.

Adding Access Control in Avigilon

It is highly recommended that when needing to set up your environment's sites and zones, to reach out to Avigilon's support for additional help.

1. Log in to your Avigilon admin portal: https://access.alta.avigilon.com/
2. Using the left navigation bar, go to: Users > Users

3. Locate the user Visitor Access Controller.
4. Click on the user’s record to edit.
5. Navigate to the Access tab.

6. Under the Access section, click the drop-down arrow next to the site name you want this user to have access to.

7. A list of all zones for that site will appear.
   1. Check the box under the User Access column for each zone you want the Visitor Access Controller to access.
   2. This ensures that when a visitor scans their QR code, they will receive the correct access.

8. Be sure to save your changes before exiting!

How to Unlock an Entry Point

After a visitor has checked in for their scheduled visit at your location using the Visitor Signage or another designated check-in area, they will need to use the original visitor invitation email that contains their QR code.

This QR code can be used in two ways:

• Check-in: Visitors can scan the QR code at the Visitor Signage for a quick check-in upon arrival.
• Access entry points: After check-in, the same QR code can be used to gain access to entry points throughout your building, such as doors or elevators equipped with Avigilon Video Reader Pro devices.
  • If the visitor hasn't checked in before scanning their QR code, the first time they scan their QR code at an entry point, they will automatically be checked in, and a notification will be sent to the host. 

To unlock an entry point, the visitor simply presents the QR code from their phone to the Avigilon Video Reader. Once scanned, the reader will grant access to the configured entry point for the visitor.

Note: The visitor QR code is valid only for the day of the scheduled visit.

View Visitor's Number of Entries

To view the number of entries the visitor has been granted, follow the steps below:

1. In Maptician, navigate to Visitor Mgmt > Manage Visits.
2. In the Visitors column:
   1. Click the visitor’s name if the visit has a single visitor, or
   2. Click the number displayed if the visit has multiple visitors.

3. In the Visitor List pop-up, find the visitor and view the Entry Attempts column.
4. This is the number of times the visitor has scanned their QR code.

Troubleshooting

Bad Request - This user is already active in this organization.

When checking the Enable OpenPath Visitor Management setting in Maptician, if an error occurs related to an existing user, perform the steps below in your Avigilon environment:

1. Log in to your Avigilon admin portal: https://access.alta.avigilon.com/
2. Using the left navigation bar, go to: Users > Users

3. Find the user Maptician Visitor Access Controller.
4. Edit the user by clicking on their record.
5. Navigate to the Credentials tab

6. Click to remove their Maptician Visitor Access Credential.

7. After you confirm to remove the credential, close the user's record.
8. Back on the Users screen, click the delete icon to remove the user completely.