Webhooks de Fluos
Los webhooks entrantes de Clerk, Stripe y Resend que Fluos verifica y procesa. No es una API de webhook saliente configurable por el cliente.
Fluos recibe webhooks entrantes de proveedores de identidad, facturación y correo electrónico. Estos no son webhooks salientes configurables por el cliente, y los agentes no deben llamarlos; cada solicitud se verifica mediante firma contra un secreto del lado del servidor.
Las operaciones OpenAPI son receiveClerkWebhook, receiveStripeWebhook y receiveResendWebhook en /openapi.json.
Clerk — POST /api/webhooks/clerk
Se usa para el ciclo de vida de la cuenta.
| Evento | Qué hace Fluos |
|---|---|
user.created | Registra el registro canónico del lado del servidor (user_signed_up) |
user.deleted | Ejecuta la cascada de eliminación de cuentas |
Autenticación: Encabezados Svix svix-id, svix-timestamp, svix-signature verificados con CLERK_WEBHOOK_SIGNING_SECRET.
Respuestas: 200 aceptado, 400 firma incorrecta, 500 no configurado.
Stripe — POST /api/stripe/webhook
Se utiliza para suscripciones Pro y facturas empresariales.
Autenticación: stripe-signature verificado con STRIPE_WEBHOOK_SECRET. Se requiere el cuerpo crudo; no pre-parsees JSON antes de la verificación.
Respuestas: 200 aceptado, 400 firma ausente/inválida, 500 fallo del manejador (Stripe reintentará; los manejadores son idempotentes).
Reenviar — POST /api/webhooks/resend
Se utiliza para el seguimiento de apertura de correos electrónicos transaccionales.
Autenticación: Encabezados Svix verificados con RESEND_WEBHOOK_SECRET.
Cuerpo (campos relevantes):
{
"type": "email.opened",
"data": { "email_id": "..." }
}Configurando los puntos finales
Registra las URL de producción con cada proveedor:
https://www.fluos.io/api/webhooks/clerkhttps://www.fluos.io/api/stripe/webhookhttps://www.fluos.io/api/webhooks/resend
El desarrollo local utiliza http://localhost:3000 más las mismas rutas.
Webhooks de salida / clientes
Fluos actualmente no ofrece una API pública de suscripción a webhooks de salida (sin URL de devolución de llamada del cliente video.exported). La integración de flujos de trabajo empresariales se organiza con ventas de Fluos.