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

Åbn projektet, og gå til Indstillinger.
Vælg Webhooks.
Udfyld din Endpoint-URL.
Vælg de Hændelsestyper, du vil modtage.
Lad Aktiv være slået til for at starte med det samme, eller slå den fra for at gemme på pause.
Klik på Gem webhook.
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.

Rediger en webhook

Gå til Indstillinger, Webhooks.
Find webhooken under Udgående webhooks.
Klik på Detaljer.
Opdater endpoint-URL, hændelsestyper eller om den er Aktiv.
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.

Slet en webhook

Find webhooken under Udgående webhooks.
Klik på Slet.
Skriv Slet i bekræftelsesfeltet.
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

Læs den rå forespørgselsbrødtekst, før du parser den.
Beregn HMAC-SHA256 af den rå brødtekst med signeringsnøglen.
Sammenlign resultatet som `sha256=` efterfulgt af værdien med headeren `X-CxPlanner-Signature`.
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

Opdateret den: 30/10/2026

Hjalp denne artikel dig?

Tak!