Utvecklare

Ett API som läser
som panelen.

Allt du kan klicka på kan du också anropa. Assistenter, samtal, leads, kampanjer, röster och modeller över vanlig REST med JSON. Nycklar bär scopes, webhooks bär signaturer, och dokumentationen är skriven för folk som hellre kopierar ett fungerande exempel än läser en spec. Specen finns också.

Hela API-guiden Webhooks Verktyg och MCP

Snabbstart

Tre anrop till ditt första samtal.

Skapa en nyckel under Utvecklare → API-nycklar, kryssa i de scopes den behöver
Skicka den som X-API-Key-huvudet; nyckeln verkar i den arbetsyta där den skapades
Skapa en assistent, eller använd en du byggt i panelen, och ring ett samtal
Fråga efter samtalet, eller låt en webhook säga till när det är klart

Bas-URL: https://nordtell.com/api/v1. Sextio anrop i minuten per nyckel; över det får du en 429 och får vänta. Fel talar om vilket fält som var fel.

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 knackar dig på axeln.

Registrera en URL och en hemlighet. När ett samtal startar, besvaras, avslutas eller är klart får du en signerad JSON-kropp med utskriften, sammanfattningen, variablerna som agenten samlade in och minuterna det kostade. En endpoint per system, så du kan återkalla CRM:ens utan att röra Slacks.

Händelser: call.started, call.answered, call.ended, call.completed, plus agent- och lead-händelser
HMAC-signatur i huvudet; verifiera den, lita sedan på kroppen
Leveranslogg för varje samtal, med statusen din server svarade

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

Verktyg och MCP

Ditt API, i agentens händer.

Ett verktyg är en funktion med ett namn, en beskrivning och typade parametrar. Peka den mot din HTTP-endpoint så anropar modellen den mitt i samtalet, väntar på svaret och säger det högt. Har du redan en MCP-server? Lägg till dess URL så dyker varje verktyg den exponerar upp i agenteditorn.

Verktygsnamn är funktionsnamn: check_availability, inte "Check availability"
Tidsgränser per verktyg och en talad utfyllnad medan verktyget körs
Inbyggda: koppla vidare, avsluta samtal, skicka SMS, aktuell tid

verktygsdefinition

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

Vad som finns på menyn.

Varje nyckel får bara de scopes du kryssar i. Den fullständiga referensen, med request- och response-kroppar, finns i dokumentationen och i OpenAPI-specen.

Endpoint	Scope	Vad den gör
GET / POST /assistants	agents:read / agents:write	Lista och skapa assistenter; PATCH och DELETE via id
GET /calls, GET /calls/{id}	calls:read	Samtalslista; utskrift, sammanfattning, variabler och leveranser
POST /calls/make	calls:make	Ring ett utgående samtal från en assistents nummer
GET / POST /leads	leads:read / leads:write	Leads med telefon, namn, variabler och status
POST /campaigns, …/leads, …/start, …/stop	campaigns:manage	Utgående kampanjer: skapa, lägg till leads, kör, pausa
GET /languages, /models, /voices	valfri nyckel	Uppslagen som editorn använder, så att ditt gränssnitt kan matcha vårt