ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Developer cookbook

Obrada dolaznih poziva (API)

Cjeloviti postupak: konfigurirajte agenta, dodijelite ga telefonskom broju, primite poziv i pregledajte transkript.

Standardni postupak „odgovaranja na telefon pomoću umjetne inteligencije” iz Vašeg terminala. Vi ćete:

  1. Izraditi agenta s upitom i glasom.
  2. Dodijeliti (ili prenijeti) telefonski broj i postaviti agenta kao njegov upravitelj dolaznih poziva.
  3. Nazvati broj. Pregledati zapis poziva, transkript i snimku.

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

1. Izradite agenta

Glasovni agent objedinjuje uputu, glas i razinu proizvoda za vođenje poziva. Za glasovnog agenta možete postaviti i ograničenja poziva, kao što su max_call_duration_seconds i ring_duration_seconds. Za odlazne pozive možete postaviti i max_hold_seconds kako biste ograničili koliko dugo glasovni agent čeka na čekanju prije prekida poziva. Bolt glasovni agenti podržavaju i audio_tier, endpointing i intelligence za upravljanje načinom na koji slušaju i odgovaraju: intelligence je core ili pro, a audio_tier (Hearing) je lite, standard, plus ili max (Max općenito nije dostupan). Starije vrijednosti (lite i standard za intelligence; lean, hearing i deep_hearing za hearing) i dalje su prihvaćene. Agenti s punim dupleksom zadržavaju isti glas u svim podržanim jezicima, pa se promjena glasa po jeziku ne primjenjuje na te pozive. Agenti također podržavaju intro_clip i intro_ring_count za reprodukciju unaprijed snimljene uvodne poruke i do dva zvonjenja prije nego što agent progovori. Novi agenti trebaju i vremensku zonu. Ako je Vaš agent višejezičan, možete postaviti language_switching kako biste odredili hoće li pitati prije promjene jezika ili slijediti jezik pozivatelja. Na agentu možete postaviti i words kako biste upravljali načinom na koji izgovara određene pojmove i koje pojmove prepoznaje. Pogledajte Agenti za svako konfiguracijsko polje; najmanje je potrebno:

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

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

2. Nabavite telefonski broj

Ako Vam je potreban samo broj koji možete nazvati, nabavite ThunderPhone broj iz ThunderPhoneova skupa brojeva:

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 počinju sa status="provisioning" i postaju active unutar nekoliko sekundi — po potrebi provjeravajte GET /v1/phone-numbers/{id} kako biste pratili prijelaz.

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. Nakon što se za Vašu organizaciju odobre odlazni pozivi, u istom PATCH zahtjevu možete postaviti i outbound_agent_id. Do tada API odbija tu dodjelu s 400.

Ako dolazne pozive usmjeravate putem konfiguracijskog webhooka umjesto fiksnog inbound_agent_id, taj webhook sada može vratiti timezone za svaki poziv zajedno s agent_id i variables. Za Bolt agente možete također postaviti audio_tier, endpointing i intelligence na agentu pri API zapisima. API i dalje prihvaća stariji naziv eagerness kao alias za endpointing. Ako vaš agent koristi API veze s trigger="call_start", ThunderPhone može pokrenuti te alate jednom na početku svakog telefonskog poziva, prije pozdrava, koristeći njihove spremljene call_start_arguments.

Povratni pozivi na vaše odlazne pozive

Kada netko uzvrati poziv na broj koji ga je nazvao u posljednjih 30 dana, agent koji odgovara dobiva kratku kontekstualnu bilješku o tom pozivu: kada je upućen, koji ga je agent uputio i što se dogodilo (nema odgovora, govorna pošta ili razgovor). Broj bez agenta za dolazne pozive šalje iste pojedinosti vašem konfiguracijskom webhooku kao returning_call. Ako taj broj nema webhook ili webhook istekne ili nije dostupan, poziv se umjesto prekida preusmjerava agentu koji je uputio raniji poziv. ID pozivatelja može se krivotvoriti, stoga se sažetak i varijable ranijeg poziva dijele samo ako administrator uključi Dijelite pojedinosti ranijeg poziva u odjeljku Organizacija → Općenito → Povratni pozivi. Pogledajte Povratni pozivi.

4. Primite poziv

Nazovite broj sa svojeg telefona. Agent se javlja, predstavlja se u skladu s Vašim upitom i razgovor započinje.

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

Dolazni pozivi uračunavaju se u ograničenje vaše organizacije za istodobne pozive (prema zadanim postavkama 20 poziva u tijeku, dijeljeno s odlaznim, web i testnim pozivima). Poziv koji stigne nakon dosegnutog ograničenja odbija se prije nego što se agent javi i prekida se, ne naplaćuje se te se bilježi kao neuspjeli poziv s razlogom završetka concurrent_call_limit_reached. Pošaljite e-poruku na support@thunderphone.com ako vam je potrebno veće ograničenje.

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.

Ako Vaš agent ima konfigurirana polja za ekstrakciju, podaci dovršenog poziva mogu sadržavati i strukturirane ekstrahirane podatke. Sažeci poziva pišu se na jeziku koji Vaša organizacija koristi u ThunderPhoneu, osim ako agent ne nadjača tu postavku.


Sljedeći koraci