> For the complete documentation index, see [llms.txt](https://docs.artific.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artific.nl/voor-beheerders/organisatie/meldingskanalen.md).

# Meldingskanalen

De gebeurtenissen van runs naar andere systemen sturen. Te vinden onder **Organisatiebeheer → Meldingskanalen**.

## Waar ze voor zijn

Een [trigger](https://docs.artific.nl/voor-beheerders/assistenten/triggers.md) kan mensen een e-mail sturen als een run start, klaar is, mislukt of aandacht nodig heeft. Een meldingskanaal doet hetzelfde voor systemen: het is een uitgaande webhook die de run-gebeurtenissen ontvangt van de triggers die hem gebruiken.

Zo kan een run ergens anders iets in gang zetten, zoals een ticket in je eigen systeem of een volgende stap in een workflowtool.

Deze pagina is technisch. Ben jij niet degene die de ontvangende kant bouwt, geef hem dan door aan wie dat wel doet.

## Een webhook toevoegen

Kies **Webhook toevoegen**.

| Veld                           | Wat je invult                                                                                                                                                                            |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**                       | Waar de webhook voor is, zodat je hem herkent als je hem bij een trigger kiest.                                                                                                          |
| **Endpoint-URL**               | Waar de gebeurtenissen naartoe gaan. Het moet een openbaar https-adres zijn; privé- en interne adressen worden geweigerd.                                                                |
| **Ondertekeningssecret**       | Het secret waarmee elke levering wordt ondertekend. Kies een van je [geheime sleutels](https://docs.artific.nl/voor-beheerders/tools/geheime-sleutels.md) of **Nieuw secret genereren**. |
| **Run-gebeurtenissen leveren** | Zet leveringen aan of uit zonder de webhook te verwijderen.                                                                                                                              |

Elke levering bevat een `X-Artific-Signature`-header: een HMAC-SHA256 van de timestamp, een punt en de body, met het ondertekeningssecret als sleutel. Het ontvangende systeem controleert die, om zeker te weten dat de gebeurtenis echt van je organisatie komt en ongewijzigd is aangekomen.

## Een webhook aan een trigger koppelen

Een webhook ontvangt alleen gebeurtenissen van triggers die hem gebruiken. Zet bij de trigger, onder **Webhooks**, de webhooks aan die zijn gebeurtenissen moeten krijgen. Eén webhook kan meerdere triggers bedienen.

## Controleren of het werkt

De lijst toont per webhook de **Status** en de **Laatste levering**. **Test versturen** stuurt een testgebeurtenis, zodat je de ontvangende kant kunt controleren voordat een echte run ervan afhangt.

Mislukken er meerdere leveringen op rij, dan wordt de webhook gemarkeerd als mislukt, met de reden erbij, en wordt er niets meer naartoe gestuurd tot hij is hersteld. Herstel de ontvangende kant en kies daarna **Test versturen**. Bij een trigger staat een mislukte webhook ook als zodanig aangegeven, zodat duidelijk is waarom zijn gebeurtenissen niet aankomen.

## Een webhook verwijderen

**Verwijderen** haalt de webhook weg. Triggers kunnen er dan geen gebeurtenissen meer naartoe sturen.

{% hint style="warning" %}
Kijk welke triggers een webhook gebruiken voordat je hem verwijdert. Hun e-mailnotificaties blijven werken, maar een proces dat op de webhook leunde, krijgt niets meer binnen.
{% endhint %}
