GT7

Use the GT7 integration to add Salto GT7 terminals to an XS4 Face site. Each GT7 terminal is paired with the XS4 Face Server and acts as a control point that uses face recognition. You enable the integration in the XS4 Face Console and configure each terminal in the Gantner portal.

Prerequisites:

• An XS4 Face Server on the site that is online.
• A GT7 terminal in your project in the Gantner portal, and permission to change its device configuration.
• A network route from the GT7 terminal to the XS4 Face Server. If the GT7 terminal is on a different network from the XS4 Face Server, for example the corporate network, add a route so that the terminal can reach the server.

Enable the GT7 integration

1. In the XS4 Face Console, select the site and click Features in the left-hand pane.
2. On the GT7 tile, turn on the toggle.

Pair a GT7 terminal

Pair each GT7 terminal with the XS4 Face Server. You need the XS4 Face Console and the Gantner portal open at the same time.

1. In the XS4 Face Console, on the GT7 tile, click the settings icon. The GT7 settings open on the right-hand side of the page.

2. Click Add Device. A new row appears with the status Commissioning and an Access Token.

   

3. Make a note of the Access Token and of the Server IP Address (IPv4) shown at the top of the GT7 settings.

4. In the Gantner portal, open your project, select Devices and then select the GT7 terminal.

5. In the device information, under Device configuration, select XS4 Face.

   

6. Select Enable facial recognition.

7. In Server address, enter the Server IP Address (IPv4) from the XS4 Face Console.

8. In Pairing code, enter the Access Token from the XS4 Face Console.

9. Click Save.

   

10. In the XS4 Face Console, check that the GT7 settings show the MAC address of the terminal with the status Ready.

    

Each Access Token works for one terminal. To pair another GT7 terminal, click Add Device again and repeat these steps. To remove a terminal from XS4 Face, click Delete in its row.

Enroll GT7 users

When the GT7 integration is enabled, the Enrollments page has a GT7 Enrollments tab.

1. Click Enrollments in the left-hand pane, then select the GT7 Enrollments tab.
2. Click Enroll User.
3. Enter the user's Email. Optionally, enter the User ID of the user in the GT7 system, with up to 8 hexadecimal characters.
4. Click Send.

If Send enrolment emails is on, XS4 Face sends the user an email with a link to enroll their face in the XS4 Face Enrollment Service.

Enrollment emails

By default, XS4 Face sends an enrollment email to each user that you enroll for GT7. To stop sending these emails, turn off Send enrolment emails in the Feature Details of the GT7 settings, then confirm.

Third-party user enrollment

GT7 sites often use a membership management system (MMS) from a third-party integrator, such as a gym or spa management system, to manage their members. Approved integrators can connect their MMS to XS4 Face, so that the MMS manages which members can use face recognition, instead of you enrolling each user in the XS4 Face Console. Gantner manages these integrations.

How it works

1. The MMS adds a member to the XS4 Face site, with the member's email address and the user ID that the GT7 uses for that member.
2. The member enrolls their face, accepts the terms of service and gives consent for the site.
3. XS4 Face delivers the member's enrollment to the XS4 Face Server on the site.
4. When the member presents their face to an XS4 Face Device, the device sends the member's user ID to the GT7 terminal that the device is paired with.
5. The GT7 terminal sends an access request for that user ID to the MMS, which grants or denies access.
6. When a membership ends, the MMS removes the member from XS4 Face, and the member is no longer recognized.

The MMS can also show each member's enrollment status, for example whether they still need to submit an image or give consent. Members can withdraw their consent at any time, which removes them from XS4 Face.

Integration levels

There are two levels of integration:

Set up a site for an integrator

To set up a site that uses an approved integrator:

1. Add the site, with the Company Name and Privacy Policy URL of the customer. Members see these when they give consent. For more information, see XS4 Face Enrollment Service.
2. Enable the GT7 integration, pair each GT7 terminal, and pair each XS4 Face Device with the GT7 terminal at the same door as its control point.
3. In the Feature Details of the GT7 settings, copy the Feature ID and give it to the integrator. The MMS uses the Feature ID to manage the members of this site.
4. For a Level 2 integration, turn off Send enrolment emails, so that members enroll in the integrator's app instead of receiving an email.

Become an integrator

If you develop a membership management system and want to integrate it with XS4 Face, contact the Gantner integrations team at integrations@gantner.com. Gantner provides development credentials, a test environment and the integration documentation, and approves each integration before it can be used on customer sites.