Spracovanie prichádzajúcich hovorov (API)

Kompletný postup: nakonfigurujte agenta, priraďte ho k telefónnemu číslu, prijmite hovor a skontrolujte prepis.

Štandardný postup „odpovedať na telefón pomocou AI“ z vášho terminálu. Budete:

1. Vytvoríte agenta s promptom a hlasom.
2. Zriadite (alebo prinesiete) telefónne číslo a priradíte agenta ako jeho obsluhu prichádzajúcich hovorov.
3. Zavoláte na číslo. Skontrolujete protokol hovoru, prepis a nahrávku.

Celkový počet volaní API: štyri. Celkový čas: menej ako päť minút.

1. Vytvorenie agenta#

Agent spája prompt, hlas a produktovú úroveň, ktoré budú riadiť hovor. Všetky konfiguračné polia nájdete v časti Agenti; minimum je:

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"
  }'

Uložte vrátené id — budete ho potrebovať v kroku 2.

2. Získanie telefónneho čísla#

Ak potrebujete iba číslo, na ktoré môžete volať, získajte číslo ThunderPhone z fondu ThunderPhone:

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"}'

Odpoveď obsahuje id a number vo formáte E.164. Čísla ThunderPhone začínajú v stave status="provisioning" a do niekoľkých sekúnd sa stanú active — ak chcete sledovať tento prechod, periodicky volajte GET /v1/phone-numbers/{id}.

3. Priradenie agenta#

Priraďte agenta z kroku 1 k prichádzajúcemu smeru čísla:

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}'

To je všetko — číslo je aktívne. V tom istom požiadavku PATCH môžete nastaviť aj outbound_agent_id, aby bolo číslo pripravené aj na odchádzajúce hovory.

4. Prijatie hovoru#

Zavolajte na číslo zo svojho telefónu. Agent hovor prijme, predstaví sa podľa vášho promptu a konverzácia sa začne.

Kým hovor prebieha, zobrazí sa v GET /v1/calls so stavom status="in_progress". Keď sa skončí, záznam sa aktualizuje o end_reason, duration_seconds, billable_minutes a (neskôr) adresu URL nahrávky a hodnotenie AI.

5. Kontrola výsledkov#

Načítajte zoznam posledných hovorov:

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

Získajte prepis:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

A adresu URL nahrávky (krátkodobá, podpísaná):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ak ste sa prihlásili na odber webhooku telephony.complete, rovnaké údaje dostanete ako požiadavku POST na váš server — pozrite si call.complete.

Ďalšie kroky#