Developer Quick Start

Connect your ERP / POS / CRM as Business Tools over a signed webhook. Qefro discovers tools and executes them in the Runtime — your process never runs FlowRunner.

This is not how you build a Marketplace App. For Restaurant / Clinic / Real Estate metadata packages, start at Build your first app.

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