osFoundry / Platform
Webhooks salientes
Reparte eventos de la plataforma a tus propios endpoints. Reintentos automáticos, verificación de firma.
Qué es
Los webhooks salientes permiten que osFoundry envíe eventos a endpoints que tú controlas. En lugar de consultar continuamente si hubo cambios, registras una URL y osFoundry le hace una petición HTTP cada vez que ocurre un evento relevante en tu espacio de trabajo. Así, la actividad en tus superficies de chat, agentes, apps, código, conocimiento y datos se convierte en una señal sobre la que tus propios sistemas pueden actuar, sin tener que montar una integración a medida para cada caso.
Dentro de osFoundry, los webhooks viven en Ajustes y Seguridad porque cruzan un límite de confianza: llevan eventos del espacio de trabajo hacia un receptor que es tuyo. Cada entrega va firmada, de modo que tu endpoint puede verificar que la petición realmente proviene de osFoundry y que no fue manipulada en tránsito. Comprueba la firma contra tu secreto compartido antes de confiar en el cuerpo del mensaje. Las entregas que fallan, porque tu endpoint estaba caído, lento o devolvió un error, se reintentan de forma automática en lugar de descartarse, así una interrupción breve de tu lado no pierde eventos en silencio. Como osFoundry es local-first y funciona con tus propias claves (BYOK), los webhooks son la vía deliberada y opcional para mover datos hacia afuera: tú decides qué endpoints reciben eventos, y las cargas solo llegan a donde tú las diriges.
El valor práctico es el desacoplamiento. Tu servicio de notificaciones, tu sistema de tickets, tu data warehouse o una automatización interna no necesitan vivir dentro de osFoundry ni guardar credenciales de osFoundry: solo necesitan exponer un endpoint HTTPS que verifique una firma y devuelva un estado de éxito. La verificación de firma y el reintento automático son lo que vuelve ese endpoint seguro de confiar y fiable para depender de él, que es la diferencia entre un webhook sobre el que puedes construir un flujo de trabajo y uno al que tienes que estar vigilando.
Capacidades principales
- Registra tus propios endpoints HTTPS y recibe los eventos de plataforma en el momento en que ocurren, sin mantener un bucle de sondeo
- Cada carga va firmada, para que tu receptor pueda verificar que la petición se originó en osFoundry antes de actuar sobre ella
- Las entregas fallidas se reintentan de forma automática, así una caída aguas abajo no descarta eventos en silencio
- Se gestiona en Ajustes y Seguridad como una vía saliente opcional, por endpoint y bajo tu control total
- Encaja con el modelo local-first y BYOK: los datos solo salen hacia los endpoints que tú indicas explícitamente
Casos de uso
- Ingeniero de plataforma: reenvía eventos del espacio de trabajo a un servicio de automatización interno sin darle credenciales de osFoundry ni incrustarlo en la app
- Operaciones/guardia: canaliza los eventos hacia un sistema de alertas o notificaciones existente para que las personas adecuadas se enteren de la actividad en tiempo real
- Equipo de datos: transmite eventos a un warehouse o a un endpoint de ETL para mantener un registro externo sincronizado con lo que ocurre en el espacio de trabajo
Preguntas frecuentes
¿Cómo verifico que una petición de webhook realmente vino de osFoundry?
Cada entrega va firmada. Tu endpoint recalcula la firma sobre el cuerpo de la petición usando tu secreto compartido y la compara con la firma que envía osFoundry. Si no coinciden, rechaza la petición. Esto es lo que impide que un tercero falsifique eventos hacia tu endpoint.
¿Qué pasa si mi endpoint está caído cuando se dispara un evento?
osFoundry reintenta la entrega de forma automática en lugar de descartarla, así una caída breve o un despliegue de tu lado no te hacen perder eventos. Tu endpoint debe devolver un estado de éxito una vez que haya aceptado la carga.
¿Usar webhooks envía mis datos a algún lugar que controle osFoundry?
No. osFoundry es local-first y BYOK, y los webhooks son salientes hacia endpoints que tú registras. Los eventos solo van a las URLs que configuras, y tú controlas qué endpoints existen. Es una vía opcional para mover eventos concretos a sistemas que ya son tuyos.