Skip to main content

n8n integration

N8n is a popular workflow automation tool which supports SSE as an input trigger. Since Profundis alerts are sent as SSE events, n8n can easily parse their content for further processing. We recommend that you already have a basic understanding of how n8n works before following this documentation.

warning

Some users reported that n8n was not always reconnecting in case of network disruption, which leads to the loss of alert events. To avoid this issue, we recommend that you use the Profundis alerting Docker image which automatically handles the SSE reconnections and alert buffering.

Installation​

Please refer to the official installation doc. For a quick test, you can also use the cloud version free tier.

Receive alerts in Discord​

In this paragraph, we assume that you have access to the n8n UI.

  • Create a new workflow and download this file.
  • On the right top, click on the three dots, select Import from file... and select the JSON file you just downloaded.
  • Edit the SSE trigger node located on the left and set your own API key.
  • Edit the Discord node on the right and configure your Discord webhook URL in the credentials section.
  • Run the workflow and make sure you receive alerts.

Receive alerts in Teams, Slack, Google Chat, etc​

In this section, we assume that you have access to the n8n UI.

  • Create a new workflow and download this file.
  • On the right top, click on the three dots, select Import from file... and select the JSON file you just downloaded.
  • Edit the SSE trigger node located on the left and set your own API key.
  • Remove the Discord node on the right and create a new node considering the app (Teams, Slack, etc) where you want to send the notification. Sometimes it is required to create a new credential.
  • Run the workflow and make sure you receive alerts.

Possible issues​

I don't receive alerts​

In some cases, n8n doesn't automatically reconect to the SSE stream after a network disruption. We recommend that you use the Profundis alerting Docker image which automatically handles the SSE reconnections and alert buffering.