Workiva kundestøttesenter

Webhooks er automatiserte meldinger som sender innhold - eller "nyttelast" - til en unik URL. Med HTTP Webhook-utløserhendelsen kan du automatisk starte en kjede når en webhook-URL mottar en HTTP POST -forespørsel med en JSON-nyttelast. Du kan deretter bruke JSON-nyttelasten som datautdata med kjedens kommandoer, for eksempel til å sette inn i et regneark.

 

Krav

• HTTP-forespørselskoblingen må konfigureres før du bruker denne utløserhendelsen.
   

Start kjeden med den utløsende hendelsen

Når du legger til utløserhendelsen i en kjede, genereres webhook-URL-en automatisk for å motta JSON-nyttelast.

1. Gå til Chain Builder, og velg kjeden du ønsker å arbeide med.
2. Søk etter Trigger Event play_for_work fra menyen til venstre, og dra kommandoen HTTP Webhookplay_for_work til Start på lerretet.
   
3. Velg noden HTTP Webhook, og klikk på Editcreate.
4. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere hendelsen.
   
5. Under Trigger Event Details velger du HTTP Request connector og CloudRunner som skal brukes med hendelsen.

6. Skriv inn bærertokenet som skal brukes til å sikre webhook-URL-en.

   Merk: Tenk på bærertokenet som et passord. Lag et token som er vanskelig å gjette, og lagre det på en sikker måte.

7. Klikk på Lagre.

Anrop webhooken med en HTTP POST-forespørsel

For at den utløsende hendelsen skal starte kjeden, må forespørselen HTTP POST inneholde:

• URL-adressen til webhooken
• Innholdstypen; for eksempel application/json; charset=UTF-8
• URL-adressens bærertoken
• Et JSON-objekt, selv om det er tomt ({})

For eksempel:

curl --location --request POST 'webhookUrl' \ --header 'Authorization: Bearer bearerToken' \ --header 'Content-Type: application/json' \ --data-raw '{}'