Spracovanie prichádzajúcich hovorov (API)

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

1. Vytvorte agenta s promptom a hlasom.
2. Zriaďte (alebo pridajte vlastné) telefónne číslo a priraďte agenta ako obsluhu prichádzajúcich hovorov.
3. Zavolajte na číslo. Skontrolujte denník hovorov, prepis a nahrávku.

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

1. Vytvorte agenta

Agent združuje 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 si vrátené id — budete ho potrebovať v kroku 2.

2. Získajte telefónne číslo

Ak potrebujete len číslo, na ktoré môžete zavolať, zriaďte si demo číslo 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. Demo čísla začínajú v stave status="provisioning" a v priebehu niekoľkých sekúnd sa stanú active — ak chcete sledovať tento prechod, dotazujte sa na GET /v1/phone-numbers/{id}.

3. Priraďte agenta

Priraďte agenta z kroku 1 k smeru prichádzajúcich hovorov daného čí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. Prijmite hovor

Zavolajte na číslo zo svojho telefónu. Agent zdvihne hovor, 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". Po jeho skončení sa záznam aktualizuje o end_reason, duration_seconds, billable_minutes a (neskôr) URL nahrávky a hodnotenie AI.

5. Skontrolujte výsledky

Načítajte zoznam nedávnych 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 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, dostanete rovnaké údaje ako POST na váš server — pozrite si call.complete.

Ďalšie kroky