ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Developer cookbook

Tvarkykite įeinančius skambučius (API)

Nuo pradžios iki pabaigos: sukonfigūruokite agentą, priskirkite jį telefono numeriui, priimkite skambutį ir peržiūrėkite transkriptą.

Standartinė „atsiliepti telefonu su DI“ eiga iš jūsų terminalo. Jūs:

  1. Sukursite agentą su raginimu ir balsu.
  2. Užsakysite (arba prijungsite turimą) telefono numerį ir priskirsite agentą kaip jo įeinančių skambučių tvarkytuvą.
  3. Paskambinsite numeriu. Peržiūrėsite skambučių žurnalą, nuorašą ir įrašą.

Iš viso API iškvietimų: keturi. Bendra trukmė: mažiau nei penkios minutės.

1. Sukurkite agentą

Agentas apjungia raginimą, balsą ir produkto pakopą, kuri valdys skambutį. Agente taip pat galite nustatyti skambučio apribojimus, pvz., max_call_duration_seconds ir ring_duration_seconds. Skambučiams į išorę taip pat galite nustatyti max_hold_seconds, kad apribotumėte, kiek laiko agentas laukia sulaikytas prieš baigdamas skambutį. Bolt agentai taip pat palaiko audio_tier, endpointing ir intelligence, kad galėtumėte valdyti, kaip jie klausosi ir atsako: intelligence gali būti core arba pro, o audio_tier (klausymui) gali būti lite, standard, plus arba max (Max nėra plačiai prieinamas). Senesnės reikšmės (lite ir standard, skirtos intelektui; lean, hearing ir deep_hearing, skirtos klausymui) vis dar priimamos. Viso duplekso agentai išlaiko tą patį balsą visose palaikomose kalbose, todėl tokiems skambučiams balso perjungimas pagal kalbą netaikomas. Agentai taip pat palaiko intro_clip ir intro_ring_count, kad prieš agentui pradedant kalbėti būtų paleista iš anksto įrašyta įžanga ir iki dviejų skambučių signalų. Naujiems agentams taip pat reikia laiko juostos. Jei jūsų agentas yra daugiakalbis, galite nustatyti language_switching, kad valdytumėte, ar jis prieš keisdamas kalbą paklausia, ar vadovaujasi skambinančiojo kalba. Taip pat galite nustatyti agento words, kad valdytumėte, kaip jis taria konkrečius terminus ir kurių terminų klausosi. Visus konfigūracijos laukus rasite Agentai; mažiausia konfigūracija yra:

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

Išsaugokite grąžintą id — jo reikės 2 veiksme.

2. Gaukite telefono numerį

Jei jums tiesiog reikia numerio, kuriuo galėtumėte skambinti, gaukite ThunderPhone numerį iš ThunderPhone numerių fondo:

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

Atsakyme pateikiami id ir number E.164 formatu. ThunderPhone numeriai iš pradžių būna status="provisioning" būsenos ir per kelias sekundes tampa active — jei tai jums svarbu, stebėkite būsenos pasikeitimą apklausdami GET /v1/phone-numbers/{id}.

3. Priskirkite agentą

Susiekite 1 veiksme sukurtą agentą su numerio įeinančių skambučių kryptimi:

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

Viskas — numeris aktyvus. Kai jūsų organizacijai bus patvirtinti išeinantys skambučiai, tame pačiame PATCH taip pat galėsite nustatyti outbound_agent_id. Iki tol API atmes šį priskyrimą su 400.

Jei įeinančius skambučius nukreipiate per konfigūracijos žiniatinklio kablį, o ne per fiksuotą inbound_agent_id, šis žiniatinklio kablys dabar gali kiekvienam skambučiui grąžinti timezone kartu su agent_id ir variables. Naudojant Bolt agentus, atliekant API įrašymo užklausas agentui taip pat galite nustatyti audio_tier, endpointing ir intelligence. API vis dar priima senesnį pavadinimą eagerness kaip endpointing sinonimą. Jei jūsų agentas naudoja API jungtis su trigger="call_start", ThunderPhone gali paleisti šiuos įrankius vieną kartą kiekvieno telefono skambučio pradžioje, prieš pasisveikinimą, naudodama jų išsaugotus call_start_arguments.

Perskambinimai į jūsų išeinančius skambučius

Kai kas nors perskambina numeriu, kuris jiems skambino per pastarąsias 30 dienų, atsiliepiantis agentas gauna trumpą kontekstinę pastabą apie tą skambutį: kada jis buvo atliktas, kurio agento ir kas įvyko (neatsiliepė, balso paštas arba pokalbis). Numeris be įeinančių skambučių agento siunčia tą pačią informaciją į jūsų konfigūracijos žiniatinklio kablį kaip returning_call. Jei tas numeris neturi žiniatinklio kablio, žiniatinklio kablio laikas baigiasi arba jis nepasiekiamas, skambutis nukreipiamas agentui, kuris atliko ankstesnį skambutį, užuot buvo nutrauktas. Skambintojo ID gali būti suklastotas, todėl ankstesnio skambučio suvestinė ir kintamieji bendrinami tik tada, jei administratorius įjungia Bendrinti ankstesnio skambučio informaciją skiltyje Organizacija → Bendrieji → Perskambinimai. Žr. Perskambinimai.

4. Priimkite skambutį

Paskambinkite numeriu iš savo telefono. Agentas atsiliepia, prisistato pagal jūsų raginimą ir prasideda pokalbis.

Kol skambutis vyksta, jis rodomas GET /v1/calls su status="in_progress". Jam pasibaigus, įrašas atnaujinamas laukais end_reason, duration_seconds, billable_minutes ir (vėliau) įrašo URL bei DI įvertinimu.

Įeinantys skambučiai įskaičiuojami į jūsų organizacijos vienu metu vykstančių skambučių limitą (pagal numatytuosius nustatymus – 20 vykstančių skambučių, bendras su išeinančiais, žiniatinklio ir bandomaisiais skambučiais). Skambutis, pasiekęs limitą, atmetamas prieš agentui atsiliepiant ir nutraukiamas, už jį neskaičiuojamas mokestis, o jis užregistruojamas kaip nepavykęs skambutis su pabaigos priežastimi concurrent_call_limit_reached. Rašykite support@thunderphone.com, jei jums reikia didesnio limito.

5. Peržiūrėkite rezultatus

Gaukite naujausių skambučių sąrašą:

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

Gaukite transkripciją:

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

Ir įrašo URL (trumpalaikis, pasirašytas):

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

Jei užsiprenumeravote telephony.complete žiniatinklio kablį, tuos pačius duomenis gausite kaip POST užklausą į savo serverį — žr. call.complete.

Jei jūsų agentui sukonfigūruoti duomenų išgavimo laukai, užbaigto skambučio duomenų pakete taip pat gali būti struktūrizuotų išgautų duomenų. Skambučių suvestinės rašomos jūsų organizacijos ThunderPhone naudojama kalba, nebent agentas nepaiso šio nustatymo.


Tolesni veiksmai