Il connettore webhook universale
Chiamate autenticate a qualsiasi API, trigger in ingresso con verifica HMAC e letture in polling paginate — il connettore dietro ogni 'ci integriamo con X'.
È il connettore che rende onesto 'qualsiasi strumento'. In uscita: chiamate HTTP per record con auth basic, OAuth (refresh-e-retry automatico), API key o bearer, header personalizzati, corpi JSON o XML, una trasformazione JavaScript opzionale per record e retry con backoff esponenziale. In entrata: ogni workflow riceve un URL webhook univoco protetto da un header segreto, con verifica opzionale della firma HMAC in stile GitHub. E le letture: un connettore in polling con tre strategie di paginazione, cursori e since-timestamp incrementali che trasforma qualsiasi API in una sorgente dati pianificata.
Trigger di workflow
URL in ingresso univoco per workflow
Un POST/PUT/DELETE all'URL del workflow con l'header del codice segreto avvia il flusso.
Verifica della firma HMAC
Firme SHA-256 del corpo opzionali (header configurabile, stile GitHub o hex grezzo, confronto timing-safe) per le sorgenti che firmano le proprie chiamate.
Cattura di test in bozza
I workflow non pubblicati catturano un payload di esempio, così il designer mappa i campi su dati reali prima del go-live.
Azioni di workflow
Chiama qualsiasi API
HTTP per record con la tua modalità di auth, header personalizzati, payload JSON o XML, una trasformazione JS opzionale per record e retry con backoff su 429/5xx.
Refresh-e-retry OAuth
I token scaduti si aggiornano automaticamente sul tuo URL di refresh e la chiamata viene ritentata.
Come fluiscono i dati
Bidirezionale per costruzione: qualsiasi sistema in grado di inviare HTTP può avviare i tuoi workflow, e qualsiasi API su cui puoi autenticarti può essere scritta o interrogata — con paginazione (header Link, percorsi next-URL o parametri di pagina), cursori e since-timestamp incrementali nel formato che la tua API si aspetta.
Connessione: Credenziali di connessione memorizzate per workspace: basic auth, OAuth con URL di refresh token, API key sotto un header personalizzato o bearer token.
Esempio pratico: Uno strumento interno senza alcuna 'integrazione'
Crea una connessione webhook con il bearer token della tua API interna.
Trigger: le risposte idonee eseguono il workflow.
Azione: ogni record fa POST verso il tuo endpoint interno, rimodellato da una piccola trasformazione JS.
Una lettura pianificata interroga la stessa API ogni notte per rilevare le modifiche, paginando fino alla fine.
Template di flow pronti all'uso
Installa un template incluso e adattalo — senza partire da zero.
Configurazione
1.
Crea una connessione webhook con la modalità di auth della tua API.
2.
Per l'ingresso: copia l'URL univoco del workflow e l'header segreto nel sistema sorgente.
3.
Per le letture: configura una volta paginazione e parametro since; pianifica.
Domande frequenti
Quali modalità di auth sono supportate?
Basic auth, OAuth con refresh-e-retry automatico, API key sotto un nome di header personalizzato e bearer token.
Come sono protetti i webhook in ingresso?
L'URL di ogni workflow richiede un header con codice segreto, con in più firme HMAC-SHA256 opzionali del corpo (header configurabile, confronto timing-safe).
Può leggere le API, oltre a chiamarle?
Sì — il connettore in polling supporta paginazione via header Link, next-URL e page/pageSize, più cursori e since-timestamp incrementali, rendendo qualsiasi API una sorgente dati pianificata.