En webhook får Penneo til at give dit eget system besked, når noget sker, for eksempel når alle underskrivere har underskrevet en forsendelse. Penneo sender med det samme en kort besked til en webadresse (URL), som du vælger. Dit system behøver ikke hele tiden at spørge Penneo om nyt.
Webhooks er til administratorer og udviklere, der forbinder Penneo Sign med et andet system, for eksempel et CRM, et ERP-system eller jeres egen software.
Har jeg brug for det? Hvis du kun sender dokumenter til underskrift i Penneo, bruger du ikke webhooks og skal ikke gøre noget. Webhooks er kun relevante, hvis du eller en softwareleverandør har forbundet et andet system med Penneo.
Har du fået mailen "Webhook delivery failed" eller "Subscription disabled"?
Penneo sender denne mail til administratorer, når webhook-beskeder ikke har kunnet leveres til jeres system i lang tid, og webhooken derfor er slået fra.
- Find ud af, hvem der har sat den op. Som regel er det en integration fra en anden softwareleverandør eller jeres egen IT-afdeling. Videresend mailen til dem.
- Ret adressen. Det system, der modtager beskederne, skal være online og kunne nås fra internettet.
- Slå webhooken til igen. En administrator kan gøre det under Konfigurer → Webhooks, eller jeres udvikler kan gøre det via API'et.
Indtil den er slået til igen, får jeres andet system ikke besked om nye underskrifter. Penneo Sign virker som normalt.
Opsæt en webhook i Penneo (administratorer)
- Gå til Konfigurer → Webhooks.
- Klik på Opret abonnement.
- Indtast i URL den HTTPS-adresse, hvor jeres system modtager beskederne.
- Sæt under Event typer flueben ved de events, du vil have (se listen nedenfor). Du kan søge eller vælge en hel gruppe som CASEFILE eller SIGNER.
- Klik på Opret abonnement for at gemme.
Klik på Send test-event på siden Webhooks for at teste opsætningen, når du har et abonnement. På samme side kan du se, redigere og slå abonnementer fra og se leveringsloggen for de seneste 30 dage: hvilke beskeder der blev leveret, hvilke der fejlede, og hvorfor.
Inden du går i gang:
- Adressen skal kunne nås fra internettet. Adresser på din egen computer eller jeres interne netværk (som localhost) virker ikke.
- Test først med et gratis værktøj som Webhook.site, og abonner på test-eventet
webhook.subscription.test.
Kan du ikke se Webhooks under Konfigurer? Kun administratorer kan administrere webhooks. Andre brugere får en besked om, at de ikke har adgang til siden. Bed en administrator i jeres virksomhed om at sætte det op eller give dig administratorrettigheder.
Opsæt en webhook via API'et (udviklere)
Opret et abonnement med et POST-kald:
POST https://app.penneo.com/webhook/api/v1/subscriptions
{
"eventTypes": ["sign.casefile.completed", "sign.signer.signed"],
"endpoint": "https://example.com/webhook"
}
Du kan bruge alle Penneos understøttede måder at logge ind på API'et. Svaret indeholder en secret, som du bruger til at tjekke, at beskederne virkelig kommer fra Penneo. Opbevar den sikkert.
Du kan også liste, opdatere, slette og teste abonnementer via API'et. Fuld reference, eksempler og en Postman-samling: Webhooks på developer.penneo.com og Postman collection for Penneo Webhooks. Se Generating OAuth 2.0 Client Credentials for at logge ind på API'et.
Du kan have op til 5 aktive abonnementer pr. konto. Har du brug for flere? Kontakt support.
Events, du kan abonnere på
Et abonnement kan omfatte flere events. Beskederne dækker alle forsendelser på jeres konto, også dem dine kolleger har oprettet.
Events for forsendelser
| Event | Hvornår den sendes |
|---|---|
sign.casefile.completed |
Alle har underskrevet, og de underskrevne dokumenter er klar til download. |
sign.casefile.expired |
Forsendelsen udløb, før alle havde underskrevet. |
sign.casefile.rejected |
En eller flere underskrivere har afvist anmodningen om underskrift. |
sign.casefile.failed |
Noget gik galt hos Penneo. Kontakt support. |
Events for underskrivere
| Event | Hvornår den sendes |
|---|---|
sign.signer.requestActivated |
Underskriveren kan underskrive nu: forsendelsen er aktiveret, eller det er deres tur. |
sign.signer.requestSent |
Den første mail med anmodning om underskrift er sendt. |
sign.signer.reminderSent |
En påmindelse er sendt. |
sign.signer.requestOpened |
Underskriveren har åbnet mailen med anmodningen om underskrift. |
sign.signer.opened |
Underskriveren har åbnet underskriftssiden. |
sign.signer.signed |
Underskriveren har underskrevet. |
sign.signer.rejected |
Underskriveren har afvist anmodningen om underskrift. |
sign.signer.finalized |
Den forsendelse, underskriveren hører til, er færdiggjort. |
sign.signer.deleted |
Underskriveren er fjernet fra forsendelsen. |
sign.signer.undeliverable |
Penneo kan ikke sende mails til underskriveren. Tjek deres e-mailadresse. |
sign.signer.transientBounce |
En mail til underskriveren blev midlertidigt afvist. |
sign.signer.signedWithImageUploadAndNAP |
Underskriveren har underskrevet med billedupload og NAP (kun hvis jeres underskriftsflow bruger det). |
Test-event
| Event | Hvornår den sendes |
|---|---|
webhook.subscription.test |
Når du udløser en test, for at tjekke at jeres adresse modtager beskeder. |
Nogle events for underskrivere, som requestSent, opened og signed, kan komme mere end én gang, hvis en underskriver underskriver i flere runder.
Indholdet i en besked
Beskederne er korte med vilje. De fortæller, hvad der skete, og id'et på forsendelsen eller underskriveren, for eksempel:
{
"topic": "casefile",
"eventType": "completed",
"eventTime": { "date": "2026-01-01 12:59:59.000000", "timezone_type": 3, "timezone": "UTC" },
"payload": { "id": <forsendelsens id>, "status": <statuskode> }
}
Brug id'et til at hente forsendelsen via API'et, hvis du vil have flere detaljer, for eksempel underskriverne eller de underskrevne dokumenter. API-brugeren skal have adgang til forsendelser, som kolleger har oprettet, for at kunne læse dem.
Gør jeres adresse stabil
- Svar hurtigt. Jeres system skal acceptere forbindelsen inden for 500 ms og svare inden for 1,5 sekund. Gem beskeden, svar med en 2xx-status med det samme, og gør arbejdet bagefter.
- Kun 2xx tæller som leveret. Alle andre svar, eller intet svar, får Penneo til at prøve igen.
-
Regn med dubletter. Hver besked har en unik
X-Event-Id-header. Gem id'erne et stykke tid, og spring dem over, du allerede har behandlet. -
Tjek signaturen. Hver besked har en
X-Event-Signature-header, signeret med jeres abonnements secret (HMAC-SHA256). Vi anbefaler kraftigt at tjekke den. Se sådan verificerer du signaturen.
Når levering fejler, prøver Penneo igen 5 gange inden for det første minut eller deromkring og derefter én gang i timen i 30 timer. Virker ingen af forsøgene, slår Penneo abonnementet fra og sender en mail til den, der oprettede det, og til alle administratorer. Ret adressen, og slå derefter abonnementet til igen.
Bruger I den gamle webhook-tjeneste?
Penneos gamle webhook-tjeneste lukker 30. november 2026. Bruger jeres integration den stadig, så skift til de webhooks, der er beskrevet i denne artikel, inden da. Se migreringsguiden. I tvivl? Spørg jeres softwareleverandør eller udvikler.
Sidder du stadig fast?
Brug chatten. Vores supportteam kan hjælpe med webhooks, API'et og jeres integration.
Du kan også altid åbne chatten med chatknappen nederst til højre.