Schnellstart (API)

Dieser Leitfaden führt Sie durch die vier REST-Aufrufe, die erforderlich sind, um Ihren ersten Telefonanruf mit einem KI-Agenten entgegenzunehmen.

Sie benötigen ein ThunderPhone-Konto. Die Registrierung ist kostenlos und dauert weniger als eine Minute. Sie klicken lieber, statt curl zu verwenden? Der Dashboard-Schnellstart ermöglicht denselben ersten Anruf, ohne dass Sie Code schreiben müssen.

Schritt 1: API-Schlüssel abrufen

Anmelden

Öffnen Sie app.thunderphone.com.

Zu Schlüsseln navigieren

Gehen Sie im Dashboard zu Organisation → Schlüssel.

Schlüssel erstellen

Klicken Sie auf Schlüssel erstellen, geben Sie ihm einen Namen und kopieren Sie den Wert sk_live_.... Der vollständige Schlüssel wird nur einmal angezeigt — speichern Sie ihn sofort in Ihrem Secret Manager.

Sie kommen nicht weiter? Server-API-Schlüssel erstellen führt Sie Schritt für Schritt durch diesen Ablauf, und der In-App-Copilot kann jedes Steuerelement live für Sie hervorheben.

Ersetzen Sie in diesem Leitfaden sk_live_YOUR_API_KEY durch den Wert, den Sie gerade kopiert haben. Der Schlüssel identifiziert Ihre Organisation automatisch, sodass Sie niemals eine Organisations-ID in URLs angeben müssen.

Schritt 2: Einen Agenten erstellen

Ein Agent definiert, wie die KI Gespräche führt — Prompt, Stimme, Produktstufe, Tools und Widget-Berechtigung.

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":   "Customer Support",
    "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    "voice":  "john",
    "product": "spark"
  }'

import os, requests

agent = requests.post(
    "https://api.thunderphone.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={
        "name":   "Customer Support",
        "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
        "voice":  "john",
        "product": "spark",
    },
).json()
print("Agent id:", agent["id"])

const agent = await fetch("https://api.thunderphone.com/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name:    "Customer Support",
    prompt:  "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    voice:   "john",
    product: "spark",
  }),
}).then((r) => r.json());
console.log("Agent id:", agent.id);

Produktstufen: spark ist auf Kosten optimiert, bolt auf Geschwindigkeit und storm-base / storm-extra auf Intelligenz bei komplexen Prompts. Die vollständige Gegenüberstellung finden Sie unter Agenten.

Schritt 3: Eine Telefonnummer bereitstellen

Dieser Aufruf fordert vom Demo-Pool von ThunderPhone eine Nummer an und weist Ihren neuen Agenten als Handler für eingehende Anrufe zu. (Informationen dazu, wie Sie Ihre eigene Nummer von einem VoIP- Anbieter einbinden, finden Sie unter VoIP-Verbindungen.)

# First provision
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

number = requests.post(
    "https://api.thunderphone.com/v1/phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"area_code": "415"},
).json()
requests.patch(
    f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])

Ihre neue Nummer startet mit status="provisioning" und wechselt innerhalb weniger Sekunden zu active; bis Sie Ihren Browser schließen, ist die Nummer bereit, Anrufe entgegenzunehmen.

Schritt 4 (optional): Einen Webhook einrichten

Fügen Sie für Echtzeitereignisse (dynamische Anrufweiterleitung, Verarbeitung nach dem Anruf) einen Webhook-Endpunkt hinzu. Abonnieren Sie nur die Ereignisse, die Sie benötigen.

curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Prod webhook",
    "url":    "https://your-server.com/thunderphone-webhook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'

Die Antwort enthält ein nur einmal angezeigtes secret — kopieren Sie es in Ihre Geheimnisverwaltung. Verwenden Sie dieses Geheimnis, um den Header X-ThunderPhone-Signature bei eingehenden Anfragen zu verifizieren (siehe Webhook-Übersicht).

Schritt 5: Ihren Agenten testen

Rufen Sie die Nummer an, die Sie gerade bereitgestellt haben. Der Agent nimmt ab, stellt sich vor und folgt Ihrem Prompt. Prüfen Sie den Anruf, nachdem er beendet wurde:

curl https://api.thunderphone.com/v1/calls \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Rufen Sie einen bestimmten Anruf auf, um das Transkript und die Aufzeichnungs-URL abzurufen:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Nächste Schritte

Funktions-Tools hinzufügen

Lassen Sie Ihren Agenten während eines Gesprächs Ihre APIs aufrufen.

Ausgehende Anrufe tätigen

Lösen Sie Anrufe aus Ihrem eigenen Code aus.

Webhooks verarbeiten

Reagieren Sie in Echtzeit auf Anrufereignisse.

Vollständige API-Referenz

Jeder öffentliche Endpunkt, dokumentiert.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Schritt 1: API-Schlüssel abrufen

Schritt 2: Einen Agenten erstellen

Schritt 3: Eine Telefonnummer bereitstellen

Schritt 4 (optional): Einen Webhook einrichten

Schritt 5: Ihren Agenten testen

Nächste Schritte

Funktions-Tools hinzufügen

Ausgehende Anrufe tätigen

Webhooks verarbeiten

Vollständige API-Referenz

​Schritt 1: API-Schlüssel abrufen

​Schritt 2: Einen Agenten erstellen

​Schritt 3: Eine Telefonnummer bereitstellen

​Schritt 4 (optional): Einen Webhook einrichten

​Schritt 5: Ihren Agenten testen

​Nächste Schritte

Funktions-Tools hinzufügen

Ausgehende Anrufe tätigen

Webhooks verarbeiten

Vollständige API-Referenz

Schritt 1: API-Schlüssel abrufen

Schritt 2: Einen Agenten erstellen

Schritt 3: Eine Telefonnummer bereitstellen

Schritt 4 (optional): Einen Webhook einrichten

Schritt 5: Ihren Agenten testen

Nächste Schritte