Obrada dolaznih poziva (API)

Od početka do kraja: konfigurirajte agenta, dodijelite ga telefonskom broju, primite poziv i pregledajte transkript.

Standardni tijek „odgovaranja na poziv uz AI” iz Vašeg terminala. Vi ćete:

1. Izraditi agenta s uputom i glasom.
2. Nabaviti (ili prenijeti) telefonski broj i dodijeliti agenta kao obrađivača dolaznih poziva.
3. Nazvati broj. Pregledati zapis poziva, prijepis 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 konfiguracijsko polje; 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 testno pozivanje, nabavite ThunderPhone broj iz ThunderPhone fonda:

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. ThunderPhone brojevi započinju u stanju status="provisioning" i postaju active unutar nekoliko sekundi — periodično pozivajte GET /v1/phone-numbers/{id} kako biste pratili prijelaz ako Vam je to potrebno.

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. Možete postaviti i outbound_agent_id u istom PATCH zahtjevu kako bi broj bio spreman i za odlazne pozive.

4. Primite poziv#

Nazovite broj sa svog telefona. Agent se javlja, predstavlja se prema Vašoj uputi i razgovor poč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 prijepis:

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#