Snelstart (API)

Deze gids leidt je door de vier REST-aanroepen die nodig zijn om je eerste telefoongesprek met een AI-agent te beantwoorden.

Je hebt een ThunderPhone-account nodig. Registreren is gratis en duurt minder dan een minuut. Klik je liever dan dat je curl gebruikt? Met de dashboard-quickstart bereik je hetzelfde eerste gesprek zonder code te schrijven.

Stap 1: Een API-sleutel ophalen

Inloggen

Open app.thunderphone.com.

Ga naar Sleutels

Ga in het dashboard naar Organisatie → Sleutels.

Een sleutel maken

Klik op Sleutel maken, geef de sleutel een naam en kopieer de waarde sk_live_.... De onbewerkte sleutel wordt slechts één keer weergegeven — sla deze direct op in je secrets manager.

Loop je vast? Een server-API-sleutel maken legt deze procedure stap voor stap uit, en de Copilot in de app kan elke bediening direct voor je uitlichten.

Vervang in deze hele gids sk_live_YOUR_API_KEY door de waarde die je zojuist hebt gekopieerd. De sleutel identificeert je organisatie automatisch, dus je hoeft nooit een organisatie-id in URL’s op te nemen.

Stap 2: Een agent maken

Een agent bepaalt hoe de AI gesprekken afhandelt — prompt, stem, productpakket, tools en geschiktheid voor widgets.

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);

Productpakketten: spark is geoptimaliseerd voor kosten, bolt voor snelheid en storm-base / storm-extra voor intelligentie bij complexe prompts. Bekijk Agents voor de volledige vergelijking.

Stap 3: Richt een telefoonnummer in

Deze aanroep vraagt de demopool van ThunderPhone om een nummer en wijst je nieuwe agent toe als handler voor inkomende oproepen. (Als je je eigen nummer van een VoIP-provider wilt meenemen, zie dan VoIP-verbindingen in plaats daarvan.)

# 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"])

Je nieuwe nummer begint met status="provisioning" en gaat binnen enkele seconden over naar active; tegen de tijd dat je je browser sluit, is het nummer klaar om oproepen aan te nemen.

Stap 4 (optioneel): Stel een webhook in

Voeg voor realtimegebeurtenissen (dynamische oproeproutering, verwerking na een oproep) een webhook-eindpunt toe. Abonneer je alleen op de gebeurtenissen die je nodig hebt.

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

Het antwoord bevat een eenmalige secret — kopieer deze naar je secretmanager. Gebruik die secret om de header X-ThunderPhone-Signature bij inkomende aanvragen te verifiëren (zie Overzicht van webhooks).

Stap 5: Test je agent

Bel het nummer dat je zojuist hebt ingericht. De agent neemt op, stelt zich voor en volgt je prompt. Controleer de oproep nadat deze is beëindigd:

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

Bekijk een specifieke oproep om de transcriptie en opname-URL op te halen:

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"

Volgende stappen

Functietools toevoegen

Laat je agent tijdens een gesprek je API’s aanroepen.

Uitgaande oproepen plaatsen

Start oproepen vanuit je eigen code.

Webhooks verwerken

Reageer in realtime op oproepgebeurtenissen.

Volledige API-referentie

Elk openbaar eindpunt, gedocumenteerd.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Stap 1: Een API-sleutel ophalen

Stap 2: Een agent maken

Stap 3: Richt een telefoonnummer in

Stap 4 (optioneel): Stel een webhook in

Stap 5: Test je agent

Volgende stappen

Functietools toevoegen

Uitgaande oproepen plaatsen

Webhooks verwerken

Volledige API-referentie

​Stap 1: Een API-sleutel ophalen

​Stap 2: Een agent maken

​Stap 3: Richt een telefoonnummer in

​Stap 4 (optioneel): Stel een webhook in

​Stap 5: Test je agent

​Volgende stappen

Functietools toevoegen

Uitgaande oproepen plaatsen

Webhooks verwerken

Volledige API-referentie

Stap 1: Een API-sleutel ophalen

Stap 2: Een agent maken

Stap 3: Richt een telefoonnummer in

Stap 4 (optioneel): Stel een webhook in

Stap 5: Test je agent

Volgende stappen