Emergency Reporting

Emergency Reporting integration is performed using a CAD Alert Web Hook; when an incident is updated, the Web Hook receives the information about the incident and makes a decision to create a report based on the clear times of your department's units as well as the existence of another report with the same "Dispatch Run Number".

Setup

Under Web Hooks in CAD Alert, you'll see a list of your existing Web Hooks. To enable the Emergency Reporting integration, there will need to be one with the following URL:

  • https://cadalerthooks.com/emergencyreporting/YOUR_DEPARTMENT_CODE/cad-hook?secret=YOUR_DEPARTMENT_SECRET

Here, "YOUR_DEPARTMENT_CODE" refers to the department code that you use to access CAD Alert (for example, YOUR_DEPARTMENT_CODE.cadalert.com), and "YOUR_DEPARTMENT_SECRET" is the secret token that was initially present on the Web Hook when the Emergency Reporting integration was first set up. If you accidentally delete the Web Hook or your secret was compromised, you can always contact us to recreate it.

When "enabled", new reports will be created for each cleared incident. When disabled, no new reports will be created.

Administration and Troubleshooting

From time to time, the dispatch system will make a mistake (perhaps they don't send a clear time for all of your units) or Emergency Reporting will make a mistake (sometimes it will create duplicate exposures that are difficult to delete). When this happens, you'll want to use the administrative UI for the hook.

You can access the UI at the following URL:

  • https://cadalerthooks.com/emergencyreporting/YOUR_DEPARTMENT_CODE/ui/

You'll need to sign in either with your CAD Alert account credentials, or with the administrative username and password that you were given when Emergency Reporting integration was set up.

There are two main actions:

  • Create report
  • Fix duplicates

"Create report"

This allows you to force report creation for a recent (within the past 7 days) incident.

Required inputs:

  • Incident number; this is the incident number. It can be the full incident number or an abbreviated version.

Options:

  • Pretend; enable this to only "pretend" to create the report. No report will actually be created.
  • Exact ID; when specified, the incident number is not parsed; instead, it is passed directly to CAD Alert. This can be helpful if an EMS and fire call have the same incident number.
  • Ignore "not cleared" errors; when specified, the report will be created even if all of your department's units do not have a clear time yet.
  • Ignore "scratch" errors; when specified, the report will be created even if none of your department's units had en-route or arrival times.
  • Override incident number; this creates a report with the given incident number. This is helpful for testing report creation and verifying that all settings are correct without having to wait for a new incident to occur.

To execute the action, click on "Make it happen". Afterward, the result of the action will be printed below it.

"Fix duplicates"

This allows you to delete any duplicate exposures in Emergency Reporting.

Required inputs:

  • Incident number; this is the incident number. It can be the full incident number or an abbreviated version.
  • What exposure do you want to keep?; set this to the exposure that you want to keep (where "1" is the first one, "2" is the second one, and so on). Usually when there's a duplicate, you keep the first one and delete the rest. However, if someone already started filling in a different one, you can specify that you want to keep that one and delete the others.

Options:

  • Pretend; enable this to only "pretend" to fix the duplicate exposures. No duplicate exposures will actually be deleted.

To execute the action, click on "Make it happen". Afterward, the result of the action will be printed below it.