Nx Witness provides the option to receive HTTP generic events, which is a standard HTTP request to the Nx Server from any 3rd party software solution and/or Nx Witness itself. The Nx Witness REST API provides a standard set of API calls for 3rd party systems and/or Nx Witness itself.

With the Nx Witness REST API, it is possible to send Nx Witness events using a standard API call in the form of an HTTP string - also known as a Generic Event (i.e. the CreateEvent API call).

This means you can enable integration with any application that is able to send the HTTP event to trigger any action in Nx Witness. Using this method, it is also possible to create snapshots of any specified event. This article will describe how you can add a snapshot of an event to an email as an action.  

Create Event Rules to Receive Snapshots from Cameras via Email

Let's create a hypothetical use case: a sensor is triggered anytime a person walks into a confidential bank vault, and a signal input will send to an I/O device.  We want to receive an email with a snapshot of the camera(s) capturing that person’s arrival at the vault.

This can be accomplished by creating two Event Rules in Nx Witness. If everything is configured correctly, you will receive an Email Notification that looks like this once the Event Rule is triggered:

Create the First Event Rule

1. Log in to Nx Desktop as a user with Administrator permissions.
2. Open Main Menu > System Administration > Event Rules / Right-click on a camera and select Camera Rules.
3. Clicking on the Add button to open the Event and Action dialog.
4. Open the (Event) When dropdown on the left side and select the Event you want to use on the left. 
5. Configure the camera and other details for the Event.
6. Open the (Action) Do dropdown on the right side and select the action Do HTTP Request.

7. Fill in the fields for your Action.
   HTTP URL example:

   http://<the-server-IP-address>:<port-number>/api/createEvent

   HTTP content: Metadata and one or more of the following: source, caption, or description. Also, you must add the relevant Camera ID(s) to the API call.
   Content-type: application/json
   Authentication type: Auto
   Request type: POST
   Login: Your Nx account
   Password: Your Nx account password
   
   Example:
   

8. Apply changes.

Create the Second Event Rule

1. Click the Add button again to open the Event and Action dialog.
2. Open the (Event) When dropdown on the left side and select Generic Event.
3. Add the word you assigned to the source (and/or caption and/or description).
4. Open the (Action) Do dropdown on the right side and select the action Send email on the right.
5. Choose the proper interval of action and enter (or pick) the recipients.
6. Apply changes.
   
   Example: