Öppet API

    Bygg på era möten.

    Möten, transkript, åtgärder, risk och coachning som REST — med testnycklar som rullar tillbaka, signerade webhooks och en referens som genereras ur koden som kör.

    Öppna utvecklarportalen Boka genomgång
    terminal
    $ curl https://api.notetaker.se/v1/meetings?limit=1 \
    -H "Authorization: Bearer $TELINK_API_KEY"
{
  "ok": true,
  "data": {
    "items": [{
      "id": "3f2a1b9c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "title": "Kundmöte Nord",
      "one_liner": "Genomgång av offert, kunden vill se referenser.",
      "scheduled_at": "2026-10-13T09:00:00.000Z",
      "category": "sälj",
      "duration_seconds": 2712,
      "open_task_count": 3,
      "state": "done"
    }],
    "has_more": true,
    "next_cursor": "MjAyNi0xMC0xM1QwOTo0Njo1Mi4wMDBafDNmMmExYjlj"
  },
  "warnings": [],
  "errors": []
}

    Stockholm

    AWS eu-north-1. Data lämnar aldrig EU.

    600 anrop/min

    Per nyckel, med X-Request-Id på varje svar.

    Testläge på riktigt

    Varje skrivning körs fullt ut och rullas tillbaka.

    Plattformen

    Det här ingår

    Nycklar med scopes

    14 scopes – ge varje integration exakt den åtkomst den behöver.

    Testnycklar

    tmi_test_… kör varje skrivning fullt ut och rullar sedan tillbaka. Samma fel som i drift, inget sparas.

    Idempotens

    Skicka Idempotency-Key så körs en skrivning bara en gång, även om anropet görs om inom 24 timmar.

    Webhooks med signatur

    Åtta händelser, signerade med HMAC-SHA256, med automatiska omförsök och leveranslogg.

    Cursor-paginering

    Stabila listor med has_more och next_cursor – inga dubbletter när nya möten tillkommer.

    OpenAPI 3.1

    Referensen genereras ur koden som kör, med kodexempel i curl, JavaScript, Python och PHP.

    Bas-URL https://api.notetaker.se/v1 · alla svar har formen { ok, data, warnings, errors } · nycklar skapas av administratören i Telink Möteshjälp under Inställningar → API.

    Referens

    Resurser

    Möten

    Sammanfattning, kapitel, höjdpunkter, taltid och insikter per möte.

    meetings:readmeetings:write

    Transkript

    Hela samtalet med talare och tidsstämplar.

    transcripts:read

    Inspelningar

    Signerade länkar som gäller i en timme. Varje uttag loggas.

    recordings:read

    Åtgärder

    Att göra-punkter från mötena – läs, uppdatera och bocka av.

    tasks:readtasks:write

    Kalender

    Kommande möten och botens läge för vart och ett.

    calendar:readcalendar:write

    Bottar

    Skicka boten till ett pågående möte.

    bots:write

    Fråga

    Ställ en fråga om mötena i klartext och få svar med källor.

    ask:read

    Risk

    Affärsrisk per motpart, byggd på vad som sagts i mötena.

    risk:read

    Coachning

    Scorekort per möte.

    coaching:read

    Användare

    Organisationens användare.

    users:read

    Webhooks

    Skapa, lista och testa prenumerationer på händelser.

    webhooks:manage

    Exempel

    Så här ser ett anrop ut

    GET /v1/meetings · POST /v1/ask
    curl https://api.notetaker.se/v1/meetings?limit=1 \
  -H "Authorization: Bearer $TELINK_API_KEY"
curl -X POST https://api.notetaker.se/v1/ask \
  -H "Authorization: Bearer $TELINK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"question":"Vilka invändningar fick vi i september?"}'

    Svar från POST /v1/ask

    200 OK
    {
  "ok": true,
  "data": {
    "answer": "I september kom tre invändningar, alla om pris: Nordbolaget (13/9), Vestia (20/9) och Kalmar Bygg (27/9).",
    "sources": [{
      "meeting_id": "3f2a1b9c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
      "title": "Kundmöte Nord",
      "at_second": 1240,
      "quote": "Priset ligger över vad vi räknat med."
    }],
    "route": "highlights"
  },
  "warnings": [],
  "errors": []
}

    Fel returneras med en stabil code och ett meddelande på svenska som kan visas rakt för användaren. Skicka Idempotency-Key på skrivningar för säkra omförsök.

    Händelser

    Webhooks

    • meeting.startedBoten är inne i mötet och spelar in.
    • meeting.completedTranskript, sammanfattning och åtgärder är klara.
    • meeting.failedBoten kom inte in (lobby, nekad, ingen dök upp).
    • meeting.deletedMötet raderades — av en användare eller av retention.
    • task.updatedEn åtgärd bockades av, återöppnades eller ströks.
    • score.readyScorekortet för mötet är satt.
    • risk.signal_detectedEn ny risksignal på en motpart.
    • webhook.testTesthändelse från portalen.

    Varje leverans signeras med Telink-Signature: t=…,v1=… (HMAC-SHA256). Varje leverans har också huvudena Telink-Event-Id, Telink-Event-Type, Telink-Delivery-Id och Telink-Attempt. Misslyckade leveranser görs om upp till 8 gånger med backoff från 1 till 128 minuter, och leveransloggen låter er leverera om med en knapp.

    meeting.completed
    POST /er-endpoint
Telink-Signature: t=1760348832,v1=5f1c…
Telink-Event-Id: 7d4e8a2b-1c3f-4e5a-9b6d-2f1a3c4e5b6d
Telink-Event-Type: meeting.completed
{
  "id": "7d4e8a2b-1c3f-4e5a-9b6d-2f1a3c4e5b6d",
  "type": "meeting.completed",
  "created_at": "2026-10-13T09:47:12.000Z",
  "tenant_id": "a1b2c3d4-0000-4000-8000-000000000001",
  "meeting_id": "3f2a1b9c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
  "data": {
    "id": "3f2a1b9c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
    "title": "Kundmöte Nord",
    "one_liner": "Genomgång av offert, kunden vill se referenser.",
    "ended_at": "2026-10-13T09:46:52.000Z",
    "duration_seconds": 2712,
    "category": "sälj",
    "participant_count": 4,
    "has_media": true,
    "summary_available": true,
    "open_task_count": 3,
    "objection_count": 2
  }
}

    Användningsfall

    Vad team bygger

    meeting.completed

    Mötet i CRM:et utan handpåläggning

    Lyssna på meeting.completed och skriv sammanfattning och åtgärder till ert CRM.

    GET /v1/meetings

    Egen rapportering

    Hämta möten per säljare och period och bygg rapporterna i ert eget verktyg.

    risk.signal_detected

    Risk i Slack

    Lyssna på risk.signal_detected och posta ett meddelande i rätt kanal.

    Vanliga frågor

    Kostar API:et extra?+

    Nej. API:et ingår i prenumerationen utan extra kostnad.

    Var finns dokumentationen?+

    På utvecklarportalen notetaker.telink.ai/utvecklare. Referensen bygger på OpenAPI 3.1 och finns även som /v1/openapi.json.

    Kan vi testa utan att röra riktig data?+

    Ja. Testnycklar (tmi_test_…) kör varje skrivning fullt ut och rullar sedan tillbaka – samma fel i test som i drift, inget sparas.

    Finns Zapier eller Make?+

    Inte än – det byggs härnäst. Med webhooks går det redan i dag att koppla egna flöden.

    Var lagras data?+

    I Stockholm (AWS eu-north-1). Data lämnar aldrig EU.

    Bygg mot Telink redan i dag

    API:et ingår i prenumerationen utan extra kostnad.

    Öppna utvecklarportalen
    Testa Telink AI