# Een event-trigger maken

> Maak een event-trigger, zodat een extern event zoals een alert of een script een agent-run start met het event erbij.

- Type: Handleiding
- Voorwaarden: Een project dat volledig is uitgerold, Een systeem dat een HTTP-verzoek kan sturen
- Gerelateerd: [Run hooks API](https://platform.dxvagentic.com/docs/nl/developers/run-hooks-api.md), [Agents als API](https://platform.dxvagentic.com/docs/nl/developers/generic-agents.md), [Een automatisering maken](https://platform.dxvagentic.com/docs/nl/automations/recurring-automations.md)
- Laatst bijgewerkt: 2026-10-19
- URL: https://platform.dxvagentic.com/docs/nl/developers/event-triggers

Een event-trigger start een agent-run vanuit een extern event. Richt een webhook, zoals een Sentry-alertregel, een GitHub Action of elk script, op de trigger-URL. De gekozen agent pakt het op met de event-payload erbij.

**Voordat je begint**

- Nodig: Een project en een agent die de run uitvoert
- Duur: Ongeveer 5 minuten

### 1. Open het tabblad Event-triggers

Kies **Automatiseringen** in het menu en open het tabblad **Event-triggers**. Je kunt ook het tabblad **Automatiseringen** van een project openen.

### 2. Maak de trigger

Klik op **Nieuwe event-trigger**. Vul een **Naam** in, bijvoorbeeld "Sentry foutpercentage-alert". Beschrijf bij **Instructies** wat de agent moet doen als de trigger afgaat. Kies de **Agent** en het **Project**. Stel de **Afkoelperiode (seconden)** in: nadat een run start, worden verdere events zo lang genegeerd. De standaard is 300 seconden. Sla de trigger op. Hij toont nu een **URL** en een **Secret**.

### 3. Stuur een event

Stuur een POST met een JSON-body naar de URL. Zet het secret in een `Authorization: Bearer`-header.

```bash
curl -X POST "$TRIGGER_URL" \
  -H "Authorization: Bearer $TRIGGER_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"alert": "foutpercentage boven 5%"}'
```

Het antwoord is 202 met `featureRequestId`. De run verschijnt onder **Recente uitvoeringen** van de trigger. De payload wordt als JSON aan je instructies toegevoegd, afgekapt na 8 KB.

## Overgeslagen events

Start een trigger geen run, dan is het antwoord 200 met een veld `skipped`: `inactive` voor een gepauzeerde trigger, `in_flight` zolang er nog een run actief is en `cooldown` tijdens de afkoelperiode. Het volledige contract, inclusief de `X-DXV-Event-Key`-header die dit per sleutel afbakent, staat in [Run hooks API](https://platform.dxvagentic.com/docs/nl/developers/run-hooks-api.md).

## Een trigger beheren

Je kunt een trigger **Pauzeren** en **Hervatten**. Met **Secret vernieuwen** werkt het oude secret direct niet meer. De URL blijft hetzelfde, dus pas het secret alleen aan waar je de events vandaan stuurt. Alleen als je de trigger verwijdert, werkt zijn URL niet meer. Bestaande verzoeken blijven zoals ze zijn.

> **Stuur het secret in een header**
>
> Zet het secret niet in een `?token=`-querystring. Die komt in logs en proxies terecht.