Modtag webhooks, når et workflow er færdigt
Få besked i dine systemer, når en workflowkørsel afsluttes, mislykkes eller stoppes, og kontrollér signaturen på afsendelserne.
Webhooks giver dine systemer besked, når en workflowkørsel er færdig. Upsellr sender så en forespørgsel til den adresse, du vælger. De er inkluderet i abonnementet Enterprise.
Hændelserne
| Hændelse | Hvornår den udsendes |
|---|---|
| workflow.run.completed | En kørsel afsluttes med succes |
| workflow.run.failed | En kørsel mislykkes |
| workflow.run.stopped | En bruger stopper en kørsel |
Hver afsendelse indeholder den fulde repræsentation af kørslen i samme format som den offentlige API. Fanebladet Event catalogue beskriver dette format.
Tilføj et endpoint
- Åbn kontomenuen og derefter Manage og API & webhooks.
- Klik på Add endpoint under fanebladet Endpoints.
- Udfyld et Name og Endpoint URL. Kun offentlige HTTPS-adresser accepteres: private netværk og omdirigeringer blokeres.
- Sæt flueben ved Events to receive, og gem.
- Kopiér signaturhemmeligheden. Den vises kun én gang.
Et endpoint kan sættes på pause og aktiveres igen. Mister du hemmeligheden, så klik på Rotate secret, og opdatér din modtager med det samme.
Kontrollér signaturen
Hver afsendelse har to headers: X-Upsellr-Timestamp, afsendelsens tidsstempel, og X-Upsellr-Signature i formen v1= efterfulgt af et hexadecimalt fingeraftryk med små bogstaver. Fingeraftrykket er en HMAC-SHA256, beregnet med endpointets hemmelighed, på tidsstemplet, et punktum og derefter forespørgslens rå body.
Kontrollér signaturen på den rå body, før du afkoder JSON’en. Sammenlign signaturerne i konstant tid, og afvis tidsstempler, der er for gamle.
Afsendelser og nye forsøg
- Hændelserne sendes som JSON med en POST-forespørgsel. Ethvert 2xx-svar bekræfter modtagelsen.
- Ved fejl prøver Upsellr igen efter 1 minut, 5 minutter, 30 minutter, 4 timer og 24 timer.
- En hændelse kan ankomme mere end én gang, og rækkefølgen er ikke garanteret: fjern dubletter ud fra hændelsens id.
Leveringsloggen
Fanebladet Event deliveries viser afsendelserne fra de seneste 7 dage med deres status, deres forsøg og deres indhold. For en mislykket afsendelse klikker du på Replay failed delivery: den samme hændelse sendes igen med samme id.
Godt at vide
- Kun ejere og administratorer administrerer endpoints og sender afsendelser igen.
- At slette et endpoint annullerer dets ventende afsendelser. De eksisterende logge bevares.