Udviklere

Et API der læser
som dashboardet.

Alt hvad du kan klikke på, kan du kalde. Assistenter, opkald, leads, kampagner, stemmer og modeller over almindelig REST med JSON. Nøgler bærer scopes, webhooks bærer signaturer, og dokumentationen er skrevet til folk, der hellere kopierer et eksempel, der virker, end læser en spec. Spec'en er der også.

Fuld API-guide Webhooks Tools og MCP

Kom hurtigt i gang

Tre forespørgsler til dit første opkald.

Opret en nøgle under Udviklere → API-nøgler, og sæt flueben ved de scopes, den skal bruge
Send den som X-API-Key-headeren; nøglen arbejder i det workspace, den blev oprettet i
Opret en assistent, eller brug en du har bygget i dashboardet, og læg et opkald
Spørg efter opkaldet, eller lad en webhook fortælle dig, når det er færdigt

Base-URL: https://nordtell.com/api/v1. Tres forespørgsler i minuttet per nøgle; derover får du en 429 og venter. Fejl fortæller, hvilket felt der 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 prikker dig på skulderen.

Registrer en URL og en hemmelighed. Når et opkald starter, bliver besvaret, slutter eller er færdigt, får du en signeret JSON-body med udskriften, resuméet, de variabler agenten samlede ind, og de minutter det kostede. Ét endpoint per system, så du kan trække CRM'ens tilbage uden at røre Slacks.

Hændelser: call.started, call.answered, call.ended, call.completed, plus agent- og lead-hændelser
HMAC-signatur i headeren; verificér den, og stol så på body'en
Leveringslog på hvert opkald, med den status din server svarede

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": [ … ]
  }
}

Tools og MCP

Dit API, i agentens hænder.

Et tool er en funktion med et navn, en beskrivelse og typede parametre. Peg det mod dit HTTP-endpoint, og modellen kalder det midt i samtalen, venter på svaret og siger det højt. Har du allerede en MCP-server? Tilføj dens URL, og hvert tool den udstiller, dukker op i agent-editoren.

Tool-navne er funktionsnavne: check_availability, ikke "Check availability"
Timeouts per tool og en talt fyldlyd, mens toolet kører
Indbyggede: viderestil, afslut opkald, send SMS, aktuel tid

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"
}

Endpoints

Hvad der er på menuen.

Hver nøgle får kun de scopes, du sætter flueben ved. Den fulde reference, med request- og response-bodies, ligger i dokumentationen og i OpenAPI-spec'en.

Endpoint	Scope	Hvad det gør
GET / POST /assistants	agents:read / agents:write	List og opret assistenter; PATCH og DELETE efter id
GET /calls, GET /calls/{id}	calls:read	Opkaldsliste; udskrift, resumé, variabler og leveringer
POST /calls/make	calls:make	Læg et udgående opkald 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	Udgående kampagner: opret, tilføj leads, kør, sæt på pause
GET /languages, /models, /voices	enhver nøgle	De opslag editoren bruger, så din UI kan matche vores