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ą.

Kanoninis „atsiliepti į telefoną naudojant DI“ procesas iš jūsų terminalo. Jūs:

1. Sukursite agentą su raginimu ir balsu.
2. Užsakysite (arba atsinešite) telefono numerį ir priskirsite agentą jo įeinančių skambučių tvarkytuvu.
3. Paskambinsite numeriu. Peržiūrėsite skambučių žurnalą, transkripciją ir įrašą.

Iš viso API užklausų: keturios. Bendra trukmė: mažiau nei penkios minutės.

1. Sukurkite agentą#

Agentas apima raginimą, balsą ir produkto pakopą, kurie valdys skambutį. Visus konfigūracijos laukus žr. Agentai; mažiausiai reikia:

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ų turi status="provisioning" būseną ir per kelias sekundes tampa active — jei reikia, stebėkite pokytį 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. Tame pačiame PATCH taip pat galite nustatyti outbound_agent_id, kad numeris būtų paruoštas ir išeinantiems skambučiams.

4. Priimkite skambutį#

Paskambinkite numeriu iš savo telefono. Agentas atsilieps, prisistatys pagal jūsų raginimą ir prasidės pokalbis.

Kol vyksta skambutis, jis rodomas GET /v1/calls su status="in_progress". Jam pasibaigus, įrašas atnaujinamas nurodant end_reason, duration_seconds, billable_minutes ir (vėliau) įrašo URL bei DI įvertinimą.

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 (trumpalaikį, pasirašytą):

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.

Tolesni veiksmai#