Sissetulevate kõnede haldamine (API)

Täislahendus: seadista häälagent, määra see telefoninumbrile, võta kõne vastu ja vaata transkripti.

Kanoniline „vasta telefonile AI abil“ voog sinu terminalist. Sa:

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

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

1. Loo agent#

Agent koondab viiba, hääle ja tootetaseme, mis kõnet juhivad. Kõigi seadistusväljade kohta vaata agente; 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. 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 E.164 vormingus id-d ja number-it. ThunderPhone'i numbrite algne status="provisioning" muutub mõne sekundi jooksul väärtuseks active — kui see on oluline, jälgi muutust päringuga GET /v1/phone-numbers/{id}.

3. Määra agent#

Seo 1. etapis 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 ka väljuvateks kõnedeks.

4. Võta kõne vastu#

Helista numbrile oma telefonist. Agent vastab, tutvustab end vastavalt sinu viibale ja 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.

5. Kontrolli tulemusi#

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 samad andmed POST-päringuna oma serverisse — vaata call.complete.

Järgmised sammud#