API-dokumentation

Hämta er data via REST och få realtidshändelser via signerade webhooks. Ingår i alla paket, utan extra kostnad. API-nyckel skapar ni själva i portalen.

Autentisering

Skapa en API-nyckel i portalen (app.chattassistent.se → Notiser → Skapa API-nyckel). Nyckeln visas en gång — vi lagrar bara en hash. Skicka den som Bearer-token:

Authorization: Bearer ca_live_...

Bas-URL

https://fsrdagxhznwizwmsbmxx.supabase.co/functions/v1/api

Endpoints (v1 — läsning)

GET /v1/leads

Era leads: namn, e-post, telefon, intresse, status, konversations-id, skapad.

GET /v1/bookings

Era bokningar: namn, telefon, e-post, ärende, status, start/slut, medarbetare, skapad/avbokad.

GET /v1/conversations

Era konversationer: session, domän, språk, antal meddelanden, CSAT-betyg, start/senaste meddelande.

Parametrar (alla endpoints)

  • limit — max antal rader (1–100, standard 50)
  • offset — hoppa över N rader (paginering)
  • since — ISO-datum, endast rader skapade efter (t.ex. 2026-08-01)

Exempel

curl -H "Authorization: Bearer ca_live_DIN_NYCKEL" \
  "https://fsrdagxhznwizwmsbmxx.supabase.co/functions/v1/api/v1/leads?limit=10&since=2026-08-01"

Svar:

{
  "object": "list",
  "resource": "leads",
  "count": 2,
  "limit": 10,
  "offset": 0,
  "data": [
    {
      "id": "…",
      "visitor_name": "Anna Andersson",
      "visitor_email": "[email protected]",
      "visitor_phone": "+46701234567",
      "interest": "Vill boka demo",
      "status": "new",
      "conversation_id": "…",
      "created_at": "2026-08-20T09:15:00+00:00"
    }
  ]
}

Webhooks (realtid, utgående)

För händelser i realtid — ny lead, ny bokning, avbokad bokning — aktiverar ni webhooks i portalen (Notiser → Webhooks). Vi POST:ar JSON till er adress, signerad med HMAC-SHA256:

POST https://er-endpoint.se/webhook
X-Chattassistent-Event: lead.created
X-Chattassistent-Signature: sha256=<hex>

{
  "event": "lead.created",
  "tenant_id": "…",
  "occurred_at": "2026-08-20T09:15:00+00:00",
  "data": { "id": "…", "name": "…", "email": "…", "phone": "…", "interest": "…" }
}

Verifiera signaturen genom att HMAC-SHA256:a hela request-kroppen med er signeringsnyckel (visas i portalen) och jämföra. Zapier och Make behöver inte verifiera — klistra bara in er Catch Hook-/Custom webhook-URL.

Fair use & versionering

  • ✔ API:t ingår i alla paket utan extra kostnad. Håll anropstakten rimlig (polla inte tätare än varje minut — använd webhooks för realtid).
  • ✔ v1 är läsning. Brytande ändringar kommer bara i nya versioner (/v2) — v1 lämnas stabil.
  • ✔ Frågor eller behov (t.ex. skrivning, fler fält)? [email protected]

Vanliga frågor

Vad kan jag hämta via API:et?

v1 är read-only: era leads (GET /v1/leads), bokningar (GET /v1/bookings) och konversationer (GET /v1/conversations) — alltid bara er egen tenants data, styrt av API-nyckeln. Realtidshändelser skickas i stället ut via webhooks (ny lead, ny bokning, avbokning).

Hur får jag en API-nyckel?

Logga in på app.chattassistent.se, gå till Notiser och klicka Skapa API-nyckel. Nyckeln visas en enda gång — vi lagrar bara en hash av den, så kopiera direkt. Tappad nyckel ersätts genom att skapa en ny och återkalla den gamla.

Kostar API:et något?

Nej — API-åtkomst ingår i alla paket utan extra kostnad.

Kan jag skriva data via API:et?

Inte i v1 — skrivning sker via chatten, portalen och telefonisten. Behöver ni skriva in data från egna system, hör av er till [email protected] så tittar vi på ert behov.