Adding a third-party integration

From Active911 Documentation Wiki
Jump to: navigation, search

Obtain an Integration Code

The first step in adding a third party integration is to obtain an integration code from the third-party you are adding the integration for:

Emergency Reporting

Go here to fill out a form Emergency Reporting needs to generate the code for your department. They will generate the code and give it to you.

Add the integration to Active911

Once you have obtained an integration code, go to the Agency tab of the web console and scroll to the bottom to find the Integrations section:

Integration add button.PNG

Click on the Add button to add a new third-party integration:

Integration dialog.PNG

In the dialog box, select the "Service" dropdown and choose the corresponding third-party as the service, and enter your integration code in the "CAD CODE" field that will appear:

Integration dialog example.PNG

Click Add, and check the Integrations section to verify that the integration has successfully been added to your agency:

Integration table.PNG

You can edit the code directly from the Agency tab by clicking on the text box containing the code, or delete it by clicking on the "X" button next to the corresponding integration to be deleted.

What to expect after adding the integration

Emergency Reporting

For every alert by default we are sending Narrative & Location data to ER if it is available. In your ER console, Active911 Alerts should start appearing and to verify that they match, check to see that the "Disp. #" in ER maps to the "Active911 #" in our system.

For the Narrative we send the alert timestamp and the normalized details text for the alert (Narrative Tab within ER).

For the Location we are sending Address, State, City, & CrossStreet if they are available (Basic Info Page 3 within ER).

Lastly, if we've setup the custom Run Report parsing for your agency there is a third set/type of data that we can forward on to ER if available. For Run Report Alerts we are sending apparatus names, event types, and datetimes (Basic Info page 4 within ER).