Developer cookbook

Håndter innkommende samtaler (API)

Fra start til slutt: konfigurer en agent, tildel den til et telefonnummer, ta imot en samtale og se gjennom transkripsjonen.

Standardflyten for å «svare på en telefon med en AI», fra terminalen. Du skal:

1. Opprette en agent med en prompt og stemme.
2. Klargjøre (eller ta med) et telefonnummer og tilordne agenten som innkommende behandler.
3. Ringe nummeret. Se samtaleloggen, transkripsjonen og opptaket.

Totalt antall API-kall: fire. Total tid: under fem minutter.

1. Opprett en agent#

En agent samler prompten, stemmen og produktnivået som skal håndtere samtalen. Se Agenter for alle konfigurasjonsfeltene; minimumet er:

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

Lagre returnert id — du trenger den i trinn 2.

2. Skaff et telefonnummer#

Hvis du bare trenger noe å ringe til, kan du klargjøre et demonummer fra ThunderPhone-poolen:

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 inneholder en id og et number i E.164-format. Demonumre starter med status="provisioning" og blir active i løpet av noen sekunder — spør GET /v1/phone-numbers/{id} for å følge overgangen hvis du trenger det.

3. Tilordne agenten#

Knytt agenten fra trinn 1 til nummerets innkommende retning:

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 er alt — nummeret er aktivt. Du kan også angi outbound_agent_id i samme PATCH, slik at nummeret også er klart for utgående samtaler.

4. Ta imot en samtale#

Ring nummeret fra telefonen din. Agenten svarer, introduserer seg i henhold til prompten din, og samtalen begynner.

Mens samtalen pågår, vises den i GET /v1/calls med status="in_progress". Når den avsluttes, oppdateres posten med end_reason, duration_seconds, billable_minutes og (etter hvert) en URL til opptaket og en AI-vurdering.

5. Undersøk resultatene#

Hent listen over nylige samtaler:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Hent transkripsjonen:

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

Og URL-en til opptaket (kortvarig, signert):

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

Hvis du abonnerte på telephony.complete-webhooken, mottar du de samme dataene som en POST til serveren din — se call.complete.

Neste trinn#