Skip to main content
Use the webhook channel of a Wormly contact to send host failure and recovery notifications to Flashduty On-call. Each Wormly host maps to one Flashduty alert: the alert triggers when the host fails, repeated notifications sent at each escalation level of the alert group merge into the same alert, and the alert recovers when the host is up again.

​
In Flashduty On-call

You can get the integration push URL in either of the following ways.

​
Use a dedicated integration

  1. In the Flashduty console, go to Channels and open a channel
  2. Select Configuration → Integrations → Private integration, then click Add an integration
  3. Select Wormly and click Save
  4. Open the new integration card and copy the push URL

​
Use a shared integration

  1. In the Flashduty console, go to Integration Center → Alert Events
  2. Select Wormly and enter an integration name
  3. Configure the default route and select a channel. You can add more rules under Routes after creation
  4. Click Save and copy the generated push URL

​
In Wormly

1

Create a webhook contact

  1. Sign in to Wormly, go to Contacts, and click Create New Contact
  2. Choose the Webhook channel
  3. Paste the full Flashduty push URL into the URL field
  4. Choose a JSON webhook type (JSON or JSON - multipart/form encoding; Flashduty parses both). Do not choose XML or Serialized PHP
  5. Save
2

Add the contact to an alert group

In Alert Groups, edit the group used by the hosts you want to send, and add the new contact to the relevant escalation levels. One alert group can be used by several hosts.
3

Verify the lifecycle

Make a monitored host fail (for example, temporarily point the monitor at a closed port) and confirm Flashduty receives an active alert. Then restore the target and confirm the alert recovers.
Wormly requires the receiving endpoint to be on a different server than the one being monitored, and times out after 5 seconds. The Flashduty push URL meets both requirements.

​
Payload

Wormly sends one JSON object per notification. Flashduty parses it directly, with no template to configure: The alert title is the host name, or Wormly host <hostid> when the name is empty. The request can be a JSON body, or a urlencoded or multipart form that carries the JSON in the wormlyalert field.

​
Alert Key

Flashduty uses hostid as the Alert Key. Wormly documents it as the unique ID of the host that triggered the alert. Failure, repeated escalation, and recovery notifications for one host carry the same hostid, so they land on the same alert. Different hosts produce different alerts even when they share a name. Changing the host name, escalation level, or sensors does not change the Alert Key. If hostid is missing, Flashduty returns a parameter error because a recovery could not be matched to its alert.

​
Status and severity

Wormly notifications carry no severity. alertlevel is an escalation step, not a severity, so Flashduty treats every failure as Critical. Requests whose isrecovery is missing or is neither 0 nor 1 are rejected, so a request of unknown state never enters the wrong alert lifecycle.

​
FAQ

No. While a host stays down, each notification sent at an escalation level carries the same hostid and merges into one alert. When several sensors of one host fail together, Wormly lists them in a single notification and Flashduty still creates one alert.
The contact form’s Send Test button always posts a trigger notification with a sample hostid (5112), so it opens an alert keyed on 5112. No recovery notification follows a test, so close that alert manually in Flashduty. An empty JSON object with none of the known fields is acknowledged without creating an alert.
No. Flashduty only parses the JSON format. Choose a JSON webhook type in Wormly.

​
Troubleshooting

  • Wormly reports a failed push: confirm the URL is the full push URL and includes integration_key
  • Flashduty returns a parameter error: confirm the webhook type is JSON and that hostid and isrecovery are present in the request
  • The alert does not recover: confirm the recovery notification goes to the same contact. Wormly notifies every recipient that received a failure notice when the host recovers
For field details, see the Wormly documentation Webhook / HTTP Alert Channel.