> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Håndter indgående opkald (API)

> Fra start til slut: Konfigurer en agent, tildel den til et telefonnummer, modtag et opkald, og gennemgå transskriptionen.

<Note>
  Bygger du din første agent manuelt? Dashboardet gennemgår præcis
  dette flow — byg agenten, tilføj et nummer, simuler, gennemgå — med
  en guidet guide. Start med
  [dashboardets hurtigstart](/da/quickstart-dashboard).
</Note>

Det kanoniske "besvar en telefon med AI"-flow fra din terminal.
Du skal:

1. Oprette en agent med en prompt og en stemme.
2. Klargøre (eller medbringe) et telefonnummer og tildele agenten som
   håndtering af indgående opkald.
3. Ringe til nummeret. Se opkaldsloggen, transskriptionen og optagelsen.

Samlet antal API-kald: fire. Samlet tid: under fem minutter.

## 1. Opret en agent

En agent samler prompten, stemmen og produktniveauet, der driver
opkaldet. Se [Agenter](/api-reference/agents) for alle konfigurationsfelter;
minimumskravet er:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'
```

Gem det returnerede `id` — du skal bruge det i trin 2.

<Tip>
  Vælg `spark` til simple spørgsmål og svar til den laveste pris, og
  `bolt`, når hastighed er vigtigst. Opgradér til `storm-base-with-ack`,
  når din prompt kræver dybere ræsonnement og kan tolerere en
  fyldlyd på et halvt sekund, mens modellen tænker. Se
  [produktniveauer](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Få et telefonnummer

Hvis du blot har brug for noget, du kan ringe til, kan du klargøre et
demonummer fra ThunderPhones pulje:

```bash theme={null}
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"}'
```

Svaret indeholder et `id` og et `number` i E.164. Demonumre
starter med `status="provisioning"` og bliver `active` inden for få
sekunder — foretag gentagne forespørgsler til
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
for at følge overgangen, hvis du har brug for det.

<Note>
  Til produktion skal du springe demonumre over og
  [medbringe dine egne numre via VoIP](/da/guides/bring-your-own-numbers).
  Demonumre er kun til indgående opkald og er begrænset i antal.
</Note>

## 3. Tildel agenten

Tilknyt agenten fra trin 1 til nummerets indgående trafik:

```bash theme={null}
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

Det var det — nummeret er aktivt. Du kan også angive `outbound_agent_id`
i samme PATCH, så nummeret også er klar til at foretage udgående opkald.

## 4. Tag et opkald

Ring til nummeret fra din telefon. Agenten besvarer opkaldet, præsenterer
sig selv i henhold til din prompt, og samtalen begynder.

Mens opkaldet er i gang, vises det i
[`GET /v1/calls`](/api-reference/calls#list-calls) med
`status="in_progress"`. Når det slutter, opdateres posten med
`end_reason`, `duration_seconds`, `billable_minutes` og (efterhånden)
en optagelses-URL og AI-bedømmelse.

## 5. Gennemgå resultaterne

Hent listen over seneste opkald:

```bash theme={null}
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Hent transskriptionen:

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Og optagelses-URL'en (kortvarig, signeret):

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Hvis du abonnerer på
[`telephony.complete` webhook](/da/webhooks/events),
modtager du de samme data som en POST-anmodning til din server — se
[call.complete](/da/webhooks/call-complete).

***

## Næste trin

<CardGroup cols={2}>
  <Card title="Dynamisk konfiguration pr. opkald" icon="bolt" href="/da/guides/dynamic-call-config">
    Vælg en anden agent for hver opkalder baseret på telefonnummeret eller
    brugerdefineret logik i en webhook.
  </Card>

  <Card title="Tilføj værktøjsintegrationer" icon="screwdriver-wrench" href="/da/guides/build-tool-integration">
    Lad agenten kalde dine API'er midt i samtalen.
  </Card>

  <Card title="Modtag call.complete-webhooks" icon="bolt" href="/da/webhooks/call-complete">
    Send hvert afsluttet opkald til din CRM- eller analysepipeline.
  </Card>

  <Card title="AI-bedømmelse og problemrapporter" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Bedøm automatisk hvert opkald, og send markerede opkald til gennemgang.
  </Card>
</CardGroup>