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 apima raginimą, balsą ir produkto pakopą, kurie vykdys skambutį. Agente taip pat galite nustatyti skambučių ribas, pvz., max_call_duration_seconds ir ring_duration_seconds. Naujiems agentams taip pat reikia laiko juostos. Visus konfigūracijos laukus žr. skiltyje Agentai; minimalus variantas 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": "spark"
  }'

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 įeinamuosius skambučius nukreipiate per konfigūracijos žiniatinklio kablį, o ne per fiksuotą inbound_agent_id, šis žiniatinklio kablis dabar gali grąžinti kiekvieno skambučio timezone kartu su agent_id ir variables.

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 išgavimo laukai, užbaigto skambučio duomenyse taip pat gali būti struktūrizuoti išgauti duomenys.

Tolesni veiksmai#