> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Konfigurer udgående webhooks på et projekt

## Overblik: udgående webhooks
**Webhooks** under **Projekt indstillinger** sender underskrevne HTTPS POST-beskeder til dit endpoint, når de valgte projekthændelser sker. Det bruges til at forbinde CxPlanner med automationsplatforme, sagsstyring, overvågning eller jeres eget system.

* Din rolle skal være projekt-**Administrator**.
* Du finder menuen under **Projekt indstillinger**, **Webhooks**.
* Det ændrer eksterne leveringer, revisionsloggen og leveringshistorikken for projektet.

|| Kun brugere med projektrollen Administrator kan administrere webhooks, og firmaet skal have Enterprise-funktionen slået til.

Tilgængelige hændelsestyper: **Opgave tildelt**, **Opgave oprettet**, **Opgave opdateret**, **Tjekliste brugergruppe tildelt**, **Tjekliste signeret**.
## Sådan konfigurerer du udgående webhooks
### Opret en webhook
1. Åbn projektet, og gå til **Indstillinger**.
2. Vælg **Webhooks**.
3. Udfyld din **Endpoint-URL**.
4. Vælg de **Hændelsestyper**, du vil modtage.
5. Lad **Aktiv** være slået til for at starte med det samme, eller slå den fra for at gemme på pause.
6. Klik på **Gem webhook**.
7. Kopiér signeringsnøglen, når du ser **Kopiér denne signeringsnøgle nu. Du vil ikke se den igen.**

||| Signeringsnøglen vises kun én gang. Gem den sikkert, før du forlader siden.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_13uvroc.png)

### Rediger en webhook
1. Gå til **Indstillinger**, **Webhooks**.
2. Find webhooken under **Udgående webhooks**.
3. Klik på **Detaljer**.
4. Opdater endpoint-URL, hændelsestyper eller om den er **Aktiv**.
5. Klik på **Gem webhook**.

Signeringsnøglen vises ikke igen, mens du redigerer. For at få en ny nøgle skal du slette webhooken og oprette en ny.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_131y8pl.png)


### Slet en webhook
1. Find webhooken under **Udgående webhooks**.
2. Klik på **Slet**.
3. Skriv **Slet** i bekræftelsesfeltet.
4. Klik på **Slet** for at bekræfte.

||| Sletning er permanent. Leveringshistorikken for webhooken fjernes også.

## Resultat: udgående webhooks
| Handling | Hvem kan gøre det |
| ---- | ---- |
| Slå Enterprise-funktionen til for et firma | CxPlanner-administrator |
| Oprette, redigere eller slette webhooks | Projektrolle **Administrator** |
| Sende testleveringer | Projektrolle **Administrator** |
| Se leveringshistorik | Projektrolle **Administrator** |
Hvis fanen **Webhooks** mangler, eller den viser, at webhooks ikke er slået til for firmaet, så kontakt din CxPlanner-administrator eller CxPlanner Support for at få Enterprise-funktionen slået til.

### Krav til endpoint-URL
| Krav | Beskrivelse |
| ---- | ---- |
| HTTPS | Endpoints skal bruge HTTPS. HTTP understøttes ikke. |
| Blokerede domæner | Domæner, der tilhører cxplanner.com, er ikke tilladt. |
| Offentlig adgang | Endpoints skal kunne nås fra internettet. |

### HTTP-headere i hver levering
| Header | Værdi |
| ---- | ---- |
| Content-Type | application/json |
| X-CxPlanner-Signature | sha256=HMAC-SHA256 af brødteksten |
| X-CxPlanner-Event | Hændelsestype, for eksempel **Opgave tildelt** |
| X-CxPlanner-Delivery | Entydigt leverings-id |

### Beskedens opbygning
Alle webhook-hændelser bruger den samme JSON-konvolut. Objektet \`data\` indeholder de felter, der hører til den enkelte hændelse.

### Verificer signaturen
1. Læs den rå forespørgselsbrødtekst, før du parser den.
2. Beregn HMAC-SHA256 af den rå brødtekst med signeringsnøglen.
3. Sammenlign resultatet som \`sha256=\` efterfulgt af værdien med headeren \`X-CxPlanner-Signature\`.
4. Afvis forespørgslen, hvis signaturerne ikke matcher.

||| Beregn altid signaturen på den rå forespørgselsbrødtekst. Hvis du parser JSON og serialiserer den igen, kan formateringen ændre sig, og verificeringen fejler.

### Politik for nye forsøg
| Forsøg | Ventetid før næste forsøg |
| ---- | ---- |
| 1 | Første levering |
| 2 | Omkring 5 sekunder |
| 3 | Omkring 30 sekunder |
| 4 | Omkring 2 minutter |
| 5 | Omkring 10 minutter |
| 6 | Omkring 30 minutter |
| 7 | Omkring 2 timer |
| 8 | Omkring 6 timer |
| 9 | Omkring 12 timer |

### Automatisk deaktivering og opbevaring af historik
Hvis et endpoint fejler 5 leveringer i træk, slår CxPlanner webhooken fra og skriver det i projektets revisionslog. Når endpointet er rettet, kan en projekt-**Administrator** åbne **Detaljer**, sætte flueben ved **Aktiv** og klikke på **Gem webhook**.
| Type | Opbevaring |
| ---- | ---- |
| Leveringer, der vises i grænsefladen | Op til 50 seneste leveringer pr. webhook |
| Leveringer, der lykkes | 30 dage |
| Leveringer, der fejler | 90 dage |

## Fejlfinding: udgående webhooks
| Problem | Årsag | Løsning |
| ---- | ---- | ---- |
| Fanen **Webhooks** siger, at funktionen ikke er slået til | Enterprise-funktionen er ikke slået til | Bed din CxPlanner-administrator eller CxPlanner Support om at slå Enterprise-funktionen til for firmaet |
| Kan ikke se fanen **Webhooks** | Projektrollen er under **Administrator** | Bed en projekt-**Administrator** om at hæve din rolle, eller om at administrere webhooks for dig |
| Signeringsnøglen er væk | Nøglen vises kun én gang ved oprettelse | Slet webhooken, opret en ny, kopiér den nye nøgle, og opdater dit endpoint |
| Endpointet modtager gentagne leveringer | Endpointet svarer ikke med et HTTP-svar i 2xx | Ret endpointet, så det svarer 2xx, og bekræft med **Send test** |
| Webhooken blev slået fra automatisk | Endpointet fejlede 5 leveringer i træk | Ret endpointet, slå **Aktiv** til under **Detaljer**, og gem |
| Verificering af signaturen fejler | HMAC er beregnet på parset JSON, eller nøglen er forkert | Beregn HMAC på den rå brødtekst med den aktuelle signeringsnøgle |
| **Send test** viser en levering, men endpointet fik intet | Endpointet kan ikke nås offentligt over HTTPS | Bekræft offentlig HTTPS-adgang, og tjek leveringsstatus i historikken |
| Leveringer er markeret som fejlet | Endpointet kan ikke nås, eller det returnerer fejl | Ret endpointet, vent på næste forsøg, eller brug **Send test** |
| En tidligere levering skal sendes igen | Manuelle gentagelser understøttes ikke | Brug **Send test** til at lave en ny testlevering |