Webhooks zijn geautomatiseerde berichten die inhoud - of "payloads" - naar een unieke URL sturen. Met de HTTP Webhook trigger gebeurtenis kunt u automatisch een keten starten wanneer een webhook URL een HTTP POST verzoek ontvangt met een JSON payload. U kunt de JSON payload dan gebruiken als Data-uitvoer met de commando's van de keten, bijvoorbeeld om in een spreadsheet in te voegen.
Vereisten
- De HTTP Request connector moet worden ingesteld voordat u deze trigger-event gebruikt.
Start de keten met de triggergebeurtenis
Wanneer u het trigger-event aan een keten toevoegt, genereert het automatisch de webhook URL om JSON payloads te ontvangen.
- Ga naar Chain Builder, en selecteer de ketting waarmee u wilt werken.
- Zoek naar Trigger Event in het menu aan de linkerkant en sleep de opdracht HTTP Webhook naar de positie Start op het canvas.
- Selecteer het knooppunt HTTP Webhook en klik op maken.
- Voer onder Basisinfo een unieke naam en beschrijving in om de gebeurtenis te helpen identificeren.
- Selecteer onder Trigger Event Details de HTTP Request connector en CloudRunner om met de gebeurtenis te gebruiken.
-
Voer het token in dat gebruikt moet worden om de webhook URL te beveiligen.
Opmerking: Zie het token als een wachtwoord. Maak een token dat moeilijk te raden is, en sla het veilig op.
- Klik op Opslaan.
Roep de webhook aan met een HTTP POST-verzoek
Opdat de triggergebeurtenis de keten zou starten, moet het HTTP POST verzoek bevatten:
- De webhook URL
- Het inhoudstype; bijvoorbeeld
application/json; charset=UTF-8 - Het token van de drager van de URL
- Een JSON object, zelfs als het leeg is (
{})
Bijvoorbeeld:
curl --location --request POST 'webhookUrl' \ --header 'Authorization: Bearer bearerToken" \ --header "Content-Type: application/json" \ --data-raw "{}