Snabbstart (API)

Den här guiden leder dig genom de fyra REST-anrop som krävs för att besvara ditt första telefonsamtal med en AI-agent.

Du behöver ett ThunderPhone-konto. Det är gratis att registrera sig och det tar mindre än en minut. Föredrar du att klicka framför att använda curl? Snabbstarten i instrumentpanelen leder till samma första samtal utan att du behöver skriva kod.

Steg 1: Skaffa en API-nyckel

Logga in

Öppna app.thunderphone.com.

Gå till Nycklar

Gå till Organisation → Nycklar i instrumentpanelen.

Skapa en nyckel

Klicka på Skapa nyckel, ge den ett namn och kopiera värdet sk_live_.... Den råa nyckeln visas endast en gång — spara den direkt i din hemlighetshanterare.

Har du fastnat? Skapa en API-nyckel för servern beskriver flödet steg för steg, och copiloten i appen kan markera varje kontroll åt dig i realtid.

I resten av den här guiden byter du ut sk_live_YOUR_API_KEY mot värdet du just kopierade. Nyckeln identifierar din organisation automatiskt, så du behöver aldrig lägga in ett organisations-id i URL:er.

Steg 2: Skapa en agent

En röstagent definierar hur AI:n hanterar samtal — prompt, röst, produktnivå, verktyg och widgetbehörighet.

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

Produktnivåer: spark är optimerad för kostnad, bolt för hastighet och storm-base / storm-extra för intelligens i komplexa promptar. Se Agenter för den fullständiga jämförelsen.

Steg 3: Tilldela ett telefonnummer

Det här anropet ber ThunderPhones demopool om ett nummer och tilldelar din nya agent som hanterare för inkommande samtal. (Om du vill använda ett eget nummer från en VoIP- leverantör, se VoIP-anslutningar i stället.)

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

Ditt nya nummer startar med status="provisioning" och övergår till active inom några sekunder; när du har stängt webbläsaren är numret redo att ta emot samtal.

Steg 4 (valfritt): Konfigurera en webhook

Lägg till en webhook-slutpunkt för händelser i realtid (dynamisk samtalsdirigering, bearbetning efter samtal). Prenumerera bara på de händelser du behöver.

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

Svaret innehåller en secret som bara visas en gång — kopiera den till din hemlighetshanterare. Använd hemligheten för att verifiera rubriken X-ThunderPhone-Signature i inkommande begäranden (se Översikt över webhooks).

Steg 5: Testa din agent

Ring numret du nyss tilldelade. Agenten svarar, presenterar sig och följer din prompt. Granska samtalet när det har avslutats:

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

Gå in på ett specifikt samtal för att hämta transkriptionen och inspelnings-URL:en:

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ästa steg

Lägg till funktionsverktyg

Låt din agent anropa dina API:er under ett samtal.

Ring utgående samtal

Starta samtal från din egen kod.

Hantera webhooks

Reagera på samtalshändelser i realtid.

Fullständig API-referens

Varje offentlig slutpunkt, dokumenterad.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Steg 1: Skaffa en API-nyckel

Steg 2: Skapa en agent

Steg 3: Tilldela ett telefonnummer

Steg 4 (valfritt): Konfigurera en webhook

Steg 5: Testa din agent

Nästa steg

Lägg till funktionsverktyg

Ring utgående samtal

Hantera webhooks

Fullständig API-referens

​Steg 1: Skaffa en API-nyckel

​Steg 2: Skapa en agent

​Steg 3: Tilldela ett telefonnummer

​Steg 4 (valfritt): Konfigurera en webhook

​Steg 5: Testa din agent

​Nästa steg

Lägg till funktionsverktyg

Ring utgående samtal

Hantera webhooks

Fullständig API-referens

Steg 1: Skaffa en API-nyckel

Steg 2: Skapa en agent

Steg 3: Tilldela ett telefonnummer

Steg 4 (valfritt): Konfigurera en webhook

Steg 5: Testa din agent

Nästa steg