Send alarms with content using webhooks and header attachments

How to use webhooks with header attachments to interact with evalink talos in a more sophisticated way.

As we mentioned in the previous page, a webhook is a mechanism whereby an entity on the web (e.g. a client) can notify another entity on the web (e.g. a server) when a new event that might be of interest to the other side has just occurred.

evalink talos allows you to create and send more sophisticated webhooks to interact with the platform.

The Webhooks integration allows users to configure their webhook URLs further and transmit content to evalink talos via attachment headers. The type of the header can be a URL, an image, a widget etc.

The structure of such a webhook is displayed below:

https://talos.evalink.io/api/webhook-integration/incoming/<webhookId>?header=attachment.<type>:<content>

https://talos.evalink.io/api/webhook-integration/incoming/<webhookId> is the URL/endpoint for a particular webhook, generated by evalink talos, as it is displayed here.

<type> is one of the following options:

• URL

• image

• message

• verification

<content> is the relevant content for each type, e.g. the desired URL or message for the operator.

Please refer to the examples displayed below for more details.

Example 1 - Webhook with URL in its attachment header

https://talos-app.io/api/webhook-integration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.url:https://evalink.io

The above webhook, when invoked, will generate an alarm with the website evalink.io, as displayed in the picture below.

Example 2 - Webhook with an image in its attachment header

https://talos-app.io/api/webhook-ntegration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.image:http://166.254.49.241:80/mjpg/video.mjpg

Example 3 - Webhook with a message in its attachment headers

https://talos-app.io/api/webhook-integration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.message:BuildingA-SectorB

Example 4 - Webhook with multiple URLs in its attachment headers

https://talos-app.io/api/webhook-integration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.url.1:https://evalink.io&
header=attachment.url.2:https://evalinklive.com

The above webhook, when invoked, will generate an alarm with the websites evalink.io and evalinklive.com, as displayed in the picture below.

Example 5 - Webhook with multiple images in its attachment headers

https://talos-app.io/api/webhook-integration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.image.1:http://166.254.49.241:80/mjpg/video.mjpg&
header=attachment.image.2:http://108.182.4.138:9000/mjpg/video.mjpg

Example 6 - Webhook with multiple messages in its attachment headers

https://talos-app.io/api/webhook-integration/incoming/aB08421vOvbVCDlka3OHxOulD?
header=attachment.message.1:emergency&
header=attachment.message.2:buildingA

The above webhook, when invoked, will generate an alarm with the websites evalink.io and evalinklive.com, as displayed in the picture below.

It is important to note that evalink talos de-duplicates the supplied resources.

This means that, for example, when you supply the same stream twice, it will show-up only once in the incoming alarm.