osFoundry / Platform
Webhooks sortants
Diffusez les événements de la plateforme vers vos propres endpoints. Auto-retry, vérification de signature.
Présentation
Les webhooks sortants permettent à osFoundry de pousser des événements vers des endpoints que vous contrôlez. Plutôt que d'interroger la plateforme pour repérer les changements, vous enregistrez une URL et osFoundry lui envoie une requête HTTP dès qu'un événement pertinent survient dans votre espace de travail. L'activité de vos surfaces de chat, d'agents, d'apps, de code, de connaissances et de données devient ainsi un signal sur lequel vos propres systèmes peuvent agir, sans avoir à câbler une intégration sur mesure pour chacune.
Dans osFoundry, les webhooks se trouvent sous Paramètres et sécurité, car ils franchissent une frontière de confiance : ils portent les événements de l'espace de travail vers un récepteur qui vous appartient. Chaque livraison est signée, si bien que votre endpoint peut vérifier que la requête provient réellement d'osFoundry et n'a pas été altérée en transit. Contrôlez la signature à l'aide de votre secret partagé avant d'accorder votre confiance au corps du message. Les livraisons qui échouent, parce que votre endpoint était indisponible, lent ou a renvoyé une erreur, sont réessayées automatiquement au lieu d'être abandonnées, de sorte qu'une brève panne de votre côté ne perde pas d'événements en silence. Comme osFoundry est local-first et fonctionne avec vos propres clés (BYOK), les webhooks sont la voie délibérée et facultative pour faire sortir des données : vous décidez quels endpoints reçoivent les événements, et les charges ne vont que là où vous les dirigez.
Le bénéfice concret, c'est le découplage. Votre service de notification, votre outil de tickets, votre entrepôt de données ou une automatisation interne n'ont ni à vivre dans osFoundry, ni à détenir des identifiants osFoundry : il leur suffit d'exposer un endpoint HTTPS qui vérifie une signature et renvoie un statut de succès. La vérification de signature et le réessai automatique sont précisément ce qui rend cet endpoint digne de confiance et fiable, c'est-à-dire ce qui distingue un webhook sur lequel bâtir un workflow d'un webhook qu'il faut surveiller sans cesse.
Fonctionnalités clés
- Enregistrez vos propres endpoints HTTPS et recevez les événements de la plateforme à l'instant où ils surviennent, sans boucle d'interrogation à maintenir
- Chaque charge est signée, pour que votre récepteur puisse vérifier que la requête provient d'osFoundry avant d'agir
- Les livraisons en échec sont réessayées automatiquement, de sorte qu'une panne en aval n'abandonne pas d'événements en silence
- Géré sous Paramètres et sécurité comme une voie sortante facultative, par endpoint et entièrement sous votre contrôle
- S'inscrit dans le modèle local-first et BYOK : les données ne sortent que vers les endpoints que vous désignez explicitement
Cas d’usage
- Ingénieur plateforme : transférer les événements de l'espace de travail vers un service d'automatisation interne sans lui donner d'identifiants osFoundry ni l'intégrer à l'application
- Ops/astreinte : acheminer les événements vers un système d'alerte ou de notification existant pour que les bonnes personnes soient informées de l'activité en temps réel
- Équipe data : diffuser les événements vers un entrepôt ou un endpoint ETL afin de garder un enregistrement externe synchronisé avec ce qui se passe dans l'espace de travail
Questions fréquentes
Comment vérifier qu'une requête de webhook provient bien d'osFoundry ?
Chaque livraison est signée. Votre endpoint recalcule la signature sur le corps de la requête à l'aide de votre secret partagé et la compare à celle qu'envoie osFoundry. Si elles ne correspondent pas, rejetez la requête. C'est ce qui empêche un tiers de forger des événements vers votre endpoint.
Que se passe-t-il si mon endpoint est indisponible au moment où un événement se déclenche ?
osFoundry réessaie la livraison automatiquement au lieu de l'abandonner, de sorte qu'une brève panne ou un déploiement de votre côté ne vous fait pas perdre d'événements. Votre endpoint doit renvoyer un statut de succès une fois qu'il a accepté la charge.
Utiliser les webhooks envoie-t-il mes données vers un lieu contrôlé par osFoundry ?
Non. osFoundry est local-first et BYOK, et les webhooks sont sortants vers des endpoints que vous enregistrez. Les événements ne vont que vers les URL que vous configurez, et vous contrôlez quels endpoints existent. C'est une voie facultative pour acheminer des événements précis vers des systèmes qui vous appartiennent déjà.