I webhook avvisano servizi esterni come client di chat o altre API esterne in caso di eventi. Un webhook può impostare un URL quando si verifica un evento specifico.
Phrase Orchestrator fornisce un servizio che monitora ed elabora le notifiche provenienti da sistemi di terze parti. Questo servizio consente agli utenti di connettere i propri flussi di lavoro con un'ampia varietà 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 univoco con chiave API per la configurazione 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 solo a un flusso di lavoro.
Configura webhook in arrivo
Per configurare un webhook in entrata, segui i passaggi riportati di seguito:
-
Trascina e rilascia un trigger in un flusso di lavoro.
L’attivazione viene visualizzata nel flusso di lavoro.
-
Clicca sul grilletto per aprire la scheda .
-
Seleziona la scheda .
-
Copia l'.
Questo URL deve 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 i dati da usare all'interno dei flussi di lavoro, fornisci lo schema di quel payload.
-
Per fornire uno schema, fare clic su Edit webhook.
-
Seleziona un :
Gli schemi JSON sono uno standard per la definizione dei 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 payload JSON di esempio per una configurazione più semplice, consentendo di testare il 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 dati prevista per l'attivazione 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 webhook. Per i flussi di lavoro che non hanno uno schema configurato, il corpo deve essere empty. Se viene applicato uno schema configurato, il payload deve corrispondenza allo schema.
Gli utenti possono configurare flussi di lavoro che non solo ricevono dati, ma inviano anche aggiornamenti a sistemi esterni automaticamente. L’azione webhook in uscita consente agli utenti di attivare automaticamente azioni specifiche in 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 i passaggi riportati di seguito: