ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Developer cookbook

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

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

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

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

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

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

Агент обједињује упит, глас и ниво производа који ће покретати позив. На агенту можете подесити и ограничења позива, као што су max_call_duration_seconds и ring_duration_seconds. За одлазне позиве можете подесити и max_hold_seconds да бисте ограничили колико дуго агент чека на чекању пре завршетка позива. Bolt агенти такође подржавају audio_tier, endpointing и intelligence за контролу начина на који слушају и одговарају: intelligence је core или pro, а audio_tier (слушање) је lite, standard, plus или max (Max није широко доступан). Старије вредности (lite и standard за intelligence; lean, hearing и deep_hearing за слушање) и даље се прихватају. Агенти са пуним дуплексом задржавају исти глас на подржаним језицима, па се промена гласа по језику не примењује на те позиве. Агенти такође подржавају intro_clip и intro_ring_count за репродукцију унапред снимљеног увода и до два звона пре него што агент проговори. Новим агентима је потребна и временска зона. Ако је Ваш агент вишејезичан, можете подесити language_switching да контролишете да ли пита пре промене језика или прати језик позиваоца. На агенту можете подесити и words да контролишете како изговара одређене термине и које термине препознаје. Погледајте Агенти за сва конфигурациона поља; најмање потребно је:

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

Сачувајте враћени 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 захтеву. До тада API одбија то додељивање са 400.

Ако усмеравате долазне позиве преко конфигурационог вебхука уместо фиксног inbound_agent_id, тај вебхук сада може да врати timezone за сваки позив, заједно са agent_id и variables. За Bolt агенте, приликом уписивања путем API-ја можете и да подесите audio_tier, endpointing и intelligence на агенту. API и даље прихвата старији назив eagerness као алијас за endpointing. Ако Ваш агент користи API везе са trigger="call_start", ThunderPhone може да покрене те алатке једном на почетку сваког телефонског позива, пре поздрава, користећи њихове сачуване call_start_arguments.

Повратни позиви на Ваше одлазне позиве

Када неко узврати позив на број који га је позвао у последњих 30 дана, агент који одговара добија кратку напомену са контекстом о том позиву: када је обављен, који агент га је упутио и шта се догодило (без одговора, говорна пошта или разговор). Број без агента за долазне позиве шаље исте детаље Вашем веб-хуку за конфигурацију као returning_call. Ако тај број нема веб-хук или веб-хук прекорачи време чекања или није доступан, позив се усмерава агенту који је упутио ранији позив уместо да се прекине. ИД позиваоца може бити лажиран, па се сажетак и променљиве ранијег позива деле само ако администратор укључи Делите детаље ранијег позива у оквиру Организација → Опште → Повратни позиви. Погледајте Повратни позиви.

4. Примите позив

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

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

Долазни позиви се рачунају у ограничење ваше организације за истовремене позиве (подразумевано 20 позива у току, заједнички за одлазне, веб и тест позиве). Позив који стигне када је ограничење достигнуто одбија се пре него што се агент јави и прекида се, не наплаћује се и бележи се као неуспешан позив са разлогом завршетка concurrent_call_limit_reached. Пошаљите е-поруку на support@thunderphone.com ако Вам је потребно веће ограничење.

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.

Ако Ваш агент има конфигурисана поља за издвајање, садржај завршеног позива може да садржи и структуриране издвојене податке. Сажетци позива пишу се на језику који Ваша организација користи у ThunderPhone-у, осим ако агент не замени то подешавање.


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