osFoundry / Platform
Webhook in uscita
Diffondi gli eventi della piattaforma verso i tuoi endpoint. Retry automatici, verifica della firma.
Che cos’è
I webhook in uscita permettono a osFoundry di inviare eventi verso endpoint che controlli tu. Invece di interrogare continuamente la piattaforma per rilevare i cambiamenti, registri una URL e osFoundry le manda una richiesta HTTP ogni volta che nel tuo spazio di lavoro si verifica un evento rilevante. In questo modo l'attività nelle tue aree di chat, agenti, app, codice, conoscenza e dati diventa un segnale su cui i tuoi sistemi possono agire, senza dover cablare un'integrazione su misura per ciascuna.
Dentro osFoundry i webhook si trovano sotto Impostazioni e sicurezza, perché attraversano un confine di fiducia: portano gli eventi dello spazio di lavoro verso un ricevitore che è tuo. Ogni consegna è firmata, così il tuo endpoint può verificare che la richiesta provenga davvero da osFoundry e non sia stata manomessa in transito. Controlla la firma con il tuo segreto condiviso prima di fidarti del corpo del messaggio. Le consegne che falliscono, perché il tuo endpoint era spento, lento o ha restituito un errore, vengono ritentate automaticamente anziché scartate, così una breve interruzione dalla tua parte non perde eventi in silenzio. Poiché osFoundry è local-first e funziona con le tue chiavi (BYOK), i webhook sono la via deliberata e opt-in per spostare i dati verso l'esterno: decidi tu quali endpoint ricevono gli eventi, e i payload vanno solo dove li indirizzi.
Il valore pratico è il disaccoppiamento. Il tuo servizio di notifiche, il sistema di ticketing, il data warehouse o un'automazione interna non devono vivere dentro osFoundry né custodire credenziali di osFoundry: devono solo esporre un endpoint HTTPS che verifichi una firma e restituisca uno stato di successo. La verifica della firma insieme al ritentativo automatico è ciò che rende quell'endpoint sicuro su cui fare affidamento, ossia la differenza tra un webhook su cui puoi costruire un flusso di lavoro e uno che devi tenere sotto controllo di continuo.
Funzionalità principali
- Registra i tuoi endpoint HTTPS e ricevi gli eventi della piattaforma nel momento in cui si verificano, senza mantenere un ciclo di polling
- Ogni payload è firmato, così il tuo ricevitore può verificare che la richiesta abbia avuto origine in osFoundry prima di agire
- Le consegne fallite vengono ritentate automaticamente, così un guasto a valle non scarta eventi in silenzio
- Gestito sotto Impostazioni e sicurezza come via in uscita opt-in, per singolo endpoint e sotto il tuo pieno controllo
- Si allinea al modello local-first e BYOK: i dati escono solo verso gli endpoint che indichi esplicitamente
Casi d’uso
- Platform engineer: inoltra gli eventi dello spazio di lavoro a un servizio di automazione interno senza dargli credenziali di osFoundry né incorporarlo nell'app
- Ops/reperibilità: convoglia gli eventi in un sistema di alerting o di notifiche già esistente, così le persone giuste vengono a sapere dell'attività in tempo reale
- Team dati: trasmetti gli eventi verso un warehouse o un endpoint ETL per tenere un registro esterno sincronizzato con ciò che accade nello spazio di lavoro
Domande frequenti
Come verifico che una richiesta di webhook provenga davvero da osFoundry?
Ogni consegna è firmata. Il tuo endpoint ricalcola la firma sul corpo della richiesta usando il tuo segreto condiviso e la confronta con la firma che invia osFoundry. Se non coincidono, rifiuta la richiesta. È questo a impedire a terzi di falsificare eventi verso il tuo endpoint.
Cosa succede se il mio endpoint è spento quando scatta un evento?
osFoundry ritenta la consegna automaticamente anziché scartarla, così una breve interruzione o un deploy dalla tua parte non ti fa perdere eventi. Il tuo endpoint dovrebbe restituire uno stato di successo una volta accettato il payload.
Usare i webhook manda i miei dati in un luogo controllato da osFoundry?
No. osFoundry è local-first e BYOK, e i webhook sono in uscita verso endpoint che registri tu. Gli eventi vanno solo alle URL che configuri, e sei tu a controllare quali endpoint esistono. È una via opt-in per spostare eventi specifici verso sistemi che già ti appartengono.