Obradite dolazne pozive (API)

Standardni postupak „odgovaranja na telefon uz AI” iz vašeg terminala. Vi ćete:

1. Izraditi agenta s uputom i glasom.
2. Dodijeliti (ili prenijeti) telefonski broj i postaviti agenta kao njegov obrađivač dolaznih poziva.
3. Nazvati broj. Pregledati zapis poziva, transkript i snimku.

Ukupno API poziva: četiri. Ukupno vrijeme: manje od pet minuta.

1. Izradite agenta

Agent objedinjuje uputu, glas i razinu proizvoda koji će upravljati pozivom. Pogledajte Agenti za svako polje konfiguracije; minimum je:

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

Spremite vraćeni id — trebat će vam u koraku 2.

2. Nabavite telefonski broj

Ako vam je potreban samo broj za pozivanje, dodijelite demo broj iz fonda ThunderPhonea:

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

Odgovor uključuje id i number u formatu E.164. Demo brojevi počinju sa status="provisioning" i postaju active u nekoliko sekundi — provjeravajte GET /v1/phone-numbers/{id} kako biste pratili prijelaz ako vam je to važno.

3. Dodijelite agenta

Povežite agenta iz koraka 1 s dolaznim smjerom broja:

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

To je sve — broj je aktivan. U istom PATCH zahtjevu možete postaviti i outbound_agent_id kako bi broj bio spreman i za odlazne pozive.

4. Primite poziv

Nazovite broj sa svojeg telefona. Agent se javlja, predstavlja se prema vašoj uputi i razgovor započinje.

Dok je poziv u tijeku, prikazuje se u GET /v1/calls sa status="in_progress". Kada završi, zapis se ažurira s end_reason, duration_seconds, billable_minutes i (naknadno) URL-om snimke i AI ocjenom.

5. Pregledajte rezultate

Dohvatite popis nedavnih poziva:

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

Dohvatite transkript:

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

I URL snimke (kratkotrajan, potpisan):

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

Ako ste se pretplatili na telephony.complete webhook, primit ćete iste podatke kao POST zahtjev na svoj poslužitelj — pogledajte call.complete.

Sljedeći koraci