Whisperr developer docs

Wire churn signals into whisperr.

Two calls do the work, identify() and track(). Ten SDKs, one wire contract, and frontend + backend events land on one user timeline.

Let the wizard integrate it

You don’t have to read these docs. The wizard is Whisperr’s integration agent: it does the whole job on its own, in your repo, under your review.

$ npx @whisperr/wizard

One command in your project root. The agent detects your stack, signs you in, and wires identify() plus the exact events your onboarding configured, then hands you the diff to review.

• Fast first event in one sitting
• Seamless your named events, not a snippet
• Secure no keys shipped, git-reversible
• Open source WhisperrAI/whisperr-wizard
• npm @whisperr/wizard

Web, React, Next.js, Node, Python, PHP, Flutter, React Native/Expo and Swift today; Kotlin is underway.

1. detects your stack
2. signs you in from the browser
3. checkpoints with git
4. wires identify() + track()
5. first event received ✓

Prefer to wire it yourself? Pick your SDK

Instrument your backend first: payment failures, cancellations, trial expiry and usage drops live there. Add the browser or mobile SDK after, for engagement signal.

WebAny browser app. ~3KB, never loses exit events.ReactProvider + hook over the web SDK.Next.jsApp Router bindings, auto pageviews.Node.jsServer-side, with Express middleware.PythonServer-side, with Django middleware.PHP / LaravelFacade, flushes after the response..NETASP.NET Core DI, net8.0 + netstandard2.0.FlutterDurable offline queue, survives restarts.React Native / ExpoZero native code, runs in Expo Go.SwiftiOS, macOS, tvOS, watchOS. Actor-based.

Or call the API directly

The ingestion API is three endpoints behind https://api.whisperr.net. Building your own client? Read delivery, retries & idempotency first; a stable $message_id per event is what makes retries safe.

POST/v1/events/batchup to 500 events→POST/v1/events/tracksingle event→POST/v1/identifytraits + channels→

Before you ship

Event designWhat to track, snake_case naming, one user id everywhere.KeysIngestion keys (wrk_…) are publishable. Dashboard → Developer → API Keys.Delivery contractRetain on auth errors, retry transient, drop malformed. Dedup via $message_id.