8  Integration with external systems

    There are two ways to integrate FLIR Screen-EST with an external system:
  • Digital output.
  • Webhooks.

8.1  Digital output

A basic level of integration is possible if the FLIR camera has a digital I/O connector.
  1. Connect an external device such as a gate, lights, or a siren to the digital I/O connector of the camera.
  2. Configure FLIR Screen-EST to trigger a digital pulse depending on the screening result; Normal temperature or Elevated temperature. For digital output settings, see section 6.3.3 Output tab .

8.2  Webhooks

Webhooks is a method for HTTP communication between different systems. By using webhooks, FLIR Screen-EST can be controlled by a third-party system. As an example, you can include FLIR Screen-EST screening in your access control system.
    General workflow for a third-party access control system with FLIR Screen-EST screening:
  1. The visitor starts the sign-in process through the access control system.
  2. The access control system prompts the visitor to perform a screening and sends a Start command to FLIR Screen-EST.
  3. The FLIR Screen-EST displays live images in the visitor window, measures and analyzes the temperature, and displays a screening result in the visitor window.
  4. FLIR Screen-EST sends the screening result, Normal temperature or Elevated temperature, to the access control system.
    If there is no screening result within a specified time limit, a Misreading response is sent instead.
  5. The access control system sends a Sleep command to FLIR Screen-EST.
  6. The screening functionality in FLIR Screen-EST is deactivated and the visitor window displays the system closed screen.

8.2.1  POST requests to FLIR Screen-EST‎

FLIR Screen-EST is configured to listen for POST requests on the following paths:
Start request: http://workstationAddress:port/screenest/start
Sleep request: http://workstationAddress:port/screenest/sleep
    where:
  • workstationAddress can be the local IP (localhost) or an external IP address.
  • The path port must be the same as the computer port specified in the FLIR Screen-EST settings, see section 6.3.4 Webhooks tab .

8.2.2  Callbacks from FLIR Screen-EST‎

After receiving a Start/Sleep POST request, FLIR Screen-EST will make a callback on the address defined in the POST request body. If the callback address is missing in the request, the address specified in the FLIR Screen-EST settings will be used.
    This means you can specify the callback address (URL) in two ways:
  • Send the URL via the POST request body.
  • Specify the URL in the FLIR Screen-EST settings, see section 6.3.4 Webhooks tab .
The callback URL format is:
http://address:port/api/callback/#
where # = alarm/pass/misreading/ready/waiting/error/standby

8.2.3  Events after a Start request

When FLIR Screen-EST receives a Start request, the following happens:
  • If FLIR Screen-EST is not ready for screening, it responds with an error callback.
  • If FLIR Screen-EST is ready for screening, the following happens:
    1. In the operator window, the Enable tracking check box is selected.
      The visitor window displays live images.
    2. FLIR Screen-EST sends a ready callback, indicating that the system is ready for screening.
    3. FLIR Screen-EST sends a waiting callback, indicating that the system is waiting for a person to screen.
    4. FLIR Screen-EST sends one of the following callbacks:
      • pass — if the screening result is Normal temperature.
      • alarm — if the screening result is Elevated temperature.
      • misread — if there is no successful screening result within the specified time limit.

8.2.4  Events after a Sleep request

    When FLIR Screen-EST receives a Sleep request, the following happens:
  1. In the operator window, the Enable tracking check box is cleared.
    The visitor window displays the system closed screen.
  2. FLIR Screen-EST sends a standby callback.

8.2.5  Webhooks settings

For webhooks settings, see section 6.3.4 Webhooks tab .

8.2.6  Configurations for external system outside localhost

For FLIR Screen-EST to receive incoming POST requests and return callbacks from outside the localhost, you may need to configure the firewall and port settings of the computer where FLIR Screen-EST is installed.