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

Webhooks

telephony.incoming / web.incoming

Блокирајући вебхук који у реалном времену одређује конфигурацију долазног позива.

Када долазни телефонски позив стигне на број без додељеног агента (погледајте Повратни позиви за позиваоце који узвраћају ваше одлазне позиве), или када сесија веб виџета започне на објављивом кључу у mode="webhook", ThunderPhone шаље блокирајући захтев telephony.incoming / web.incoming на ваш застарели URL веб-хука и чека одговор са конфигурацијом: до 13 секунди за телефонски позив, укључујући један поновни покушај, и до 10 секунди за сесију виџета (погледајте Временска ограничења и поновни покушаји). Користите ову размену да бисте динамички бирали упит, глас и алате за сваки позив — погледајте водич за динамичку конфигурацију позива за образац од почетка до краја.

Број са додељеним агентом одговара преко тог агента. Када агент има сопствени вебхук за подешавање позива, иста блокирајућа размена се прво извршава на URL-у агента, како би се попуниле променљиве агента и контекст позива.

Истек времена и поновни покушаји

Одговорите брзо: позивалац чека на линији док одлучујете.

За телефонски позив (telephony.incoming):

  • Први покушај може трајати до 10 секунди.
  • Ако истекне време, не може да се повеже или добије одговор 5xx, 408 или 429, ThunderPhone покушава још једном. Поновни покушај добија преостали део рока од 13 секунди за целокупну размену: око 3 секунде након првог покушаја ком је истекло време, а скоро свих 13 након брзог неуспеха. Нема поновног покушаја ако би преостало мање од 2 секунде.
  • Сваки други одговор 4xx, одговор који премашује ограничење величине или одговор 2xx чије тело није важећа конфигурација је коначан и не покушава се поново.
  • Оба покушаја шаљу исто тело, исти заглавље X-ThunderPhone-Signature и исто заглавље X-ThunderPhone-Idempotency-Key (telephony-incoming-<call_id>), тако да обрађивач који има нежељена дејства може да препозна поновни покушај.

Ако не стигне употребљива конфигурација, позив се одмах прекида уместо да позивалац остане на тихој линији. У историји позива се приказује као неуспео позив који се не наплаћује, са end_reason inbound_config_webhook_failed, и шаље се уобичајени догађај telephony.complete. Страница позива на контролној табли и config_webhook_failure у GET /v1/calls/{call_id} наводе шта је Ваш вебхук урадио: {kind, attempts, http_status, host, source}, при чему kind може бити http_error, timeout, connection, dns, tls, response_too_large, blocked_url, other, invalid_json, non_object_json или invalid_config, host је име хоста Вашег вебхука, а source је number (овај вебхук) или agent_setup (вебхук за подешавање позива агента). За invalid_config, reason наводи зашто одговор није могао да се употреби, а fields именује поља на која се то односи: no_agent (ни agent_id ни prompt; fields наводи кључеве који су занемарени, као што је погрешно написан agentId), agent_not_found, agent_id_not_integer, unexpected_fields (кључеви осим variables, context, timezone и language поред agent_id), invalid_variables, invalid_context, invalid_language, unsupported_language, invalid_config_fields или agent_settings_invalid. У супротном је reason null, а fields је празно. Једини изузетак је када позивалац узвраћа један од Ваших одлазних позива, а сама размена није успела: погледајте Узвратни позиви.

Сесија виџета (web.incoming) добија један покушај у трајању до 10 секунди. Ако не успе, захтев за сесију не успева са 502 или 422.

Тело захтева

За телефонске позиве (telephony.incoming):

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567"
  }
}
ПољеТипОпис
call_idцео бројID позива — непромењив у свим догађајима за овај позив
from_numberнискаE.164 број позиваоца
to_numberнискаE.164 одредиште (један од Ваших ThunderPhone бројева)
returning_callобјекатПрисутно само када је овај број позвао позиваоца у последњих 30 дана. Погледајте Узвратни позиви
sip_headersобјекатПрисутно само када је позив пристигао преко ручне SIP везе са X-* или User-to-User SIP заглављима: назив заглавља малим словима → вредност. Погледајте SIP заглавља

За сесије веб виџета (web.incoming), data идентификује страницу за уграђивање уместо телефонских бројева:

{
  "type": "web.incoming",
  "data": {
    "call_id": 987654322,
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2"
  }
}
ПољеТипОпис
call_idцео бројИД позива
origin_domainнискаПорекло странице на којој је виџет хостован, онако како га је прегледач послао. Клијент који није прегледач може послати било коју вредност, зато ово не сматрајте доказом одакле је захтев дошао
publishable_key_prefixнискаПрви знакови јавног кључа који је отворио сесију
language, primary_languageнискаПрисутно када је сесија виџета захтевала замену језика
voiceнискаПрисутно када је сесија виџета захтевала замену гласа
website_contextнискаПрисутно када је виџет проследио контекст странице за појединачну сесију

Поља за замену (language, voice, website_context и све прегледачке variables) стижу само када их јавни кључ дозвољава у својим заменама из прегледача. Захтев за сесију који садржи поље које кључ не дозвољава одбија се пре позивања овог вебхука.


Шема одговора

Вратите JSON објекат који описује конфигурацију агента за овај позив. prompt и voice су обавезни; све остало је опционо.

{
  "prompt":  "You are a helpful booking assistant for Acme Restaurant.",
  "voice":   "john",
  "product": "spark",
  "background_track": null,
  "tools":   []
}
ПољеТипОбавезноОпис
promptнискадаСистемско упутство које управља агентом
voiceнискадаID гласа из GET /v1/voices, нпр. john. voice_name је прихваћен као псеудоним. Непознати гласови не пролазе валидацију и позив се одбија
productнисканеПошаљите bolt. Подразумевана вредност је spark, старија вредност која је и даље прихваћена уз storm-base, storm-base-with-ack, storm-extra и storm-extra-with-ack
thinking_levelнисканеminimal, base (подразумевано) или extra. За старије вредности производа storm-*, storm-extra* намеће extra, а други storm-* намећу base
audio_context_modeнисканеfull (подразумевано) или reduced
watchdog_enabledлогичка вредностнеОмогућите надзор за овај позив. Подразумевана вредност је false
additional_audio_contextлогичка вредност | nullнеУкључите последњих неколико редова аудио-записа позиваоца уместо само најскоријег реда, чиме се побољшавају исправке и прикупљање података са много слова или бројева, уз мало веће кашњење и трошак. Подразумевано је укључено за долазне сесије, а искључено за одлазне телефонске позиве; null задржава подразумевану вредност
storm_feedback_modeнисканеnone, acknowledgement (подразумевано) или tick: оно што позивалац чује док се припрема спорији одговор када је audio_tier plus или max
languageнисканеСкраћеница за primary_language. Дозвољено је и поред agent_id, где означава језик на којем овај позив почиње, изговорен гласом агента за тај језик; погледајте Подесите језик за сваки позив
primary_languageнисканеКôд језика, нормализован (подразумевано en). Кôдови који се не могу разрешити одбијају позив
has_additional_languagesлогичка вредностнеПодразумевана вредност је false
additional_languagesниз нискинеДодатни језици на које агент може да пређе
native_voice_switchingлогичка вредностнеПодразумевана вредност је false. Када позив пређе на други језик, замените глас гласом изворног говорника тог језика (усклађеним по полу) уместо да задржите подешени глас
language_switchingниска | nullнеask_first (подразумевано) или follow_caller; null је исто што и ask_first. Одређује како вишејезични агент поступа када друга особа говори неки други његов језик. ask_first одмах прелази када особа затражи језик или изговори целу реченицу на њему, а након нечег кратког, као што је „да“, пита да ли да настави на том језику. follow_caller прелази на било који подешени језик којим особа говори, чак и ако је у питању само једна реч. Примењује се само када је подешено additional_languages
audio_tierниска | nullнеСамо за product: "bolt". Слушање: колико пажљиво агент чује позиваоца. standard (подразумевано; "" и null имају исто значење) одговара већини позива (позиви који обрађују PHI користе само добављаче покривене BAA уговором). lite је најјефтинији и чешће погрешно чује. plus пажљивије слуша у тешким редовима разговора, за које је потребно око 1–2 секунде више. max је за најтежи аудио и ретке језике; сваки одговор траје 3–4 секунде, а позив користи pro интелигенцију (intelligence се занемарује). max није опште доступан: за организацију за коју није омогућен, позив користи plus и intelligence који наведете (захтев за одлазни позив са овом вредношћу се одбија уз 400). Старије вредности lean (Lite), hearing (Plus) и deep_hearing (Max) су и даље прихваћене. Други производи ово занемарују
endpointingниска | nullнеfaster (200 ms), fast (300 ms), normal (500 ms, подразумевано) или patient (800 ms); null је исто што и normal. Одређује колико дуго Bolt v2 агент чека након што позивалац престане да говори пре него што затражи одговор од модела. Краће чекање може да одговори раније, али шаље више захтева које следеће речи позиваоца застаревају, што повећава трошак модела. Други производи ово занемарују
eagernessниска | nullнеЗастарело: назив за endpointing до 19. октобра 2026, који се и даље чита. Занемарује се када је подешено endpointing
intelligenceниска | nullнеcore или pro (подразумевано); null је исто што и pro. Одређује колико поуздано bolt агент у Bolt v2 процесу прати своја упутства. core има око 700 ms до прве речи, најјефтинији је и нешто мање поуздан (за позиве који се третирају као PHI, око 900 ms и мање је поуздан); pro има око 900 ms; Core одговори који би само позвали алат предају се Pro-у. Старије вредности lite (Core) и standard (Pro) су и даље прихваћене, а повучене вредности plus и max раде на pro. Занемарује се када је audio_tier max. Други производи ово занемарују
faster_repliesлогичка вредност | nullнеУбрзање. Подразумевана вредност је true. За bolt агента у Bolt v2 процесу, одговори почињу нешто раније, уз мало већи трошак. false то искључује. Други производи ово занемарују
background_trackниска | nullнеID амбијенталног аудио-записа или null
acknowledgement_prompt_modeнисканеauto (подразумевано) или manual (старије вредности производа -with-ack)
acknowledgement_promptнисканеКористи се када је acknowledgement_prompt_mode="manual"
silence_interval_secondsцео број | nullне5–120. Секунде тишине позиваоца пре провере
silence_max_checkinsцео број | nullне1–10
silence_checkins_enabledлогичка вредностнеПодразумевана вредност је true
silence_final_actionнисканеНакон последње провере: hang_up (подразумевано) или transfer на silence_transfer_destination
silence_transfer_destinationнисканеНазив уноса у transfer_destinations ове конфигурације; обавезно уз transfer. Без transfer_destinations пренос не може да се изврши и агент прекида позив
silence_final_messageнискане≤ 300 знакова, чита се онако како је написано; "" (подразумевано) користи подразумевану поруку
connect_tone_enabledлогичка вредностнеПодразумевана вредност је false
pronunciation_dictsлогичка вредност | nullнеПодразумевана вредност је false; null је исто што и false. Када је true, Cartesia говор у позиву користи ThunderPhone речник изговора за језик позива, када он постоји. Ради за телефонске позиве и позиве из виџета. Примењује се само на ThunderPhone сопствене Cartesia гласове, не и на гласове на вашем сопственом Cartesia API кључу. Не користи се са agent_id, где се примењују подешавања сачуваног агента
wordsниз | nullнеОдређује како агент изговара одређене речи, са истим уносима као words агента без support. Унос без language користи језик ове конфигурације. null и [] значе да нема уноса. Не користи се са agent_id, где се примењују речи сачуваног агента
voicemail_actionнисканеprompt (подразумевано), hangup или message
voicemail_messageнисканеКористи се када је voicemail_action="message"
agent_nameнисканеПриказано име које се пријављује контролним таблама и виџету
org_nameнисканеПриказано име организације за персону агента
toolsнизнеУметнуте шеме функционалних алата (погледајте Функционални алати)
transfer_destinationsниз објеката | nullнеДо 50 уноса {name, number} на које овај позив може да се пренесе, валидираних као бројеви за пренос агента. Агент преноси по имену и само на ове уносе; [] значи да нема преноса. Изоставите ово или пошаљите null да бисте омогућили агенту да пренесе на број који сам изабере
timezoneнисканеIANA временска зона за овај позив, као што је America/Chicago. Агент наводи датум и време у њој, испред сопствене временске зоне агента. Дозвољено је и поред agent_id. Вредности које нису IANA зоне се занемарују. Погледајте Подесите временску зону за сваки позив
contextниска | nullнеТекст слободног облика за овај позив, као што су белешке које је прикупио ваш систем, до 20.000 знакова. Додаје се после упутства у ограниченом блоку и не приказује се као шаблон. Дозвољено је и поред agent_id. Вредност која није ниска или је дужа одбија позив. Погледајте променљиве позива и контекст
call_idцео бројнеОпциони одјек ID-ја позива из захтева; занемарује се

Пошто су prompt и voice обавезни, враћање {} или било ког одговора који не прође валидацију одбија позив: телефонски позив се прекида како је описано у Временска ограничења и поновни покушаји, а захтев за сесију виџета не успева са кодом 422. Ово важи и за позиваоце који поново зову: сваки JSON објекат који Ваш веб-хук врати је његов одговор, а {} је начин да одбијете позив.


Веб-хук за подешавање позива агента

Агент може имати сопствени веб-хук за подешавање позива: поље Веб-хук за подешавање позива у његовим подешавањима или call_setup_webhook_url у API-ју. Доделите агента броју и, пре сваког долазног позива на тај број на који се агент јавља, ThunderPhone од веб-хука тражи променљиве и контекст тог позива. Број задржава свог агента, па страница бројева телефона и страница агента приказују који агент се јавља на њега.

Ово је подешавање као и остала подешавања агента: припрема се као нацрт, објављује при постављању и чува у историји верзија. Број закачен за старију верзију тражи URL те верзије. Захтеви се потписују сопственом вредношћу агента call_setup_webhook_signing_secret (а не тајном веб-хука организације), са истим заглављем X-ThunderPhone-Signature, временским ограничењима, поновним покушајима и кључем идемпотентности као горе. Тајна је само за упис: поставите ону коју ваша крајња тачка проверава (у подешавањима агента или помоћу PATCH /v1/agents/{id}); ниједан захтев за читање је не враћа, а call_setup_webhook_signing_secret_set показује да ли је постављена.

Захтев је претходно наведени telephony.incoming пакет података, уз агента који попуњава:

{
  "type": "telephony.incoming",
  "data": {
    "call_id":     987654321,
    "from_number": "+14155550199",
    "to_number":   "+15551234567",
    "variables":   null,
    "agent": {
      "id": 12,
      "name": "Front desk",
      "version": 7,
      "version_pinned": false
    }
  }
}
ПољеТипОпис
agent.idцео бројАгент додељен броју
agent.nameнискаЊегово име
agent.versionцео број | nullБрој верзије која ће се јавити: верзија закачена за број или, у супротном, најновија објављена верзија агента (null ако је нема)
agent.version_pinnedлогичка вредностДа ли је број закачен за ту верзију

Одговорите оним што је позиву потребно. Било шта од следећег попуњава додељеног агента, у верзији броја:

  • {"variables": {...}}, {"context": "..."} или обоје
  • исто, са "agent_id" постављеним на ID додељеног агента
  • {}: агент се јавља без попуњених вредности

timezone и language су такође дозвољени, као уз agent_id. Променљиве попуњавају агентова {{placeholders}}; контекст се додаје после упита.

Или сами одлучите о позиву. agent_id другог агента или потпуна конфигурација са prompt одговара на овај позив уместо додељеног агента (и његове закачене верзије). Детаљи позива означавају сваки случај у call_setup_webhook: assigned_agent, other_agent или inline_config. Одговор који не може да се употреби (непознат agent_id, други кључеви поред variables, конфигурација која не пролази проверу) прекида позив као и код веб-хука броја.

Када веб-хук мора да одговори. Агенту је потребан његов веб-хук када његова подешавања користе {{variable}} без подразумеване вредности: у његовом упиту или поновно употребљивим упутствима, упутствима или редовима корака, упиту за потврду, поруци говорне поште, обавештењу о пристанку или броју за преусмеравање {{variable}}. call_setup_webhook_variables агента их наводи.

  • Потребан му је веб-хук: када веб-хук прекорачи временско ограничење, не може да се досегне или одговори грешком или телом које није JSON објекат, позив се не покреће, чак и када позив већ садржи вредност за једну од тих променљивих. Прекида се и бележи тачно како је описано у Временским ограничењима и поновним покушајима (end_reason inbound_config_webhook_failed, без наплате).
  • Ништа му није потребно (нема променљивих или свака има подразумевану вредност као {{first_name|there}}): веб-хук се и даље извршава, али када не успе, агент се јавља без њега, а детаљи позива приказују webhook_failed са узроком.

Сам контекст позива никада не чини вебхук обавезним: ништа у подешавањима агента не наводи да му је потребан контекст. Користите променљиву без подразумеване вредности ако позив не сме да почне без одговора вашег вебхука.

Додељивање и објављивање. Агент коме је потребан вебхук не може бити додељен броју без њега: додељивање се одбија уз поруку која наводи променљиве. Иста провера се покреће када се промени верзија броја, укључујући случај када се закачени број врати на Најновију верзију. Док одговара на број са својим објављеним подешавањима, објављивање које додаје такву променљиву без вебхука (или уклања вебхук) одбија се на исти начин. Чување нацрта је увек дозвољено, а warnings агента садржи call_setup_webhook_needed док се проблем не отклони.

Вебхук агента покреће се само за долазне телефонске позиве на бројевима којима је додељен. Одлазни позиви, сесије веб-виџета, SIP адресе, симулације и тестни разговори на контролној табли га не позивају; њихове променљиве се и даље преузимају из захтева.

Тестирање са сачуваним примерима. Да бисте тестирали како се Ваш гласовни агент понаша са датим одговором (поновни позивалац, запис није пронађен, говорник шпанског), сачувајте тај одговор за агента као пример: његове variables, context и, по избору, language, унесене или копиране из претходног позива. Изаберите га када покренете тестни разговор на контролној табли, тестни позив на Ваш телефон или симулацију за агента, а позив се извршава као да је Ваш вебхук одговорио тим примером. Примере деле све верзије агента. Уређивањем примера задржавате његове раније верзије: када је за измену агента потребна променљива коју пример не поставља, додајте је у пример, а старије верзије агента настављају да користе пример онакав какав је био. Симулације које позивају телефонски број уместо тога покрећу Ваш стварни вебхук.

Бројеви без додељеног агента настављају да користе вебхук броја или организације, тачно како је горе описано.


Повратни позиви

Људи често узвраћају позив на број који их је позвао, на пример након што је Ваш агент оставио говорну поруку. Када стигне телефонски позив од некога чији је број позван у последњих 30 дана, ThunderPhone проналази најскорији такав одлазни позив (онај који је зазвонио на њиховом телефону) и користи га на три начина:

  1. returning_call у захтеву. Горњи блокирајући захтев и обавештење крајње тачке га садрже, тако да Ваш обрађивач може да усмери позиваоца:

    {
      "type": "telephony.incoming",
      "data": {
        "call_id": 987654321,
        "from_number": "+14155550199",
        "to_number": "+15551234567",
        "returning_call": {
          "call_id": 987650001,
          "agent_id": 13,
          "started_at": "2026-10-21T19:05:12.402Z",
          "outcome": "voicemail"
        }
      }
    }
    ПољеТипОпис
    call_idцео бројРанији одлазни позив
    agent_idцео број | nullАгент који га је упутио; null за позив упућен са уграђеном конфигурацијом или чији је агент обрисан
    started_atнискаВреме почетка (ISO 8601, UTC)
    outcomeнискаno_answer (звонио је до истека, био је заузет или је одбијен), voicemail (јавила се говорна пошта или нико није разговарао са агентом), conversation (неко је разговарао са агентом) или answered (на позив је одговорено; још није познато ко је одговорио)
  2. Контекст за агента. Агент који се јави добија кратку напомену на крају свог упита: када је ранији позив упућен, који агент га је упутио и какав је био његов исход. Агенту је наложено да је не чита наглас и да, пошто се идентификација позиваоца може лажирати, не дели ништа о том позиву осим да је број раније позван.

  3. Резервни агент. Када број нема агента за долазне позиве и не стигне конфигурација зато што не постоји URL вебхука или Ваш вебхук није дао одговор (истекло му је време, није био доступан или је одговорио са 5xx, 408 или 429 у оба покушаја), позив се уместо прекида прослеђује агенту који је упутио ранији позив, све док тај агент и даље постоји у Вашој организацији. Покреће се са објављеним подешавањима тог агента. Сваки одговор који Ваш вебхук врати и даље је пресудан: други 4xx, тело које није JSON објекат, {} или конфигурација која не прође проверу доводи до прекида позива као и раније. Агент за долазне позиве на броју увек се јавља.

Дељење детаља ранијег позива. Идентификација позиваоца може бити лажирана, па подразумевано ништа из садржаја ранијег позива не доспева до новог. Администратор организације може да укључи Делите детаље ранијег позива у оквиру Организација → Опште → Повратни позиви (или да подеси callback_context_details_enabled). Када је опција укључена, напомена за агента такође наводи сажетак ранијег позива, а позив усмерен агенту који је упутио ранији позив користи variables тог позива (као што је име контакта). Укључите је само ако је безбедно делити те детаље са било ким ко позове са тог броја. Чак и када је укључена, позив који може да садржи заштићене здравствене информације никада не прослеђује свој сажетак или променљиве позиву који није означен као позив који обрађује PHI.

У детаљима позива. Долазни позив који се подудара са ранијим позивом има објекат callback у GET /v1/calls/{call_id}: returning_call изнад, routed_as_callback (да ли је резервни агент одговорио на њега) и config_webhook_failure ({kind, attempts, http_status, host} када Ваш вебхук није дао одговор, а резервни агент је преузео позив, иначе null), тако да је прекид вебхука и даље видљив иако је на позив одговорено.


Ограничење величине одговора


Пример обрађивача

Python (FastAPI)
import hashlib
import hmac
import json
import os
 
from fastapi import FastAPI, HTTPException, Request
 
app = FastAPI()
WEBHOOK_SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
 
def verify(body: bytes, signature: str) -> bool:
    expected = hmac.new(WEBHOOK_SECRET.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")
 
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
    body = await request.body()
    if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
        raise HTTPException(status_code=401)
 
    event = json.loads(body)
    if event["type"] == "telephony.incoming":
        caller = event["data"]["from_number"]
        prompt = (
            "Greet the caller as a San Francisco local…"
            if caller.startswith("+1415")
            else "You are a friendly customer support agent…"
        )
        return {
            "prompt": prompt,
            "voice": "john",
            "product": "spark",
        }
    if event["type"] == "web.incoming":
        return {
            "prompt": "You are the website's helpful voice assistant…",
            "voice": "john",
            "product": "spark",
        }
    return {}
Node.js (Express)
import crypto from "node:crypto";
import express from "express";
 
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
 
function verify(body, signature) {
  const expected = crypto
    .createHmac("sha256", SECRET)
    .update(body)
    .digest("hex");
  return signature &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
 
app.post(
  "/thunderphone-webhook",
  express.raw({ type: "application/json" }),
  (req, res) => {
    if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
      return res.sendStatus(401);
    }
    const event = JSON.parse(req.body.toString("utf8"));
 
    if (event.type === "telephony.incoming" || event.type === "web.incoming") {
      const caller = event.data.from_number || "web";
      const prompt = caller.startsWith("+1415")
        ? "Greet the caller as a San Francisco local…"
        : "You are a friendly customer support agent…";
      return res.json({
        prompt,
        voice: "john",
        product: "spark",
      });
    }
    res.json({});
  },
);

Одговор са функционалним алаткама

Прикачите алатке како би AI могао да позива Ваше API-је током разговора:

{
  "prompt":  "You are a booking assistant. Use the available tools to help customers schedule appointments.",
  "voice":   "john",
  "product": "spark",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_appointments",
        "description": "Find available appointment slots",
        "parameters": {
          "type": "object",
          "properties": {
            "date": { "type": "string", "description": "YYYY-MM-DD" },
            "service": { "type": "string" }
          },
          "required": ["date"]
        }
      },
      "endpoint": {
        "url": "https://api.example.com/appointments/search",
        "method": "POST",
        "headers": {
          "X-Api-Key": "your-key"
        }
      }
    }
  ]
}

Кратак преглед подешавања

Пошаљите product: "bolt" и подесите позив помоћу ових поља. Старије вредности product (spark и вредности storm-*) се и даље прихватају.

ПољеВредностиШта се њиме балансира
intelligencecore, pro (подразумевано)Core је јефтинији и почиње да одговара раније; Pro поузданије прати дугачка упутства
audio_tierlite, standard (подразумевано), plus, maxВиши нивои боље чују и коштају више; Plus додаје 1–2 с у неким разменама, сваки Max одговор траје 3–4 с (Max није опште доступан)
endpointingfaster, fast, normal (подразумевано), patientКраћа чекања одговарају раније и коштају више
faster_repliestrue (подразумевано), falseУбрзање: одговори стижу мало раније, уз мало већу цену

Повезано