Utgående webhooks (Zapier, Make, egna system)

Under Inställningar → Utgående webhooks (admin, syns bara när funktionen är aktiverad för er organisation) kan du registrera egna HTTPS-endpoints som tar emot signerade JSON-anrop (POST) när händelser sker i Novro — t.ex. enkät lanserad/påmind/stängd, åtkomstbegäran, försenade åtgärder, OKR-avstämningar och utbildningar som går ut. Det är samma händelsekatalog som chattintegrationerna använder, men i maskinläsbar form — perfekt för att koppla Novro till Zapier, Make eller ett eget system utan att behöva fråga REST-API:t i onödan.

Skapa en webhook: klicka “Ny webhook”, ange en etikett och endpoint-URL:en (endast https och publika värdar — localhost, privata IP-adresser och udda portar avvisas av säkerhetsskäl), kryssa i vilka händelser som ska skickas och spara. Du får då en signeringshemlighet som visas EN gång — kopiera den direkt och lagra den säkert. Den kan inte visas igen.

Rotera hemligheten: behöver du byta signeringshemlighet klickar du “Rotera hemlighet” (webhookens id och prenumerationer behålls — mottagaren behöver inte konfigureras om). En NY hemlighet visas en gång, precis som vid skapande. Under ett övergångsfönster på cirka 24 timmar signeras varje leverans med BÅDA hemligheterna: headern X-Novro-Signature med den nya och X-Novro-Signature-Previous med den gamla. Din mottagare kan verifiera vilken som helst av dem — uppdatera till den nya hemligheten någon gång under fönstret, sedan slutar den gamla att gälla. Rotationen loggas i granskningsloggen.

Verifiera leveranser i din mottagare: varje anrop har headern X-Novro-Signature med värdet sha256=<hex>, en HMAC-SHA256 av den råa anropskroppen beräknad med din hemlighet. Räkna ut samma HMAC på din sida och jämför (konstant tid). Kroppen är JSON med fälten id (leverans-id, samma vid varje omförsök — använd för deduplicering), event, timestamp, orgId och data. Headern X-EquiPay-Event anger händelsetypen och X-EquiPay-Delivery leverans-id:t.

Leverans, omförsök och historik: en leverans försöks först direkt. Misslyckas den (5xx eller nätverksfel) läggs den i en kö och görs om med växande fördröjning — cirka 1 min, 5 min, 30 min, sedan 2 tim. Klarar den sig inte efter fem försök “dödläggs” den (behålls som misslyckad men görs inte om). Ett 4xx-svar räknas som permanent fel och görs inte om. Klicka “Historik” på en webhook för att se de senaste leveranserna med status (levererad/i kö/dödlagd), antal försök och senaste HTTP-kod/fel — klicka “Visa fler” för äldre leveranser — och för att manuellt köa om en misslyckad eller dödlagd leverans (“Skicka igen”). Efter fem misslyckade leveransförsök i rad inaktiveras webhooken automatiskt; köade leveranser pausas då och görs om när du aktiverar den igen. Levererade och dödlagda leveranser sparas i historiken i 30 dagar och rensas därefter automatiskt — kön med väntande leveranser påverkas inte.

Säkerhet vid leverans (DNS): vid varje leverans slås mottagarens värdnamn upp och leveransen vägras om det pekar på en privat, loopback-, link-local- eller molnmetadata-adress (skydd mot DNS-rebinding). En blockerad leverans behandlas som ett misslyckande och följer samma kö/dödläggning.

Använd “Skicka test” för att verifiera endpoint och signatur med en test.message-händelse. Panelen visar senaste leveransstatus (tidpunkt, HTTP-kod, fel) per webhook.

Viktigt om innehållet: nyttolasten innehåller bara händelsemetadata (titlar, antal, datum, statusar) — aldrig löner, enkätsvar eller rådata om anställda, och deltagarantal under anonymitetströskeln skickas aldrig. “Ta bort” stänger av webhooken omedelbart efter en bekräftelse.