Обрађујте долазне позиве (API)

Од почетка до краја: конфигуришите агента, доделите га броју телефона, примите позив и прегледајте транскрипт.

Стандардни ток „одговорите на телефон уз AI“, из Вашег терминала. Урадићете следеће:

1. Направите агента са упитом и гласом.
2. Обезбедите (или донесите) број телефона и доделите агента као његовог обрађивача долазних позива.
3. Позовите број. Прегледајте евиденцију позива, транскрипт и снимак.

Укупно API позива: четири. Укупно време: мање од пет минута.

1. Направите агента#

Агент обједињује упит, глас и ниво производа који ће водити позив. Погледајте Агенти за сва поља конфигурације; минимум је:

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

Сачувајте враћени id — биће Вам потребан у кораку 2.

2. Набавите број телефона#

Ако Вам је само потребан број који можете да позовете, набавите ThunderPhone број из 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"}'

Одговор садржи id и number у формату E.164. ThunderPhone бројеви почињу са status="provisioning" и постају active у року од неколико секунди — периодично позивајте GET /v1/phone-numbers/{id} да бисте пратили прелаз ако Вам је то важно.

3. Доделите агента#

Повежите агента из корака 1 са долазним смером броја:

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

То је све — број је активан. Такође можете да поставите outbound_agent_id у истом PATCH захтеву, тако да број буде спреман и за одлазне позиве.

4. Прихватите позив#

Позовите број са свог телефона. Агент се јавља, представља се према Вашем упиту и разговор почиње.

Док је позив у току, појављује се у GET /v1/calls са status="in_progress". Када се заврши, запис се ажурира пољима end_reason, duration_seconds, billable_minutes и (на крају) URL-ом снимка и AI оценом.

5. Прегледајте резултате#

Преузмите листу недавних позива:

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

Преузмите транскрипт:

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

И URL снимка (краткотрајан, потписан):

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

Ако сте се претплатили на telephony.complete webhook, примићете исте податке као POST на Ваш сервер — погледајте call.complete.

Следећи кораци#