Entwickler

Eine API, die sich liest
wie das Dashboard.

Alles, was Sie anklicken können, können Sie aufrufen. Assistenten, Anrufe, Leads, Kampagnen, Stimmen und Modelle über einfaches REST mit JSON. Schlüssel tragen Berechtigungsbereiche, Webhooks tragen Signaturen, und die Dokumentation ist für Menschen geschrieben, die lieber ein funktionierendes Beispiel kopieren, als eine Spezifikation zu lesen. Die Spezifikation gibt es auch.

Vollständiger API-Leitfaden Webhooks Tools und MCP

Schnellstart

Drei Anfragen bis zu Ihrem ersten Anruf.

Unter Entwickler → API-Schlüssel einen Schlüssel erstellen und die nötigen Berechtigungsbereiche ankreuzen
Als X-API-Key-Header senden; der Schlüssel wirkt im Arbeitsbereich, in dem er erstellt wurde
Einen Assistenten erstellen oder einen aus dem Dashboard verwenden und einen Anruf auslösen
Den Anruf abfragen oder sich per Webhook mitteilen lassen, wann er abgeschlossen ist

Basis-URL: https://nordtell.com/api/v1. Sechzig Anfragen pro Minute und Schlüssel; darüber bekommen Sie ein 429 und warten. Fehler sagen, welches Feld falsch war.

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

Wir tippen Ihnen auf die Schulter.

Registrieren Sie eine URL und ein Geheimnis. Wenn ein Anruf beginnt, angenommen wird, endet oder abgeschlossen ist, erhalten Sie einen signierten JSON-Body mit Transkript, Zusammenfassung, den vom Agenten erfassten Variablen und den angefallenen Minuten. Ein Endpunkt pro System, damit Sie den des CRM widerrufen können, ohne den von Slack anzufassen.

Ereignisse: call.started, call.answered, call.ended, call.completed sowie Agenten- und Lead-Ereignisse
HMAC-Signatur im Header; prüfen Sie sie, dann vertrauen Sie dem Body
Zustellprotokoll an jedem Anruf, mit dem Status, den Ihr Server geantwortet hat

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 und MCP

Ihre API, in den Händen des Agenten.

Ein Tool ist eine Funktion mit einem Namen, einer Beschreibung und typisierten Parametern. Verweisen Sie auf Ihren HTTP-Endpunkt, und das Modell ruft ihn mitten im Gespräch auf, wartet auf die Antwort und spricht sie aus. Sie haben schon einen MCP-Server? Fügen Sie seine URL hinzu, und jedes Tool, das er bereitstellt, erscheint im Agent-Editor.

Tool-Namen sind Funktionsnamen: check_availability, nicht „Verfügbarkeit prüfen“
Timeouts pro Tool und eine gesprochene Füllzeile, solange das Tool läuft
Eingebaut: weiterleiten, Anruf beenden, SMS senden, aktuelle Uhrzeit

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

Endpunkte

Was auf der Karte steht.

Jeder Schlüssel bekommt nur die Berechtigungsbereiche, die Sie ankreuzen. Die vollständige Referenz mit Request- und Response-Bodys steht in der Dokumentation und in der OpenAPI-Spezifikation.

Endpunkt	Berechtigungsbereich	Was er tut
GET / POST /assistants	agents:read / agents:write	Assistenten auflisten und erstellen; PATCH und DELETE nach ID
GET /calls, GET /calls/{id}	calls:read	Anrufliste; Transkript, Zusammenfassung, Variablen und Zustellungen
POST /calls/make	calls:make	Einen ausgehenden Anruf von der Nummer eines Assistenten auslösen
GET / POST /leads	leads:read / leads:write	Leads mit Telefon, Name, Variablen und Status
POST /campaigns, …/leads, …/start, …/stop	campaigns:manage	Ausgehende Kampagnen: erstellen, Leads hinzufügen, starten, pausieren
GET /languages, /models, /voices	Jeder Schlüssel	Die Abfragen, die der Editor nutzt, damit Ihre Oberfläche zu unserer passen kann