Denne funktion kræver Shipmondo Pro. Se listen over funktioner.
Hvis I ønsker at få information vedrørende dine forsendelser, ordrer og kladder sendt løbende til jeres eget system, kan I oprette webhooks for at få mulighed for dette.
For at oprette et webhook skal I følge disse to trin.
1. Opret et slutpunkt
For at kunne modtage beskeder fra webhooks skal I have oprettet et slutpunkt i jeres IT system, som beskeden kan sendes til fra Shipmondo.
Der er nogle krav til det slutpunkt, der opsættes for at modtage beskederne:
Slutpunktet skal anvende HTTPS og skal derfor have et gyldigt SSL/TLS certifikat
Slutpunktet skal kunne modtage JSON data
Slutpunktet skal kunne dekryptere JWT data, som er enkrypteret med HS256 algoritmen, ved brug af en selvvalgt nøgle
Slutpunktet skal kunne modtage beskeden og returnere et svar med status kode 200 indenfor 5 sekunder
Kravene til slutpunktet er beskrevet i flere detaljer i denne artikel.
NB! Slutpunktet kan anvendes til at modtage beskeder fra flere webhooks, og det vil derfor ikke være påkrævet at oprette et nyt slutpunkt for hvert webhook.
2. Opret et webhook i Shipmondo
Når der er oprettet et slutpunkt, som kan modtage beskederne fra webhooket, kan I oprette jeres webhook i Shipmondo.
For at gøre dette skal I gå til Indstillinger > Integration > Webhook og klikke på Plus-knappen (+) nederst til højre.
Udfyld felterne som følger:
Navn: et navn I kan bruge til at identificere jeres webhook i oversigten
Slutpunkt: URL adressen til det slutpunkt I har oprettet i trin 1
Nøgle: nøglen der skal anvendes til at enkryptere og dekryptere webhook beskederne med JWT
Ressource: den ressource I ønsker, at beskederne indeholder information om
Handling: den handling I ønsker skal udløse webhook beskeden
Sæt flueben i Aktiv. Klik på Opret.
Jeres webhook er nu sat op, og I vil begynde at modtage beskeder på jeres slutpunkt, når den valgte handling foretages.
Læs mere om hvordan beskederne fra vores webhooks er opbygget her.