Open in
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_reasoninbound_config_webhook_failed, без наплате). - Ништа му није потребно (нема променљивих или свака има подразумевану вредност као
{{first_name|there}}): веб-хук се и даље извршава, али када не успе, агент се јавља без њега, а детаљи позива приказујуwebhook_failedса узроком.
Сам контекст позива никада не чини вебхук обавезним: ништа у подешавањима агента не наводи да му је потребан контекст. Користите променљиву без подразумеване вредности ако позив не сме да почне без одговора вашег вебхука.
Додељивање и објављивање. Агент коме је потребан вебхук не може бити
додељен броју без њега: додељивање се одбија уз поруку која наводи променљиве. Иста провера се покреће када се промени
верзија броја, укључујући случај када се закачени број врати на Најновију верзију. Док одговара на број са својим
објављеним подешавањима, објављивање које додаје такву променљиву без вебхука
(или уклања вебхук) одбија се на исти начин. Чување нацрта је
увек дозвољено, а warnings агента садржи
call_setup_webhook_needed док се проблем не отклони.
Вебхук агента покреће се само за долазне телефонске позиве на бројевима којима је додељен. Одлазни позиви, сесије веб-виџета, SIP адресе, симулације и тестни разговори на контролној табли га не позивају; њихове променљиве се и даље преузимају из захтева.
Тестирање са сачуваним примерима. Да бисте тестирали како се Ваш гласовни агент понаша са
датим одговором (поновни позивалац, запис није пронађен, говорник шпанског),
сачувајте тај одговор за агента као пример: његове variables, context
и, по избору, language, унесене или копиране из претходног позива. Изаберите га
када покренете тестни разговор на контролној табли, тестни позив на Ваш телефон
или симулацију за агента, а позив се извршава као да је Ваш вебхук одговорио
тим примером. Примере деле све верзије агента.
Уређивањем примера задржавате његове раније верзије: када је за измену агента потребна
променљива коју пример не поставља, додајте је у пример, а старије верзије
агента настављају да користе пример онакав какав је био. Симулације које позивају телефонски
број уместо тога покрећу Ваш стварни вебхук.
Бројеви без додељеног агента настављају да користе вебхук броја или организације, тачно како је горе описано.
Повратни позиви
Људи често узвраћају позив на број који их је позвао, на пример након што је Ваш агент оставио говорну поруку. Када стигне телефонски позив од некога чији је број позван у последњих 30 дана, ThunderPhone проналази најскорији такав одлазни позив (онај који је зазвонио на њиховом телефону) и користи га на три начина:
-
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(на позив је одговорено; још није познато ко је одговорио) -
Контекст за агента. Агент који се јави добија кратку напомену на крају свог упита: када је ранији позив упућен, који агент га је упутио и какав је био његов исход. Агенту је наложено да је не чита наглас и да, пошто се идентификација позиваоца може лажирати, не дели ништа о том позиву осим да је број раније позван.
-
Резервни агент. Када број нема агента за долазне позиве и не стигне конфигурација зато што не постоји 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), тако да је прекид вебхука и даље видљив иако је на позив одговорено.
Ограничење величине одговора
Пример обрађивача
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 {}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-*) се и даље прихватају.
| Поље | Вредности | Шта се њиме балансира |
|---|---|---|
intelligence | core, pro (подразумевано) | Core је јефтинији и почиње да одговара раније; Pro поузданије прати дугачка упутства |
audio_tier | lite, standard (подразумевано), plus, max | Виши нивои боље чују и коштају више; Plus додаје 1–2 с у неким разменама, сваки Max одговор траје 3–4 с (Max није опште доступан) |
endpointing | faster, fast, normal (подразумевано), patient | Краћа чекања одговарају раније и коштају више |
faster_replies | true (подразумевано), false | Убрзање: одговори стижу мало раније, уз мало већу цену |
Повезано
Неблокирајући догађај завршетка позива.
Комплетна JSON шема за tools[] и уговор о потписаној крајњој тачки.
Претплатите више URL-ова на telephony.incoming / web.incoming.
Обрасци за упите, алате и A/B тестове по позиваоцу.