View source for NX Witness Interface (ZCP)

{{C}}
NX Witness can interface to Zenitel Connect Pro using REST.
==Introduction==
A Node-RED flow is required to handle authentication updates of the bearer tokens for both ZCP and NX Witness.<br>
NX Witness events can then be used to trigger events in ZCP using the REST interface.

Note: The process runs every 80 seconds, so additions and changes within NX may not work immediately, but will propagate over the next 80 seconds.<br>
This can be sped up by restarting the Node-RED flow.<br>
<br>
It's assumed that you have already created a Zenitel Link account in Zenitel Connect Pro for integration and you have a working NX Witness VMS.

==Node-RED flow==
Download the ZCP-NX-Witness-Authentication-Interface Node-RED flow from the [https://github.com/Zenitel-AS Zenitel Github.]

Import the Node-RED flow into Node-RED.
Edit the Setup Details node and update with the required settings
[[Image:nxnodered1.JPG|thumb|left|500px|Configuration node]]
<br style="clear:both;" />

*Connect Pro IP Address
*Connect Pro Zenitel Link Username
*Connect Pro Zenitel Link Password
*NX Witness IP Address
*NX Witness Username
*NX Witness Password

Deploy the flow and it will obtain the bearer tokens and begin scraping the NX Witness Events for the word Zenitel anywhere in the Title.

==NX Witness==
Create a new event against the Zenitel device by right clicking and selecting Rules
[[Image:nxrules1.JPG|thumb|left|500px|Select camera]]
<br style="clear:both;" />

*Press the 'Add Rule' button.

[[Image:nxrules2.JPG|thumb|left|500px|Add Rule]]
<br style="clear:both;" />

*Set the 'Title or comment' to contain the word 'Zenitel'.  This is the term that the Node-RED flow uses to locate ZCP events
**The title can contain other text, for example 'Zenitel TCIV-3+ Movement alarm'.
*Choose an event from the drop down box under "When Event"
*Set the "Do Action" drop down box to HTTPS request
*Add the URL to the ZCP Rest command you require (i.e. https://<IP_Address>/api/calls)
*Set the required method (i.e. POST)
*Add the required content according the Zenitel Link Schema
*Set the content type to "application/json"
*Set the Authentication type to Bearer
*Add any text to the Token as this will be overwritten every 80s by the Node-RED flow

[[Image:nxrules3.JPG|thumb|left|500px|Rule Window]]
<br style="clear:both;" />

The example shown will send a POST to the ZCP server at 192.168.10.1, and using the calls API will create an Audio Message Broadcast from 8191 to Group 85.<br>
The code example is
 {
 "from_dirno" : "8191",
 "to_dirno" : "85",
 "action" : "setup",
 "verbose" : true
 }
 
 [[Category: Zenitel Connect Pro]]
 
 [[Category:Zenitel Connect Pro Integrations]]