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

Webhooks

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_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | 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_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | 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_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен
positionintegerИндекс потеза у историји позива — стабилан идентификатор за редослед
rolestringassistant (говор агента) или user (говор позиваоца)
textstringТекст транскрипта потеза какав је познат у тренутку слања
entry_typestringТип основног уноса у историји: completion (агент) или user_turn / span (позивалац)
start_ms, end_msintegerАудио помераји у 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_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен

web.complete

Еквивалент telephony.complete за веб-канал, који обухвата позиве веб виџета (direction: "web") и тест позиве микрофона у градитељу (direction: "test"). Неблокирајуће. Исти облик садржаја као telephony.complete, уз origin_domain, при чему је from_number постављен на "web".

ПољеТипОпис
agent_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен

web.tool

Еквивалент telephony.tool за веб-канал. data садржи origin_domain уместо from_number / to_number.

ПољеТипОпис
agent_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен

web.turn

Еквивалент telephony.turn за веб-канал, који обухвата позиве веб виџета и тест позиве микрофона у градитељу. Исти облик садржаја, са origin_domain уместо from_number / to_number. Као и telephony.turn, захтева изричиту претплату — никада се не испоручује преко празног низа events.

ПољеТипОпис
agent_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | 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цео број | nullSIP статус провајдера када је одбио хладан пренос: 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_idintegerПозив који је наплаћен
agent_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен
reasonstringsettled: накнада за позив. adjusted: потрошња која је пристигла након накнаде и повећала је (накнада се никада не смањује)
billing_seqinteger1 за накнаду, затим 2, 3, ... за свако повећање. Највиша примљена вредност је тренутни обрачун позива
billable_minutesnumberНаплаћени минути, заокружени на најближу четвртину минута
billing_total_centsintegerУкупно што је до сада наплаћено за позив у USD центима, након евентуалног бесплатног кредита за позив, укључујући adjusted повећања
adjustment_centsinteger | 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цео број | null0–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_idinteger | nullАгент који је обрадио позив, ако је био додељен
agent_namestring | nullАгент који је обрадио позив, ако је био додељен
issue_report.severitystringcritical, warning или info
issue_report.statusstringopen или resolved
issue_report.sourcestringuser (поднето са контролне табле) или 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"
}
ПољеТипОпис
automaticbooleantrue за аутоматску ескалацију; false за ручну ескалацију
cluster_idUUIDЕскалирани образац проблема
escalation_idUUIDЗапис ескалације
statusstringopen када се догађај шаље

Ово је обавештење, а не пакет доказа. Користите 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_idinteger | nullГласовни агент који је обрадио позив, ако је додељен
agent_namestring | nullГласовни агент који је обрадио позив, ако је додељен
test_call_run.target_typestringagent или phone_number
test_call_run.target_idintegerID гласовног агента или ID броја телефона на који је покретање било усмерено, у складу са target_type
test_call_run.statusstringcompleted или failed
test_call_run.call_idinteger | nullnull када покретање није успело пре упућивања позива
test_call_run.error_messagestringПразно при успеху

Догађаји упозорења

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)UUIDID активирања упозорења — разликује се од event_id испоруке у омотачу
rule_id, rule_nameUUID, stringПравило које се активирало
metricstringsuccess_rate, failure_rate, avg_score, call_volume или suite_regression
comparatorstringlt, lte, gt или gte
metric_valuenumberВредност метрике у прозору када се правило активирало
thresholdnumberКонфигурисани праг
window_hoursintegerПокретни евалуациони прозор
fired_attimestamp

Погледајте водич за упозорења за креирање правила, метрика, периода хлађења и канала за е-пошту / 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.idUUIDМиграција
migration.routing_idUUIDУсмерени позив, како је враћен када сте га упутили
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_idUUIDМиграција
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временска ознака

Повезано