I webhook notificano servizi esterni come client di chat o altre API esterne di eventi. Un webhook può impostare un URL quando si verifica un evento specifico.
Phrase Orchestrator fornisce un servizio che monitora e elabora le notifiche da sistemi di terze parti. Questo servizio consente agli utenti di collegare i propri flussi di lavoro con una vasta gamma di sistemi esterni che supportano richieste HTTP.
Gli utenti possono creare un nuovo trigger per i webhook in entrata da eventi esterni con il sistema che genera automaticamente un URL webhook unico con chiave API per la configurazione del webhook di terze parti. L'URL webhook generato è unico e direttamente associato all'account e al flusso di lavoro dell'utente, il che significa che ogni webhook è legato a un solo flusso di lavoro.
Configura webhook in entrata
Per configurare un webhook in entrata, segui questi passaggi:
-
Trascina e rilascia un trigger in un flusso di lavoro.
Il trigger appare nel flusso di lavoro.
-
Clicca sul grilletto per aprire la scheda .
-
Seleziona la scheda .
-
Copia l'.
Questo URL deve essere considerato segreto e non deve essere condiviso. Se condivisa accidentalmente, fare clic su Regenerate per crearne una nuova e invalidare quella esistente.
-
Per inviare un payload con dati da utilizzare all'interno dei flussi di lavoro, fornire lo schema di quel payload.
-
Per fornire uno schema, fare clic su Edit webhook.
-
Seleziona un :
Schema JSON sono uno standard per definire payload JSON. Se un servizio esistente che li utilizza, o un servizio esterno per connettersi a Orchestrator, ne fornisce uno, copialo così com'è.
-
JSON
Fornisci un esempio di payload JSON per una configurazione più semplice, consentendo il test del webhook senza definire regole esatte.
-
JSON Schema
Definisci con precisione la struttura, i tipi di dati e le regole di validazione per i dati JSON.
-
-
Fai clic su Save payload schema.
Un'anteprima della struttura dei dati prevista per il trigger del webhook viene visualizzata.
-
-
Se necessario, aprire la scheda per aggiungere filtri all'attivazione.
-
Per attivare un flusso di lavoro una volta pubblicato, invia una richiesta POST all'URL del webhook. Per i flussi di lavoro che non hanno uno schema configurato, il corpo deve essere vuoto. Se uno schema configurato è applicato, il payload deve corrispondere allo schema.
Gli utenti possono configurare flussi di lavoro che non solo ricevono dati, ma inviano anche aggiornamenti ai sistemi esterni automaticamente. L'azione del webhook in uscita consente agli utenti di attivare automaticamente azioni specifiche nei sistemi esterni.
I webhook in altri servizi possono essere attivati tramite l'azione Invia richiesta HTTP.
Configura un webhook in uscita
Per configurare un webhook in uscita, segui questi passaggi: