Adding a Third-Party Integration

By catharine.rhoades (Unlicensed)
5 min

General Instructions

  1. To access integration options, you will need to be logged in as an administrator for your agency.

  2. After login, open the tab labeled “Agency” and scroll to the bottom of the page.

  3. Look for the “Add New Integration” button.

  4. After clicking this button, there will be a dropdown of service options. More details are below depending on the integration service you need.

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.

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.

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.

First Arriving

Basic setup:

  1. Log in as an administrator for your agency in https://interface.active911.com

  2. Open the Agency page using the sidebar tab.

  3. You will need the agency ID from this page for later so it can save time if you write it down now.

    1. On the agency tab, there is the alert email of the agency.

    2. The alert email will be formatted like the following example: “1234-abc1234@alert.active911.com”

    3. The number before the first dash is the agency ID number used by Active911.com

      Screenshot showing agency ID

       

  4. Scroll down to the bottom of the options to find the “Add new integration” button.

  5. Select First Arriving.

  6. Please then reach out to First Arriving to ask them for further instructions. They will need the Active911 agency id number obtained in step 3.

  7. After setup, we recommend running tests to ensure information is transferred correctly between First Arriving and Active911.

API setup:

With the basic integration, most information will be transmitted to First Arriving. If you want more information on map markers, responses, and alerts we need to generate an API token.

  1. After login as admin, open a new tab in the same browser

  2. Use this URL in the new tab: https://scripts.firstarriving.com/active911/auth.php

  3. Select your agency on the page

  4. Confirm authorization

  5. Copy the API key for First Arriving and send it to them. Their email is dashboards@firstarriving.com if you do not already have a ticket with them.

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.

Related content