Utviklere

Et API som leser
som dashbordet.

Alt du kan klikke på, kan du kalle. Assistenter, samtaler, leads, kampanjer, stemmer og modeller over vanlig REST med JSON. Nøkler bærer scopes, webhooks bærer signaturer, og dokumentasjonen er skrevet for folk som heller vil kopiere et eksempel som virker enn å lese en spesifikasjon. Spesifikasjonen finnes også.

Full API-guide Webhooks Verktøy og MCP

Kom i gang

Tre forespørsler til første samtale.

Lag en nøkkel under Utviklere → API-nøkler, huk av de scopene den trenger
Send den som X-API-Key-headeren; nøkkelen virker i arbeidsområdet den ble laget i
Lag en assistent, eller bruk en du bygde i dashbordet, og sett i gang en samtale
Poll samtalen, eller la en webhook si fra når den er ferdig

Base-URL: https://nordtell.com/api/v1. Seksti forespørsler i minuttet per nøkkel; over det får du en 429 og må vente. Feilmeldinger sier hvilket felt som var galt.

curl

# 1. an assistant, from a prompt in plain words
curl -X POST https://nordtell.com/api/v1/assistants \
  -H "X-API-Key: $NORDTELL_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Reception", "direction": "inbound", "engine": "hybrid",
       "config": {"prompt": "You are Freja, the receptionist at Nørrebro Clinic…"}}'

# 2. a call
curl -X POST https://nordtell.com/api/v1/calls/make \
  -H "X-API-Key: $NORDTELL_KEY" -H "Content-Type: application/json" \
  -d '{"agent_id": "ASSISTANT_ID", "to_number": "+4531183990",
       "variables": {"name": "Sara"}}'

# 3. what happened
curl https://nordtell.com/api/v1/calls/CALL_ID -H "X-API-Key: $NORDTELL_KEY"

Webhooks

Vi banker deg på skulderen.

Registrer en URL og en hemmelighet. Når en samtale starter, blir besvart, avsluttes eller fullføres, får du en signert JSON-kropp med transkripsjonen, sammendraget, variablene agenten samlet inn og minuttene den kostet. Ett endepunkt per system, så du kan trekke tilbake CRM-ens uten å røre Slacks.

Hendelser: call.started, call.answered, call.ended, call.completed, pluss agent- og lead-hendelser
HMAC-signatur i headeren; verifiser den, deretter stol på kroppen
Leveringslogg for hver forespørsel, med statusen serveren din svarte

POST https://your-server/webhooks/nordtell

{
  "event": "call.completed",
  "data": {
    "id": "b0c1…", "direction": "inbound", "duration_seconds": 134,
    "from_number": "+45…", "summary": "Booked a check-up Tue 14:40.",
    "variables": { "appointment": "2026-09-15T14:40" },
    "transcript": [ … ]
  }
}

Verktøy og MCP

Ditt API, i hendene til agenten.

Et verktøy er en funksjon med et navn, en beskrivelse og typede parametere. Pek det mot ditt HTTP-endepunkt, så kaller modellen det midt i samtalen, venter på svaret og sier det høyt. Har du allerede en MCP-server? Legg til URL-en, så dukker hvert verktøy den tilbyr opp i agentredigereren.

Verktøynavn er funksjonsnavn: check_availability, ikke "Check availability"
Tidsavbrudd per verktøy og en talt fyllsetning mens verktøyet jobber
Innebygde: overfør, avslutt samtale, send SMS, klokkeslett nå

tool definition

{
  "name": "check_availability",
  "description": "Free slots for a practitioner on a date",
  "parameters": {
    "practitioner": { "type": "string" },
    "date": { "type": "string", "format": "date" }
  },
  "url": "https://clinic.example/api/slots",
  "method": "GET"
}

Endepunkter

Hva som står på menyen.

Hver nøkkel får bare de scopene du huker av. Den fulle referansen, med forespørsels- og svarkropper, ligger i dokumentasjonen og i OpenAPI-spesifikasjonen.

Endepunkt	Scope	Hva det gjør
GET / POST /assistants	agents:read / agents:write	List opp og lag assistenter; PATCH og DELETE etter id
GET /calls, GET /calls/{id}	calls:read	Samtaleliste; transkripsjon, sammendrag, variabler og leveringer
POST /calls/make	calls:make	Sett i gang en utgående samtale fra en assistents nummer
GET / POST /leads	leads:read / leads:write	Leads med telefon, navn, variabler og status
POST /campaigns, …/leads, …/start, …/stop	campaigns:manage	Utgående kampanjer: lag, legg til leads, kjør, sett på pause
GET /languages, /models, /voices	any key	Oppslagene redigereren bruker, så grensesnittet ditt kan matche vårt