LIVE · AUDIT-KJEDE · EU-VERTET
SYSTEM · 99,99 % OPPETID
v 1.0 ↗ LAGET I EU

Hurtigstart

Opprett en NexBasira-økt, generer en feltbruker-invitasjon og verifiser en webhook på under 5 minutter.

Hurtigstart

Fra "ingen konto" til "økt opprettet + første webhook mottatt" på omtrent fem minutter. Vi bruker Node SDK-en; Python er nesten identisk.

1. Skaff API-legitimasjon

  1. Registrer deg på app.nexbasira.com — bootstrap-flyten oppretter organisasjonen din + admin-brukeren i ett steg.
  2. Gå til Admin → API-legitimasjon og klikk Utsted legitimasjon.
  3. Kopier nb_pub_* + nb_sec_* -paret. Hemmeligheten vises nøyaktig én gang — lagre den i din secrets manager umiddelbart.

2. Installer SDK-en

npm install @nexbasira/node

Eller for Python: pip install nexbasira.

3. Opprett en økt

import { NexBasira } from "@nexbasira/node";

const nb = new NexBasira({
  apiKey: process.env.NB_PUBLIC_KEY!,
  apiSecret: process.env.NB_SECRET_KEY!,
});

const session = await nb.sessions.create({
  notes: "Vehicle damage — claim CL-2026-0042",
  scheduled_for: "2026-05-23T10:00:00Z",
});

console.log("Session id:", session.id);
// → "0c8f4d2e-..."

4. Generer en feltbruker-invitasjon

const invite = await nb.sessions.invite(session.id, {
  recipient_email: "alex@policyholder.com",
  send_email: true,
});

console.log("Field URL (shown ONCE):", invite.url);
// → "https://app.nexbasira.com/join/0c8f.../?t=tok_..."

Send URL-en til feltbrukeren din — de åpner den på en telefon (mobil Safari eller Chrome), gir kamera- + GPS-tillatelser, og operatøren ser dem på SPA-dashbordet på under 30 sekunder.

5. Koble opp webhooken

Webhooks utløses på session.created, session.completed, evidence.added, recording.ready, audit.anchored, signature.completed, og noen til. Registrer en leverings-URL fra Admin → Webhooks og verifiser signaturen på hver POST: 

// Express handler
app.post("/nb-webhook", express.raw({ type: "application/json" }), (req, res) => {
  const sig = req.header("NB-Signature")!;
  const secret = process.env.NB_WEBHOOK_SECRET!;

  try {
    const event = nb.webhooks.constructEvent(req.body, sig, secret);
    // event is now type-narrowed by event.type
    switch (event.type) {
      case "session.completed":
        await onSessionCompleted(event.data);
        break;
      case "audit.anchored":
        await onAuditAnchored(event.data);
        break;
    }
    res.status(204).end();
  } catch (err) {
    if (err instanceof InvalidSignatureError) {
      return res.status(401).send("bad signature");
    }
    throw err;
  }
});

6. (Valgfritt) Embed feltside-widgeten

Hvis du heller vil hoste feltbruker-opplevelsen inne i din egen kundevendte app i stedet for å bruke vår hostede URL, bruk embed-widgeten:

import { embed } from "@nexbasira/embed";

const widget = embed({
  container: "#nb-host",
  sessionUrl: invite.url,
  onSessionComplete: (id) => router.push(`/inspections/${id}`),
});

// Imperative methods on the returned handle:
widget.requestSnapshot();
widget.openWhiteboard();
widget.endSession();

React-app? Bruk @nexbasira/reacts <NexBasiraSession> -komponenten i stedet — samme flate, idiomatisk React.

Hva du har nå

  • Økter opprettet via API
  • Feltbrukere som blir med via signerte invitasjons-URL-er (ingen app-installasjon)
  • Webhooks verifisert + sendt i backend-en din
  • (Valgfritt) innebygd feltside-opplevelse inne i produktet ditt

Hva som er neste