Tvarkykite įeinančius skambučius (API)

Standartinis „atsiliepti į skambutį naudojant DI“ procesas iš jūsų terminalo. Jūs:

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

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

1. Sukurkite agentą

Agentas apima raginimą, balsą ir produkto pakopą, kuri valdys skambutį. Visus konfigūracijos laukus rasite skiltyje Agentai; mažiausia reikalinga konfigūracija:

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 reikia tik numerio, kuriuo galėtumėte paskambinti, užsakykite demonstracinį 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 E.164 formato number. Demonstraciniai numeriai pradeda su status="provisioning" 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. Tame pačiame PATCH taip pat galite nustatyti outbound_agent_id, kad numeris būtų paruoštas ir skambinti į išorę.

4. Atsiliepkite į 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 laukais end_reason, duration_seconds, billable_minutes ir (galiausiai) įrašo URL bei DI įvertinimu.

5. Patikrinkite 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 transkriptą:

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į, gausite tuos pačius duomenis kaip POST užklausą į savo serverį — žr. call.complete.

Tolesni veiksmai