Sissetulevate kõnede haldamine (API)

Kanooniline „tehisintellektiga telefonile vastamise” protsess sinu terminalist. Sa:

1. lood juhise ja häälega agendi;
2. hangid (või tood kaasa) telefoninumbri ja määrad agendi selle sissetulevate kõnede töötlejaks;
3. helistad numbrile ning vaatad kõnelogi, transkriptsiooni ja salvestist.

API-kõnesid kokku: neli. Aega kokku: alla viie minuti.

1. Loo agent

Agent koondab juhise, hääle ja tootetaseme, mis kõnet juhivad. Kõigi seadistusväljade kohta vaata Agentide lehte; miinimum 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. sammus.

2. Hangi telefoninumber

Kui vajad lihtsalt numbrit, millele helistada, hangi demonumber ThunderPhone'i numbrite hulgast:

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. Demonumbrid algavad olekus status="provisioning" ja muutuvad mõne sekundi jooksul active-ks — ülemineku jälgimiseks küsi perioodiliselt GET /v1/phone-numbers/{id}, kui see on sulle oluline.

3. Määra agent

Seo 1. sammus loodud agent numbri sissetuleva kõnesuunaga:

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. Samas PATCH-päringus saad määrata ka outbound_agent_id, et number oleks valmis tegema ka väljaminevaid kõnesid.

4. Võta kõne vastu

Helista numbrile oma telefonist. Agent vastab kõnele, tutvustab end vastavalt sinu juhisele ja vestlus algab.

Kõne toimumise ajal kuvatakse see GET /v1/calls vastuses 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 tehisintellekti hinnanguga.

5. Vaata tulemused üle

Too hiljutiste kõnede loend:

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

Too transkriptsioon:

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.

Järgmised sammud