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 ühendab kõnet juhtiva viiba, hääle ja tootetaseme. Agendil saad määrata ka kõnepiirangud, näiteks max_call_duration_seconds ja ring_duration_seconds. Agendid toetavad ka intro_clip-i ja intro_ring_count-i, et esitada enne agendi kõnelemist eelsalvestatud sissejuhatus ja kuni kaks helinat. Uued agendid vajavad ka ajavööndit. Kõigi seadistusväljade kohta vaata Agendid; minimaalne nõutav 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 tagastada iga kõne jaoks timezone koos väärtustega agent_id ja variables.

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#