Sissetulevate kõnede haldamine (API)

Täisprotsess: seadista häälagent, määra see telefoninumbrile, vasta kõnele ja vaata transkripti.

Kanoniline tehisintellektiga telefonikõnele vastamise voog sinu terminalist. Teed järgmist:

1. Lood viiba ja häälega häälagendi.
2. Hangid (või tood kaasa) telefoninumbri ja määrad häälagendi selle sissetulevate kõnede töötlejaks.
3. Helistad numbrile. Vaatad kõnelogi, transkriptsiooni ja salvestist.

API-päringuid kokku: neli. Aega kokku: alla viie minuti.

1. Loo häälagent#

Agent koondab kõnet juhtiva juhise, hääle ja tootetaseme. Agendil saad määrata ka kõnepiirangud, näiteks max_call_duration_seconds ja ring_duration_seconds. Väljuvate kõnede puhul saad määrata ka max_hold_seconds, et piirata aega, mille agent enne kõne lõpetamist ootel veedab. Bolt agentidel on ka tugi audio_tier, endpointing ja intelligence jaoks, et juhtida nende kuulamist ja vastamist. intelligence toetab väärtusi lite ja standard. Agentidel on ka tugi intro_clip ja intro_ring_count jaoks, et esitada salvestatud sissejuhatus ja kuni kaks helinat enne, kui agent rääkima hakkab. Uued agendid vajavad ka ajavööndit. Kui sinu agent on mitmekeelne, saad määrata language_switching, et juhtida, kas agent küsib enne keele vahetamist või järgib helistaja keelt. Samuti saad agendil määrata words, et juhtida konkreetsete terminite hääldamist ja seda, milliseid termineid agent tuvastab. Kõigi seadistusväljade kohta vaata Agendid; minimaalne seadistus on:

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

Salvesta tagastatud id — vajad seda 2. etapis.

2. Hangi telefoninumber#

Kui vajad lihtsalt numbrit, millele helistada, hangi ThunderPhone'i number ThunderPhone'i numbripargist:

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

Vastus sisaldab id-d ja E.164 vormingus number-it. ThunderPhone'i numbrid algavad olekuga status="provisioning" ja muutuvad mõne sekundi jooksul olekusse active — kui see on oluline, jälgi üleminekut päringuga GET /v1/phone-numbers/{id}.

3. Määra häälagent#

Seo 1. etapis loodud häälagent numbri sissetuleva suunaga:

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

See ongi kõik — number on aktiivne. Kui sinu organisatsioonile on väljaminevate kõnede võimalus heaks kiidetud, saad samas PATCH-päringus määrata ka outbound_agent_id. Seni lükkab API selle määrangu tagasi koodiga 400.

Kui suunad sissetulevad kõned fikseeritud inbound_agent_id asemel konfiguratsiooni veebikonksu kaudu, saab see veebikonks nüüd koos agent_id ja variables-iga tagastada iga kõne jaoks eraldi timezone. Bolt agentide puhul saad API kirjutustaotlustes määrata agendile ka audio_tier, endpointing ja intelligence. API aktsepteerib endiselt vanemat nime eagerness kui endpointing aliast. Kui sinu agent kasutab API-ühendusi atribuudiga trigger="call_start", saab ThunderPhone need tööriistad käivitada iga telefonikõne alguses üks kord, enne tervitust, kasutades nende salvestatud call_start_arguments.

Tagasihelistamised sinu väljuvatele kõnedele#

Kui keegi helistab tagasi numbrile, mis helistas talle viimase 30 päeva jooksul, saab vastav häälagent selle kõne kohta lühikese taustateabe: millal kõne tehti, milline agent selle tegi ja mis juhtus (vastust ei olnud, kõnepost või vestlus). Ilma sissetuleva agendita number saadab samad andmed sinu konfiguratsiooni webhooki väärtusena returning_call. Kui sellel numbril pole webhooki või webhook aegub või pole kättesaadav, suunatakse kõne lõpetamise asemel agendile, kes tegi varasema kõne. Helistaja numbrit saab võltsida, seega jagatakse varasema kõne kokkuvõtet ja muutujaid ainult siis, kui administraator lülitab Organisatsioon → Üldine → Tagasihelistamised sisse valiku Jaga varasema kõne üksikasju. Vaata Tagasihelistamised.

4. Võta kõne vastu#

Helista numbrile oma telefonilt. Häälagent vastab, tutvustab end sinu viiba järgi ning vestlus algab.

Kõne ajal kuvatakse see päringus GET /v1/calls olekuga status="in_progress". Kui kõne lõpeb, uuendatakse kirjet väljadega end_reason, duration_seconds, billable_minutes ning (hiljem) salvestise URL-i ja AI-hindega.

Sissetulevad kõned arvestatakse sinu organisatsiooni samaaegsete kõnede limiidi hulka (vaikimisi 20 aktiivset kõnet, ühine väljaminevate, veebi- ja testkõnedega). Limiidi täitumisel saabuv kõne lükatakse tagasi enne, kui häälagent vastab, ja lõpetatakse, selle eest tasu ei võeta ning see salvestatakse ebaõnnestunud kõnena lõpp-põhjusega concurrent_call_limit_reached. Kui vajad suuremat limiiti, saada e-kiri aadressile support@thunderphone.com.

5. Kontrolli tulemusi#

Too viimaste kõnede loend:

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

Hangi transkript:

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

Ja salvestise URL (lühiajaline, allkirjastatud):

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

Kui tellisid telephony.complete veebikonksu, saad sama teabe POST-päringuna oma serverisse — vaata call.complete.

Kui sinu agendil on ekstraktimisväljad seadistatud, võib lõpetatud kõne andmekoormus sisaldada ka struktureeritud ekstraktitud andmeid.

Järgmised sammud#