Open in
Katalog догађаја
Сви типови webhook догађаја које ThunderPhone шаље.
Свако webhook тело има поље type чија је вредност један од типова
догађаја на овој страници. Када се претплатите на
крајњу тачку, низ events мора да садржи
типове догађаја које желите (или да буде празан да бисте се претплатили на све —
осим догађаја по потезу telephony.turn /
web.turn и догађаја напретка уживо
call.status_changed, који се испоручују само
крајњим тачкама које их изричито наведу).
Ови догађаји се испоручују на два начина:
- Испоруке крајњој тачки су увек неблокирајућа обавештења
са поновним покушајима: одговорите било којим кодом 2xx; омотница садржи
event_idза дедупликацију. - Блокирајуће размене се извршавају само преко
застарелог вебхука са једним URL-ом: захтев за конфигурацију
telephony.incoming/web.incoming(бројеви у режиму вебхука: 13 с, укључујући један поновни покушај; кључеви виџета у режиму вебхука: 10 с) и отпрема алатки у режиму вебхука отпрема алатки. Ваш одговор обликује позив уживо.
Примери payload-а у наставку приказују омотницу крајње тачке у њеном редоследу
при преносу (кључеви су поређани абецедно: data, event_id, type);
застареле испоруке носе исти data без event_id.
Догађаји позива
telephony.incoming
Шаље се када долазни позив стигне на један од Ваших
бројева телефона. Испоруке на крајњу тачку су
обавештења без чекања одговора која се шаљу за сваки долазни позив, без обзира
на то да ли је број конфигурисан за агента или webhook. Бројеви без
додељеног агента додатно примају блокирајући захтев за конфигурацију
на застарелом webhook-у — погледајте
telephony.incoming / web.incoming за
целокупну шему захтева / одговора.
{
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
},
"event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
"type": "telephony.incoming"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | цео број | null | Агент који је обрадио позив, када је био додељен |
agent_name | ниска | null | Агент који је обрадио позив, када је био додељен |
returning_call | објекат | Присутно само када је број позвао овог позиваоца у последњих 30 дана: call_id, agent_id, started_at и outcome претходног позива. Погледајте Повратни позиви |
sip_headers | објекат | Присутно само када је позив стигао са SIP заглављима X-* или User-to-User (SIP адресе и ручне SIP везе): назив заглавља малим словима → вредност. Погледајте SIP заглавља |
telephony.complete
Шаље се када се заврши долазни или одлазни телефонски позив. Неблокирајуће.
Укључује транскрипт, URL снимка када је доступан и резиме наплате. Погледајте
telephony.complete / web.complete за
шему садржаја.
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
telephony.tool
Шаље се након што телефонски позив позове
алатку функције. Неблокирајуће обавештење за ревизију —
алатка је већ извршена када се овај догађај испоручи; обухвата
Ваше сопствене алатке функција и уграђену алатку send_sms (не и друге уграђене
алатке, алатке базе знања, везе са апликацијама или MCP алатке). За send_sms,
и arguments.to и arguments.body су [REDACTED]. Транскрипти по
завршетку такође их редигују; преузмите садржај и примаоца из SMS ресурса
на нивоу организације помоћу message_id из одговора.
{
"data": {
"arguments": { "date": "2026-04-21" },
"call_id": 987654321,
"from_number": "+14155550199",
"response": {
"response": { "available_slots": ["9:00 AM", "2:00 PM"] },
"status": 200
},
"to_number": "+15551234567",
"tool_name": "search_appointments"
},
"event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
"type": "telephony.tool"
}response је резултат извршавања: {"status": <http status>, "response": <your endpoint's JSON>} у случају успеха или
{"status": <status>, "error": "<message>"} у случају неуспеха.
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
telephony.turn
Шаље се док је телефонски позив у току, једном за сваки
говорни потез чим се догоди — изговорени одговори агента и
транскрибовани потези позиваоца. Омогућава Вам да пратите разговор уживо
преко обичних webhook-ова уместо анкетирања
GET /v1/calls/{call_id}/transcript.
Неблокирајуће.
{
"data": {
"call_id": 987654321,
"entry_type": "completion",
"from_number": "+14155550199",
"position": 7,
"role": "assistant",
"start_ms": 15200,
"text": "How many employees does your company have?",
"to_number": "+15551234567"
},
"event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
"type": "telephony.turn"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
position | integer | Индекс потеза у историји позива — стабилан идентификатор за редослед |
role | string | assistant (говор агента) или user (говор позиваоца) |
text | string | Текст транскрипта потеза какав је познат у тренутку слања |
entry_type | string | Тип основног уноса у историји: completion (агент) или user_turn / span (позивалац) |
start_ms, end_ms | integer | Аудио помераји у ms од почетка позива; присутни само када је време репродукције већ било познато у тренутку слања |
web.incoming
Еквивалент telephony.incoming за веб-канал, шаље се када
сесија веб виџета или тест позив микрофона у градитељу
започне. Испоруке на крајњу тачку су обавештења без чекања одговора за сваку веб сесију.
Објављиви кључеви у mode="webhook" додатно примају
блокирајући захтев за конфигурацију на застарелом webhook-у — тај
блокирајући захтев има другачији облик (origin_domain,
publishable_key_prefix; без бројева телефона). Погледајте
telephony.incoming / web.incoming.
{
"data": {
"call_id": 987654322,
"from_number": "web",
"origin_domain": "https://example.com",
"publishable_key_prefix": "pk_live_a1b2",
"to_number": "+15551234567"
},
"event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
"type": "web.incoming"
}from_number је увек дословна вредност "web". За сесије виџета у webhook режиму
to_number је празан (број агента за сесију додељује се
након конфигурације); за тест позиве микрофона у градитељу origin_domain и
publishable_key_prefix су празни.
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
web.complete
Еквивалент telephony.complete за веб-канал, који обухвата позиве веб
виџета (direction: "web") и тест позиве микрофона у градитељу
(direction: "test"). Неблокирајуће. Исти облик садржаја као
telephony.complete, уз origin_domain,
при чему је from_number постављен на "web".
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
web.tool
Еквивалент telephony.tool за веб-канал. data садржи
origin_domain уместо from_number / to_number.
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
web.turn
Еквивалент telephony.turn за веб-канал,
који обухвата позиве веб виџета и тест позиве микрофона у градитељу. Исти облик
садржаја, са origin_domain уместо from_number / to_number.
Као и telephony.turn, захтева изричиту претплату — никада
се не испоручује преко празног низа events.
| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
call.transfer_completed
Шаље се једном по позиву са коначним исходом
преноса позива: хладног преноса или везе између две особе
која остаје након топлог преноса када се агент искључи.
Не блокира извршавање и испоручује се само крајњим тачкама (никада застарелом
вебхуку са једним URL-ом). Стиже након telephony.complete догађаја позива:
када провајдер преузме позив или пренос не успе, односно, ако је
ThunderPhone премостио позив, када се премошћавање заврши.
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"bridge_kind": "cold_fallback",
"bridge_seconds": 255,
"bridge_total_cents": 5,
"call_id": 987654321,
"destination": "+15555550102",
"sip_status": 403,
"transfer_outcome": "bridged"
},
"event_id": "5b0f6c1e-9d2a-5e7b-8c4d-1a2b3c4d5e6f",
"type": "call.transfer_completed"
}| Поље | Тип | Опис |
|---|---|---|
call_id | цео број | Позив који је пренет |
agent_id | цео број | null | Агент који је обрадио позив, ако је био додељен |
agent_name | ниска | null | Агент који је обрадио позив, ако је био додељен |
transfer_outcome | ниска | refer_accepted: провајдер је преузео позив. bridged: ThunderPhone је сам одржао везу између позиваоца и одредишта, било зато што је провајдер одбио хладан пренос, било зато што се агент искључио из топлог преноса. bridge_unanswered: провајдер је одбио хладан пренос, а одредиште се није јавило на позив који је ThunderPhone сам упутио. failed: пренос није прошао и позив је завршен |
destination | ниска | null | Број на који је позив пренет |
sip_status | цео број | null | SIP статус провајдера када је одбио хладан пренос: 403 (на пример, Twilio канал без преноса позива), 405 или 501. null када га провајдер није одбио |
bridge_kind | ниска | null | Само за bridged: cold_fallback (одбијени хладни пренос који је ThunderPhone повезао) или warm (две особе у топлом преносу након што се агент искључио) |
bridge_seconds | цео број | null | Само за bridged: трајање премошћавања које је ThunderPhone наплатио, у секундама |
bridge_total_cents | цео број | null | Само за bridged: цена премошћавања у USD центима након примене евентуалног бесплатног кредита за позиве, наплаћена засебно од billing_total_cents позива |
Исте вредности се налазе и на објекту позива
као transfer_outcome, transfer_destination, transfer_sip_status,
transfer_bridge_kind, transfer_bridge_seconds и
transfer_bridge_total_cents. event_id је исти при свакој испоруци
за позив, тако да поновљена испорука никада не ствара други догађај.
call.billed
Шаље се за позив који се наплаћује према измереној потрошњи: када се његова накнада коначно обрачуна, неколико
минута након завршетка позива када се евидентира његова потрошња, и поново кад год
потрошња која је пристигла касније повећа накнаду. Догађај позива
telephony.complete / web.complete
садржи billing_pending: true и null поља за обрачун. Не блокира,
а испоручује се само крајњим тачкама (никада застарелом webhook-у са једним URL-ом).
Позиви који се наплате када се заврше садрже обрачун у догађају завршетка
и не добијају call.billed.
Редослед није загарантован: обрачун обично чека догађај завршетка,
али call.billed може стићи пре њега (ако је догађај завршетка задржан
сат времена или су испоруке поновљене у различито време), а два
call.billed догађаја могу стићи ван редоследа. Задржите догађај са
највишим billing_seq за сваки call_id.
{
"data": {
"adjustment_cents": null,
"agent_id": 12,
"agent_name": "Front desk",
"billable_minutes": 3.0,
"billing_seq": 1,
"billing_total_cents": 10,
"call_id": 987654321,
"reason": "settled"
},
"event_id": "7c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",
"type": "call.billed"
}| Поље | Тип | Опис |
|---|---|---|
call_id | integer | Позив који је наплаћен |
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
reason | string | settled: накнада за позив. adjusted: потрошња која је пристигла након накнаде и повећала је (накнада се никада не смањује) |
billing_seq | integer | 1 за накнаду, затим 2, 3, ... за свако повећање. Највиша примљена вредност је тренутни обрачун позива |
billable_minutes | number | Наплаћени минути, заокружени на најближу четвртину минута |
billing_total_cents | integer | Укупно што је до сада наплаћено за позив у USD центима, након евентуалног бесплатног кредита за позив, укључујући adjusted повећања |
adjustment_cents | integer | null | Само adjusted: ово повећање у USD центима, након евентуалног бесплатног кредита за позив |
Исти укупни износи налазе се на објекту позива
као billable_minutes и billing_total_cents. event_id је исти при
свакој испоруци једног billing_seq, тако да поновљено обавештење никада не ствара
други догађај.
call.status_changed
Шаље се док је позив у току, сваки пут када достигне нову фазу: ThunderPhone почиње бирање броја, особа или њен телефон се јавља, агент достиже говорну пошту или је агент стављен на чекање и скинут са чекања. Користите га за приказ напретка активног позива, на пример „Бирање…“, „Јављено“, „На чекању“ и „Скинуто са чекања после 4 минута“ у нити ћаскања која прати позив. Не блокира и испоручује се само крајњим тачкама (никада застарелом веб-хуку са једним URL-ом).
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"call_id": 987654321,
"direction": "outbound",
"hold_seconds": 240,
"occurred_at": "2026-11-07T17:04:12.418Z",
"status": "off_hold"
},
"event_id": "2f6a1c9e-3b7d-5e8f-9a0b-4c5d6e7f8a9b",
"type": "call.status_changed"
}| Поље | Тип | Опис |
|---|---|---|
call_id | цео број | Позив |
agent_id | цео број | null | Агент који је обрадио позив, када је био додељен |
agent_name | ниска | null | Агент који је обрадио позив, када је био додељен |
direction | ниска | Смер позива, као на објекту позива |
status | ниска | Фаза коју је позив достигао; погледајте табелу испод |
occurred_at | временска ознака | Када се догодило |
hold_seconds | цео број | null | Само за off_hold: колико је чекање трајало, у секундама. null за сваки други статус |
status | Када се шаље |
|---|---|
dialing | Одлазни позиви: ThunderPhone успоставља позив. Шаље се непосредно пре него што бирање броја пређе на телекомуникационог оператера, након што прођу све провере које би могле да одбију позив. Пробни позиви покренути са контролне табле га не шаљу |
answered | Одлазни позиви: телекомуникациони оператор је пријавио да је на позив одговорено. Одговор говорне поште или услуге за филтрирање позива такође се рачуна, па затим може уследити voicemail. Када ThunderPhone за одговор сазна тек из извештаја по завршетку позива, answered се шаље при завршетку позива |
voicemail | Одлазни позиви: агент је достигао говорну пошту и оставља поруку или прекида позив, како наводи voicemail_action агента. Шаље се када је сандуче потврђено (његовим звучним сигналом или изостанком одговора), а не при првој претпоставци |
on_hold | Агент је стављен на чекање и нечујно чека (алатка wait_on_hold) |
off_hold | Особа се вратила на линију и агент поново разговара. hold_seconds наводи колико је чекање трајало |
Сваки позив шаље сваки статус највише једном, осим on_hold и off_hold,
који се шаљу једном по чекању. Типичан одлазни позив који чека на линији
шаље dialing, answered, on_hold, off_hold, а затим
telephony.complete када се заврши.
Zvono se ne prijavljuje: da li operater signalizira zvono previše varira da bi se na to moglo osloniti. U retkim pozivima sa voicemail_action: "prompt" u kojima upit agenta, umesto ThunderPhone-a, odlučuje šta uraditi sa sandučetom govorne pošte, status voicemail se ne šalje; answered_by u telephony.complete i dalje navodi voicemail. Sadržaji ne sadrže transkript, brojeve telefona ni promenljive, pa se call.status_changed šalje čak i za pozive čije je snimanje isključeno.
SMS догађаји
SMS догађаји описују поруке послате преко повезаног Twilio или Telnyx налога организације. Тело поруке је изостављено, а to је редиговано.
Преузмите поруку у опсегу организације преко
GET /v1/sms/{message_id} када су потребни њен
садржај или прималац. source је api, agent_tool, followup
или pre_call (текст кампање пре позивања), као на
објекту поруке.
Сваки SMS догађај садржи scheduled_send_id: идентификатор
заказаног слања за које је текст послат, или
null за текст који није био заказан. Заказани текстови имају source
"scheduled".
sms.sent
Шаље се када оператер корисника прихвати захтев за слање SMS поруке. Ово није потврда о испоруци на уређај.
{
"data": {
"accepted_at": "2026-09-19T15:42:10.113Z",
"agent_id": 12,
"call_id": 987654321,
"created_at": "2026-09-19T15:42:09.901Z",
"direction": "outbound",
"error_code": null,
"error_message": null,
"from_number": "+15551234567",
"id": "313a3117-827b-46e9-a01a-ac1493838724",
"provider": "twilio",
"provider_id": "SM0123456789abcdef0123456789abcdef",
"scheduled_send_id": null,
"segment_count": 1,
"source": "agent_tool",
"status": "accepted",
"to": "[REDACTED]"
},
"event_id": "0ae347b4-1716-45bb-9a0e-b52373586e37",
"type": "sms.sent"
}sms.failed
Шаље се након трајног одбијања од стране оператера, након што су привремени поновни покушаји
исцрпљени, када је исход коначно непознат или када Twilio пријави да прихваћена
порука није испоручена или није успела. У том последњем случају, sms.sent поруке је већ послат, а
status остаје "accepted". error_code је стабилан ThunderPhone кôд, а
error_message наводи радњу коју корисник треба да предузме када је доступна. status: "unknown" значи да је оператер можда прихватио SMS;
проверите га у евиденцији оператера јер га ThunderPhone неће аутоматски поново послати.
sms.received
Резервисано за подршку за долазне SMS поруке. У тренутном издању се не
емитују sms.received догађаји. Конфигурација веб-куке долазног оператера и
провера потписа биће испоручене засебно.
Заказани догађаји
Заказана слања која не буду послата покрећу један
од ових догађаја. Слање које буде послато уместо тога покреће уобичајене догађаје:
sms.* догађаје са постављеним scheduled_send_id за текстуалну поруку, односно догађаје позива за
позив, са scheduled_send_id у његовом telephony.complete. Оба су неблокирајућа. Када слање има агента,
догађаје примају и крајње тачке тог агента.
Садржај носи само идентификаторе, статус и времена: никада текст поруке, нити
променљиве или контекст позива, а to је редигован. Преузмите
GET /v1/scheduled/{id}
за остало.
scheduled.skipped
Шаље се када слање намерно није послато. reason је expired (није могло бити
послато пре expires_at), opted_out (број се налази на
листи за одјаву, укључујући број додат након што је слање
креирано), quiet_hours (доспело је ван периода од 8 до 21 час у
временској зони примаоца), sender_not_ready (број за текстуалне поруке више не може
да шаље) или outbound_tcpa_unconfirmed (позив је доспео пре него што је
забележена TCPA потврда организације).
{
"data": {
"agent_id": null,
"created_at": "2026-11-01T18:02:11.204Z",
"detail": "The send could not go out before its expires_at, so it was not sent late.",
"expires_at": "2026-11-03T17:30:00Z",
"external_id": "appointment-4815",
"from_number": "+15551234567",
"id": "6f1c0b8e-3a52-4c1f-9a0b-2f4f7d8a91c3",
"reason": "expired",
"send_at": "2026-11-03T17:00:00Z",
"source": "api",
"status": "skipped",
"to": "[REDACTED]",
"type": "sms"
},
"event_id": "2b0f6c43-74c9-4d43-a1f4-0d6a2f8e51a7",
"type": "scheduled.skipped"
}scheduled.failed
Шаље се када ThunderPhone покуша да пошаље, али слање не успе. reason је
грешка самог слања: кôд SMS грешке, као
што је carrier_rejected за поруку, или разлог одбијања или неуспеха позива,
као што је правило о блокираном одредишту (на пример, premium_rate) или
agent_deleted. Подаци догађаја имају иста
поља као scheduled.skipped.
| Поље | Тип | Опис |
|---|---|---|
id | стринг | ИД заказаног слања |
type | стринг | sms или call |
status | стринг | skipped или failed |
reason | стринг | Зашто, као горе; иста вредност као status_reason слања |
detail | стринг | Читљиво објашњење |
source | стринг | Шта је креирало слање: api |
external_id | стринг | null | Ваш кључ за слање или null |
from_number | стринг | Број са којег се шаље |
to | стринг | Увек "[REDACTED]" |
agent_id | цео број | null | Позиви: агент; поруке: null |
send_at, expires_at, created_at | временска ознака | ISO 8601 |
Гласовни догађаји
Креирање прилагођеног гласа је асинхроно. Ови неблокирајући догађаји вам омогућавају да реагујете на коначни резултат уместо да испитујете крајњу тачку са детаљима клона.
voice.ready и voice.failed испоручују се само на крајњу тачку за целу
организацију са events: []. Не могу се изабрати као експлицитни филтери
догађаја.
voice.ready
Шаље се када прилагођени глас заврши обраду и може да се додели агенту.
{
"data": {
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "ready",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
"type": "voice.ready"
}voice.failed
Шаље се када обрада прилагођеног гласа достигне трајни неуспех.
{
"data": {
"reason": "audio sample could not be processed",
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "audio sample could not be processed",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "failed",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
"type": "voice.failed"
}| Поље | Тип | Опис |
|---|---|---|
voice.id | ниска | Јавни ИД прилагођеног гласа |
voice.name | ниска | Вредност гласа агента у облику custom:<public_id> |
voice.display_name | ниска | Назив гласа видљив организацији |
voice.language | ниска | Код јединог језика клона |
voice.gender | ниска | male, female или празна ниска |
voice.status | ниска | ready за voice.ready; failed за voice.failed |
voice.failure_reason | ниска | Празно при успеху; детаљ неуспеха обраде при неуспеху |
voice.created_at, voice.updated_at | временска ознака | ISO 8601 временске ознаке |
reason | ниска | Детаљ неуспеха; присутан само за voice.failed |
Догађаји квалитета
call.graded
Шаље се кад год се AI оцењивање заврши за позив. Неблокирајуће.
{
"data": {
"call_id": 987654321,
"grade": {
"call_outcome": "success",
"created_at": "2026-04-20T18:25:11.002Z",
"detected_issues": [],
"graded_at": "2026-04-20T18:25:11.002Z",
"grader_model": "heuristic-v1",
"id": 5512,
"score": 92,
"status": "completed",
"summary": "Caller asked about their policy and got a full answer…"
},
"report": null
},
"event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
"type": "call.graded"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | цео број | null | Агент који је обрадио позив, када је био додељен |
agent_name | ниска | null | Агент који је обрадио позив, када је био додељен |
grade.id | цео број | ИД оцене |
grade.score | цео број | null | 0–100 |
grade.call_outcome | ниска | success, failure, unknown или no_conversation |
grade.summary | ниска | Резиме у једном пасусу |
grade.detected_issues | низ | Ниске са проблемима које је пронашао оцењивач |
grade.status | ниска | Увек completed — емитују се само завршена покретања |
grade.grader_model | ниска | Који је оцењивач произвео резултат: heuristic-v1 (или други ThunderPhone оцењивач заснован на правилима) за брзу привремену оцену, thunderphone-grader за потпуну оцену. ThunderPhone ознака, а не назив AI модела |
grade.graded_at, grade.created_at | временска ознака | |
report | објекат | null | Извештај о позиву намењен клијенту: ознака исхода, ознака и разлог за потребу пажње, позивалац, резиме у једном реду, искуство позиваоца. Код ране хеуристичке оцене то је null или извештај pending чија су поља чувари места; догађај потпуне оцене садржи завршени извештај |
call.data_extracted
Шаље се кад год се успешно заврши издвајање структурираних података, укључујући
касни поновни покушај после telephony.complete / web.complete или ручно
поновно покретање путем
POST /v1/calls/{call_id}/extract.
Неблокирајуће.
У режиму блокирајућег издвајања, догађај завршетка обично не чека дуже
од буџета за издвајање од 75 секунди. Ако се процес радника за издвајање
изгуби, продукциони процес завршне обраде (сваких пет минута) шаље
завршетак чији је blocking_deadline_at истекао пре него што започне други
покушај издвајања. Каснији успех се засебно испоручује као овај догађај.
{
"data": {
"call_id": 987654321,
"agent_id": 12,
"agent_name": "Acme intake",
"extracted_data": {
"status": "completed",
"fields": {
"customer_name": "Alex Morgan",
"appointment_date": "2026-04-23"
},
"evidence": {
"customer_name": {
"quote": "My name is Alex Morgan",
"speaker_role": "caller",
"turn_index": 4
},
"appointment_date": {
"quote": "April 23 works for me",
"speaker_role": "caller",
"turn_index": 7
}
},
"verification": "verified",
"field_reasons": {},
"schema_version": "92850758e231a3c95a..."
},
"extracted_at": "2026-04-20T18:25:11.002Z",
"model": "thunderphone-extractor",
"summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23."
},
"event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
"type": "call.data_extracted"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | цео број | null | Агент који је обрадио позив, када је додељен |
agent_name | ниска | null | Агент који је обрадио позив, када је додељен |
summary | ниска | null | Завршени сажетак позива када агент има укључено Генерисање сажетка позива, тако да догађај касне екстракције испоручује и сажетак који је пропустио прозор завршетка; у супротном null. Агенти са сажетком, али без поља за екстракцију, никада не емитују овај догађај: прочитајте касни сажетак из GET /v1/calls/{call_id} |
extracted_data.status | ниска | Увек completed за овај догађај |
extracted_data.fields | објекат | Вредности чији су кључеви конфигурисани кључеви поља за екстракцију; недоступне вредности су null |
extracted_data.evidence | објекат | Докази чији су кључеви поља за екстракцију. Вредност која није null садржи тачан структурно проверен цитат (највише 1.000 знакова), speaker_role (caller или agent) и turn_index; дужи цитати које је вратио модел се одбацују уместо да се скраћују, а докази су null кад год је њихово поље null |
extracted_data.verification | ниска | verified само када је независна провера доказа вратила тачно једну важећу пресуду за свако кандидатно поље. unavailable значи да провера није успела, истекло је време, није имала довољно ресурса или је вратила неисправан или делимичан излаз. Потпуно недоступна провера задржава структурно утемељене вредности за преглед корисника. За делимичан излаз, важеће пресуде се примењују, а свако кандидатно поље без тачно једне важеће пресуде поставља се на null |
extracted_data.field_reasons | објекат | Разлози чији су кључеви поља која су постављена на null структурним утемељењем или независним верификатором |
extracted_data.schema_version | ниска | Хеш тачне шеме поља коришћене за ову екстракцију |
extracted_at | временска ознака | Време завршетка у формату ISO 8601 |
model | ниска | Увек thunderphone-extractor: ThunderPhone ознака за модел за екстракцију, а не назив AI модела |
campaign.completed
Шаље се једном када кампања пређе из running у completed, било зато што је
њен распоред завршен или зато што су сви контакти достигли завршна стања.
Поновни покушаји покретача не шаљу други догађај. Овај догађај животног
циклуса на нивоу организације испоручује се само крајњим тачкама у опсегу
организације, а не крајњим тачкама у опсегу агента. Неблокирајуће.
{
"data": {
"campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
"name": "May win-back",
"agent_id": 12,
"status": "completed",
"started_at": "2026-04-20T17:00:00Z",
"completed_at": "2026-04-20T18:25:11Z",
"counts": {
"contacts_total": 150,
"completed": 121,
"failed": 11,
"no_answer": 18,
"skipped": 4,
"remaining": 0
}
},
"event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
"type": "campaign.completed"
}Четири броја исхода се међусобно искључују и њихов збир је contacts_total:
completed садржи успешне контакте; no_answer садржи контакте који су трајно
неуспешни или су исцрпели покушаје, а чији је коначни исход био неодговарање; failed садржи
све остале контакте који су трајно неуспешни или су исцрпели покушаје; а remaining садржи контакте
на чекању, заказане контакте или контакте који се тренутно позивају. Контакт који чека поновни покушај је
remaining, чак и када је његов најскорији покушај био неодговарање. Позиви у току се усклађују
пре једнократног снимка завршетка. started_at је конфигурисани почетак кампање или време креирања
кампање када почетак није конфигурисан. skipped није пета категорија: броји контакте у оквиру
failed за које је филтер типа броја
завршио обраду без позива.
issue.reported
Шаље се када се креира пријава проблема —
било да је корисник поднесе са контролне табле (source: "user") или је
аутоматски креира оцењивање позива (source: "system"). Неблокирајуће.
{
"data": {
"call_id": 987654321,
"issue_report": {
"created_at": "2026-04-20T18:25:11.002Z",
"description": "Five-second silence before responding to the main question.",
"id": 4321,
"severity": "warning",
"source": "system",
"status": "open",
"title": "Agent paused too long"
}
},
"event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"type": "issue.reported"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Агент који је обрадио позив, ако је био додељен |
agent_name | string | null | Агент који је обрадио позив, ако је био додељен |
issue_report.severity | string | critical, warning или info |
issue_report.status | string | open или resolved |
issue_report.source | string | user (поднето са контролне табле) или system (креирано оцењивањем) |
issue.escalated
Шаље се када се образац проблема пошаље ThunderPhone-у на преглед особља: након Пријавите ThunderPhone-у, или када Решавање помоћу AI-ја не може да потврди исправку на страни клијента и аутоматски усмери проблем. Овај догађај примају само крајње тачке на нивоу целе организације.
{
"data": {
"automatic": false,
"cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
"escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
"status": "open"
},
"event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
"type": "issue.escalated"
}| Поље | Тип | Опис |
|---|---|---|
automatic | boolean | true за аутоматску ескалацију; false за ручну ескалацију |
cluster_id | UUID | Ескалирани образац проблема |
escalation_id | UUID | Запис ескалације |
status | string | open када се догађај шаље |
Ово је обавештење, а не пакет доказа. Користите cluster_id да бисте га
повезали са обрасцем проблема. Погледајте
Пријавите ThunderPhone-у.
Догађаји тест позива
test-call.completed
Шаље се када
покретање тест позива
достигне коначни статус — completed или failed, укључујући покретања
која нису успела при покретању и никада нису произвела позив. Не блокира извршавање. Корисно
за повезивање групних CI покретања са системима за ћаскање/обавештења.
{
"data": {
"test_call_run": {
"call_id": 987654321,
"completed_at": "2026-04-20T18:25:04.822Z",
"error_message": "",
"id": 7110,
"status": "completed",
"target_id": 12,
"target_type": "agent"
}
},
"event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
"type": "test-call.completed"
}| Поље | Тип | Опис |
|---|---|---|
agent_id | integer | null | Гласовни агент који је обрадио позив, ако је додељен |
agent_name | string | null | Гласовни агент који је обрадио позив, ако је додељен |
test_call_run.target_type | string | agent или phone_number |
test_call_run.target_id | integer | ID гласовног агента или ID броја телефона на који је покретање било усмерено, у складу са target_type |
test_call_run.status | string | completed или failed |
test_call_run.call_id | integer | null | null када покретање није успело пре упућивања позива |
test_call_run.error_message | string | Празно при успеху |
Догађаји упозорења
alert.triggered
Шаље се када правило упозорења са омогућеним каналом Испоручи веб-хуковима за програмере достигне свој праг. Не блокира извршавање. Правило се активира једном, а затим поштује свој период хлађења, тако да трајно кршење производи један догађај по прозору хлађења.
{
"data": {
"comparator": "lt",
"event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
"fired_at": "2026-04-20T18:00:00+00:00",
"metric": "success_rate",
"metric_value": 71.4,
"rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
"rule_name": "Success rate below 80%",
"threshold": 80.0,
"window_hours": 24
},
"event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"type": "alert.triggered"
}| Поље | Тип | Опис |
|---|---|---|
event_id (у data) | UUID | ID активирања упозорења — разликује се од event_id испоруке у омотачу |
rule_id, rule_name | UUID, string | Правило које се активирало |
metric | string | success_rate, failure_rate, avg_score, call_volume или suite_regression |
comparator | string | lt, lte, gt или gte |
metric_value | number | Вредност метрике у прозору када се правило активирало |
threshold | number | Конфигурисани праг |
window_hours | integer | Покретни евалуациони прозор |
fired_at | timestamp |
Погледајте водич за упозорења за креирање правила, метрика, периода хлађења и канала за е-пошту / Slack.
Догађаји телефонског броја
phone_number.spam_risk_changed
Шаље се када надзор ознака за нежељене позиве (плаћени додатак, доступан на захтев преко подршке) открије да је ризик од нежељених позива за надзирани број порастао на medium или high (са low, без претходног очитавања или са medium на high). Не блокира. Број који остаје означен не шаље се поново; број чији се ризик врати на low, а касније буде поново означен, шаље се поново. Догађај нема контекст гласовног агента, па га примају само крајње тачке на нивоу целе организације. Власници и администратори организације такође добијају имејл.
{
"data": {
"checked_at": "2026-10-21T14:41:07+00:00",
"phone_number": "+13125550100",
"phone_number_id": 412,
"previous_spam_risk": "low",
"scores": {
"connection": 31,
"engagement": 40,
"maturity": 82,
"sentiment": 22
},
"spam_category": "Telemarketer",
"spam_risk": "high"
},
"event_id": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
"type": "phone_number.spam_risk_changed"
}| Поље | Тип | Опис |
|---|---|---|
phone_number | ниска | Број, у формату E.164 |
phone_number_id | цео број | null | Његов ИД у одељку Бројеви телефона |
spam_risk | ниска | medium или high |
previous_spam_risk | ниска | null | Ризик при последњем очитавању, null пре првог |
spam_category | ниска | null | Ознака коју мрежни оператери могу да прикажу, као што су Telemarketer или Survey. Третирајте је као слободан текст |
scores | објекат | Сваки резултат је од 0 до 100, или null док нема довољног обима позива: maturity (колико је број утемељен), connection (да ли се људи јављају), engagement (да ли остају на вези), sentiment (да ли га блокирају или пријављују) |
checked_at | временска ознака | Када је ThunderPhone очитао резултат |
Догађаји миграције
migration.call.complete
Шаље се када се заврши позив упућен путем
POST /v1/migrations/{id}/calls,
без обзира на то која га је платформа преузела. Не блокира. Стиже најкасније око 5 минута
након завршетка позива. data садржи сва поља из
telephony.complete, као и блок migration. Позив који је ThunderPhone упутио такође шаље telephony.complete као и обично, са
истим call_id. answered_by је null за позив који је преузела друга платформа. Позив на другој платформи који није завршен након 2
сата, или чија је миграција прво завршена или изгубила кључ, шаље се са
status: "unknown" и без транскрипта.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"answered_by": null,
"billable_minutes": null,
"billing_total_cents": null,
"call_id": null,
"direction": "outbound",
"duration_seconds": 94,
"end_reason": "user_hangup",
"end_time": "2026-10-06T17:01:34+00:00",
"extracted_data": null,
"from_number": "+15551234567",
"migration": {
"arm": "vendor",
"id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"metadata": {
"lead_id": "8812"
},
"routing_id": "9b2f8c1e-4d3a-4f6b-8e2d-1a7c5b9e0f34",
"vendor": "retell",
"vendor_call_id": "call_6a1f0e",
"vendor_cost_usd": "0.1240"
},
"product": "",
"recording_mode": "vendor",
"recording_url": "https://…",
"start_time": "2026-10-06T17:00:00+00:00",
"status": "completed",
"summary": "The callee booked a table for two on Thursday.",
"thunderphone_retained_call_content": true,
"to_number": "+14155552671",
"transcripts": [
{
"content": "Hi Ada, this is Rosa's calling about your booking.",
"role": "agent"
},
{
"content": "Yes, Thursday works.",
"role": "user"
}
],
"transfer_number": null,
"unresolved_variables": [],
"variables": {
"first_name": "Ada"
},
"voice": ""
},
"event_id": "7c1e2f3a-4b5c-4d6e-8f7a-9b0c1d2e3f4a",
"type": "migration.call.complete"
}| Поље | Тип | Опис |
|---|---|---|
migration.id | UUID | Миграција |
migration.routing_id | UUID | Усмерени позив, како је враћен када сте га упутили |
migration.arm | ниска | ours (ThunderPhone га је упутио) или vendor (друга платформа га је упутила) |
migration.vendor | ниска | retell, vapi, elevenlabs или bland |
migration.vendor_call_id | ниска | null | Идентификатор позива друге платформе; null за ours |
migration.metadata | објекат | metadata који сте послали приликом упућивања позива |
migration.vendor_cost_usd | ниска | null | Трошак позива који је пријавила друга платформа, када га је пријавила |
call_id | цео број | null | Идентификатор ThunderPhone позива; null за vendor |
status | ниска | За vendor: completed када је позвани говорио, failed када није, unknown као што је горе наведено. За ours: као у telephony.complete |
За vendor позив ThunderPhone нема податке о наплати нити извучене податке:
billable_minutes, billing_total_cents и extracted_data су null,
product и voice су празни, recording_mode је vendor, а
recording_url је веза друге платформе, када ју је она доставила.
migration.rollback
Шаље се када постепено пребацивање миграције самостално врати сваки позив на другу платформу: 3 позива нису успела да се повежу са ThunderPhone у року од 15 минута, 2 позива послата у ThunderPhone су завршена пре него што се агент јавио или је стопа исхода задатка ThunderPhone пала за више од подешене разлике испод стопе друге платформе. Не блокира, једном по враћању. Након тога, удео ThunderPhone је 0% и миграција је паузирана док је неко не настави на картици „Миграција“ агента. Корисни терет не садржи бројеве телефона, транскрипте ни идентификаторе позива.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"dropped": 0,
"migration_id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"ours": {
"graded": 20,
"success_rate": 0.8
},
"ours_failed": 3,
"ours_percent": 0,
"previous_percent": 25,
"reason": "ours_failed_burst",
"rolled_back_at": "2026-10-10T12:05:00+00:00",
"step": 1,
"theirs": {
"graded": 20,
"success_rate": 0.8
},
"vendor": "retell"
},
"event_id": "3d1f6b2a-8c4e-5a7b-9d0e-2f1a3b4c5d6e",
"type": "migration.rollback"
}| Поље | Тип | Опис |
|---|---|---|
migration_id | UUID | Миграција |
vendor | стринг | retell, vapi, elevenlabs или bland |
reason | стринг | ours_failed_burst (3 неуспела повезивања у року од 15 минута), dropped_calls (2 позива су завршена пре него што се агент јавио, у року од 30 минута) или rate_gap (разлика у стопи исхода задатка за најмање rollback_min_calls оцењених позива са сваке стране) |
previous_percent | цео број | Удео позива ThunderPhone пре враћања |
ours_percent | цео број | Увек 0 |
step | цео број | null | Корак распореда на ком је била (почев од 0) |
ours / theirs | објекат | null | Оцењени позиви у тренутном кораку и њихова стопа успеха; theirs може обухватати последњих 30 дана када корак има премало позива. null када их није било |
ours_failed | цео број | Неуспела повезивања евидентирана у последњих 15 минута |
dropped | цео број | Позиви евидентирани као прекинути у последњих 30 минута |
rolled_back_at | временска ознака |