Adding a Third-Party Integration

Owned by catharine.rhoades (Unlicensed)
Last updated: Feb 08, 2024 by Grant Wyatt
3 min read

Emergency Reporting

Obtain an Integration Code

The first step in adding the Emergency Reporting integration is to obtain an integration code from Emergency Reporting by contacting your ESO sales representative. They will generate the code and give it to you.

Emergency Reporting Options

When you are selecting to integrate with Emergency Reporting, there are two options (Emergency Reporting and Emergency Reporting (using CAD codes). If you select the original Emergency Reporting option, it will send the alert data through and enter the Active911 # as the CAD/Alert ID. If your dispatch/CAD is sending a separate CAD #, you can select the Emergency Reporting (using CAD codes) option to ensure that the alert data is imported with the CAD # as the alert ID number.

What to expect after adding the integration

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).

If This Then That

  1. Setup an account at https://ifttt.com/

  2. After you have an account setup, choose “Create”.

  3. Click on “If This”. Find and select “Webhooks”.

  4. Select “Receive a web request”.

  5. Give the event a name that is easily recognizable (EX: “Active911”) and click “create trigger”.

  6. Click on “Then That”. Find and select the service or method you would like to be notified.

  7. Complete the steps within that method.

  8. Click “Continue” and click “Finish”.

  9. Once this is all setup, you will need to find your key:

    1. Click on the head/profile icon in the top right

    2. Select “My Services”

    3. Go to “Webhooks”

    4. Click on the “Documentation button in the top right of the screen


Now setup the integration in our web console:

  1. Add new integration (the one called If This Then That)

  2. For the new integration use the following URL:

https://maker.ifttt.com/trigger/{Event_Name}/with/key/{IFTTT_Key}.

A. The {Event_Name} is the name you gave to the event in step 5 above

B. The {IFTTT_Key} is the key you found above in step 9 above.


Now if you send an alert via SMTP/SNPP you should see an event in IFTTT and it should trigger whatever action you set up for that event.

Other

If you have a URL that you would like the alert information forwarded to, by selecting "Other" you can provide that URL and name the destination in case you want to add more than one.

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:

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

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:

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

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.