Developer Quick Start

Build Business Tools and Business Flows in your backend. Qefro discovers them over a signed webhook and executes tools/flows in the Runtime — your process never runs FlowRunner.

Choose your SDK

Language	Package	Guide
JavaScript / TypeScript	@qefro-ai/backend	JavaScript SDK
Python	qefro-backend	Python SDK
Rust	qefro-backend-sdk	Rust SDK

Minimal path

1. Install the SDK and set QEFRO_SIGNING_SECRET.
2. app.tool(...) for each business capability.
3. Optional: app.flow(...) for multi-step orchestration (conversation and/or event triggers).
4. app.listen({ path: '/qefro' }) on a public HTTPS URL.
5. Admin Console → SDK Connections → create connection → Test → Sync Tools.
6. Enable tools/flows on a workspace and test from chat or emit an event.

Note

Full walkthrough: Register SDK Business Tools. Flows: Define · Run · Event triggers.

Workflow checklist

First SDK connection

1. Scaffold backend — Install SDK; expose POST /qefro.
2. Register tools — Stable names + JSON Schema inputs.
3. Connect in console — Webhook URL + signing secret.
4. Sync Tools — capabilities.list imports tools/flows.
5. Enable + test — Chat or emit a namespaced event.

Related topics