Centro assistenza di Workiva

I webhook sono messaggi automatici che inviano contenuti - o "payload" - a un URL unico. Con l'evento di attivazione HTTP Webhook, puoi avviare automaticamente una catena quando un URL webhook riceve una richiesta HTTP POST con un payload JSON. Puoi quindi utilizzare il payload JSON come output di dati con i comandi della catena, ad esempio per inserirlo in un foglio di calcolo.

 

Requisiti

• Il connettore HTTP Request deve essere configurato prima di utilizzare questo evento di attivazione.
   

Avvia la catena con l'evento trigger

Quando aggiungi l'evento trigger a una catena, viene generato automaticamente l'URL del webhook per ricevere i payload JSON.

1. Vai su Chain Builder e seleziona la catena con cui vuoi lavorare.
2. Cerca Trigger Event play_for_work dal menu a sinistra e trascina il comando HTTP Webhook play_for_work nella posizione Start sull'area di disegno.
   
3. Seleziona il nodo HTTP Webhook e clicca su Edit create.
4. In Informazioni di base, inserisci un nome e una descrizione unici per identificare l'evento.
   
5. In Dettagli evento, seleziona il connettore HTTP Request e CloudRunner da utilizzare per l'evento.

6. Inserisci il token del portatore da utilizzare per proteggere l'URL del webhook.

   Nota: Considera il token del portatore come una password. Crea un token difficile da indovinare e salvalo in modo sicuro.

7. Clicca su Salva.

Chiamare il webhook con una richiesta HTTP POST

Affinché l'evento scatenante avvii la catena, la richiesta HTTP POST deve includere:

• L'URL del webhook
• Il tipo di contenuto; ad esempio, application/json; charset=UTF-8
• Il token del portatore dell'URL
• Un oggetto JSON, anche se vuoto ({})

Ad esempio:

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