Hurtigstart (API)

Denne veiledningen tar deg gjennom de fire REST-kallene som kreves for å besvare din første telefonsamtale med en KI-agent.

Du trenger en ThunderPhone-konto. Det er gratis å registrere seg og tar under ett minutt. Foretrekker du å klikke fremfor å bruke curl? Hurtigstart i dashbordet gir deg den samme første samtalen uten å skrive kode.

Trinn 1: Hent en API-nøkkel

Logg inn

Åpne app.thunderphone.com.

Gå til Nøkler

Gå til Organisasjon → Nøkler i dashbordet.

Opprett en nøkkel

Klikk på Opprett nøkkel, gi den et navn, og kopier verdien sk_live_.... Den rå nøkkelen vises kun én gang — lagre den umiddelbart i hemmelighetshåndtereren din.

Står du fast? Opprett en API-nøkkel for server forklarer denne prosessen trinn for trinn, og copilot-funksjonen i appen kan fremheve hver kontroll for deg i sanntid.

Gjennom hele denne veiledningen bytter du ut sk_live_YOUR_API_KEY med verdien du nettopp kopierte. Nøkkelen identifiserer organisasjonen din automatisk, så du trenger aldri å legge inn en organisasjons-ID i URL-er.

Trinn 2: Opprett en agent

En stemmeagent definerer hvordan KI-en håndterer samtaler — prompt, stemme, produktnivå, verktøy og om den kan brukes i widgeter.

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 er optimalisert for kostnad, bolt for hastighet, og storm-base / storm-extra for intelligens i komplekse prompter. Se Agenter for hele sammenligningen.

Trinn 3: Klargjør et telefonnummer

Dette kallet ber ThunderPhones demopool om et nummer og tilordner den nye agenten din som behandler for innkommende anrop. (Hvis du vil ta med ditt eget nummer fra en VoIP- leverandør, kan du se VoIP-tilkoblinger i stedet.)

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

Det nye nummeret ditt starter i status="provisioning" og går over til active i løpet av noen sekunder. Innen du lukker nettleseren, er nummeret klart til å motta anrop.

Trinn 4 (valgfritt): Konfigurer en webhook

Legg til et webhook-endepunkt for hendelser i sanntid (dynamisk anropsruting, behandling etter anrop). Abonner bare på hendelsene du trenger.

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

Responsen inneholder en secret som bare vises én gang — kopier den til hemmelighetshåndtereren din. Bruk denne hemmeligheten til å verifisere headeren X-ThunderPhone-Signature på innkommende forespørsler (se Oversikt over webhooks).

Trinn 5: Test agenten din

Ring nummeret du nettopp klargjorde. Agenten svarer, introduserer seg og følger ledeteksten din. Undersøk anropet etter at det er avsluttet:

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

Gå inn på et bestemt anrop for å hente transkripsjonen og URL-en til opptaket:

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"

Neste trinn

Legg til funksjonsverktøy

La agenten din kalle API-ene dine under en samtale.

Foreta utgående anrop

Utløs anrop fra din egen kode.

Håndter webhooks

Reager på anropshendelser i sanntid.

Fullstendig API-referanse

Alle offentlige endepunkter, dokumentert.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Trinn 1: Hent en API-nøkkel

Trinn 2: Opprett en agent

Trinn 3: Klargjør et telefonnummer

Trinn 4 (valgfritt): Konfigurer en webhook

Trinn 5: Test agenten din

Neste trinn

Legg til funksjonsverktøy

Foreta utgående anrop

Håndter webhooks

Fullstendig API-referanse

​Trinn 1: Hent en API-nøkkel

​Trinn 2: Opprett en agent

​Trinn 3: Klargjør et telefonnummer

​Trinn 4 (valgfritt): Konfigurer en webhook

​Trinn 5: Test agenten din

​Neste trinn

Legg til funksjonsverktøy

Foreta utgående anrop

Håndter webhooks

Fullstendig API-referanse

Trinn 1: Hent en API-nøkkel

Trinn 2: Opprett en agent

Trinn 3: Klargjør et telefonnummer

Trinn 4 (valgfritt): Konfigurer en webhook

Trinn 5: Test agenten din

Neste trinn