Обрађујте долазне позиве (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 скупа:

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. Демо бројеви почињу са 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 вебхук, примићете исте податке као POST захтев на Ваш сервер — погледајте call.complete.

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