I webhook notificano servizi esterni come client di chat o altre API esterne riguardo agli 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 le richieste HTTP.
Gli utenti possono creare un nuovo trigger per i webhook in arrivo 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 arrivo
Per configurare un webhook in arrivo, 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 dovrebbe essere considerato segreto e non condiviso. Se condivisa accidentalmente, fare clic su Regenerate per crearne una nuova e invalidare quella esistente.
-
Per inviare un payload con dati da usare nei flussi di lavoro, fornisci lo schema di quel payload.
-
Per fornire uno schema, fare clic su Edit webhook.
-
Seleziona un :
JSON Schemas sono uno standard per definire i payload JSON. Se un servizio esistente che li usa, 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 convalida per i dati JSON.
-
-
Fai clic su Save payload schema.
Viene visualizzata un'anteprima della struttura dei dati prevista per il trigger del webhook.
-
-
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 viene applicato uno schema configurato, 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 in modo automatico. 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 Send HTTP Request.
Configura un webhook in uscita
Per configurare un webhook in uscita, segui questi passaggi: