Open in
Katalog događaja
Sve vrste webhook događaja koje ThunderPhone šalje.
Svako tijelo webhooka ima polje type čija je vrijednost jedna od vrsta
događaja na ovoj stranici. Kada se pretplatite na
krajnju točku, polje events mora sadržavati
željene vrste događaja (ili biti prazno za pretplatu na sve —
osim događaja po potezu telephony.turn /
web.turn i događaja napretka uživo
call.status_changed, koji se isporučuju samo
krajnjim točkama koje ih izričito navedu).
Ovi se događaji isporučuju na dva načina:
- Isporuke krajnjoj točki uvijek su neblokirajuće obavijesti
s ponovnim pokušajima: odgovorite bilo kojim kodom 2xx; omotnica sadrži
event_idza deduplikaciju. - Blokirajuće razmjene izvode se samo putem
naslijeđenog webhooka s jednim URL-om: zahtjev za konfiguraciju
telephony.incoming/web.incoming(brojevi u načinu rada webhooka: 13 s, uključujući jedan ponovni pokušaj; ključevi widgeta u načinu rada webhooka: 10 s) i slanje alata u načinu rada webhooka. Vaš odgovor oblikuje poziv uživo.
Primjeri sadržaja u nastavku prikazuju omotnicu krajnje točke u redoslijedu
prijenosa (ključevi poredani abecedno: data, event_id, type);
naslijeđene isporuke sadrže isti data bez event_id.
Događaji poziva
telephony.incoming
Šalje se kada dolazni poziv stigne na jedan od Vaših
telefonskih brojeva. Isporuke krajnjoj točki
obavijesti su bez čekanja odgovora i šalju se za svaki dolazni poziv, bez obzira
na to je li broj konfiguriran za agenta ili webhook. Brojevi bez
dodijeljenog agenta dodatno primaju blokirajući zahtjev za konfiguraciju
na naslijeđenom webhooku — pogledajte
telephony.incoming / web.incoming za
potpunu shemu zahtjeva / odgovora.
{
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
},
"event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
"type": "telephony.incoming"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | cijeli broj | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | niz znakova | null | Agent koji je obradio poziv, ako je bio dodijeljen |
returning_call | objekt | Prisutan samo kada je broj nazvao ovog pozivatelja u posljednjih 30 dana: call_id, agent_id, started_at i outcome prethodnog poziva. Pogledajte Uzvratni pozivi |
sip_headers | objekt | Prisutan samo kada je poziv stigao sa SIP zaglavljima X-* ili User-to-User (SIP adrese i ručne SIP veze): naziv zaglavlja malim slovima → vrijednost. Pogledajte SIP zaglavlja |
telephony.complete
Šalje se kada završi dolazni ili odlazni telefonski poziv. Nije blokirajuće.
Uključuje transkript, URL snimke kada je dostupan i sažetak naplate. Pogledajte
telephony.complete / web.complete za
shemu sadržaja.
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
telephony.tool
Šalje se nakon što telefonski poziv pozove
alat funkcije. Obavijest revizije nije blokirajuća —
alat je već izvršen kada se ovaj događaj isporuči; obuhvaća
Vaše vlastite alate funkcija i ugrađeni alat send_sms (ne druge ugrađene
alate, alate baze znanja, povezivanja aplikacija ili MCP alate). Za send_sms,
i arguments.to i arguments.body imaju vrijednost [REDACTED]. Transkripti
završetka također ih redigiraju; sadržaj i primatelja dohvatite iz SMS resursa
na razini organizacije pomoću message_id iz odgovora.
{
"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 je rezultat izvršavanja: {"status": <http status>, "response": <your endpoint's JSON>} pri uspjehu ili
{"status": <status>, "error": "<message>"} pri neuspjehu.
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
telephony.turn
Šalje se tijekom telefonskog poziva koji je u tijeku, jednom za svaki
govorni segment čim nastane — izgovoreni odgovori agenta i
transkribirani segmenti pozivatelja. Omogućuje Vam praćenje razgovora uživo
putem običnih webhookova umjesto anketiranja
GET /v1/calls/{call_id}/transcript.
Nije blokirajuće.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
position | integer | Indeks segmenta u povijesti poziva — stabilan identifikator za redoslijed |
role | string | assistant (govor agenta) ili user (govor pozivatelja) |
text | string | Tekst transkripta segmenta kakav je poznat u trenutku slanja |
entry_type | string | Vrsta temeljne stavke povijesti: completion (agent) ili user_turn / span (pozivatelj) |
start_ms, end_ms | integer | Pomaci zvuka u ms od početka poziva; prisutni samo kada je vrijeme reprodukcije već bilo poznato u trenutku slanja |
web.incoming
Ekvivalent telephony.incoming za web-kanal, šalje se kada započne sesija
web-widgeta ili testni poziv mikrofona u alatu za izradu.
Isporuke krajnjoj točki obavijesti su bez čekanja odgovora za svaku web-sesiju.
Objavljivi ključevi u načinu rada mode="webhook" dodatno primaju
blokirajući zahtjev za konfiguraciju na naslijeđenom webhooku — taj
blokirajući zahtjev ima drukčiji oblik (origin_domain,
publishable_key_prefix; bez telefonskih brojeva). Pogledajte
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 uvijek je doslovna vrijednost "web". Za sesije widgeta u načinu
webhooka to_number je prazan (broj agenta za sesiju dodjeljuje se
nakon konfiguracije); za testne pozive mikrofona u alatu za izradu
origin_domain i publishable_key_prefix su prazni.
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
web.complete
Ekvivalent telephony.complete za web-kanal, obuhvaća pozive putem
web-widgeta (direction: "web") i testne pozive mikrofona u alatu za izradu
(direction: "test"). Nije blokirajuće. Ima isti oblik sadržaja kao
telephony.complete, uz origin_domain,
pri čemu je from_number postavljen na "web".
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
web.tool
Ekvivalent telephony.tool za web-kanal. data sadrži
origin_domain umjesto from_number / to_number.
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
web.turn
Ekvivalent telephony.turn za web-kanal,
obuhvaća pozive putem web-widgeta i testne pozive mikrofona u alatu za izradu.
Ima isti oblik sadržaja, s origin_domain umjesto from_number / to_number.
Kao i telephony.turn, zahtijeva izričitu pretplatu — nikada se ne
isporučuje putem praznog polja events.
| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
call.transfer_completed
Šalje se jednom po pozivu s konačnim ishodom
prijenosa poziva: hladnim prijenosom ili mostom
između osoba koji ostaje nakon toplog prijenosa kada se glasovni agent isključi.
Ne blokira i isporučuje se samo krajnjim točkama (nikada starom
webhooku s jednim URL-om). Stiže nakon telephony.complete događaja poziva:
kada pružatelj telekomunikacijskih usluga preuzme poziv ili prijenos ne uspije, odnosno kada
ThunderPhone poveže poziv, nakon završetka mosta.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
call_id | cijeli broj | Poziv koji je preusmjeren |
agent_id | cijeli broj | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | niz znakova | null | Agent koji je obradio poziv, ako je bio dodijeljen |
transfer_outcome | niz znakova | refer_accepted: pružatelj telekomunikacijskih usluga preuzeo je poziv. bridged: ThunderPhone je sam zadržao povezanima pozivatelja i odredište, bilo zato što je pružatelj telekomunikacijskih usluga odbio hladni prijenos ili zato što se glasovni agent toplog prijenosa isključio. bridge_unanswered: pružatelj telekomunikacijskih usluga odbio je hladni prijenos, a odredište se nije javilo na poziv koji je ThunderPhone sam uputio. failed: prijenos nije uspio i poziv je završio |
destination | niz znakova | null | Broj na koji je poziv preusmjeren |
sip_status | cijeli broj | null | SIP status pružatelja telekomunikacijskih usluga kada je odbio hladni prijenos: 403 (na primjer, Twilio trunk bez prijenosa poziva), 405 ili 501. null kada ga pružatelj telekomunikacijskih usluga nije odbio |
bridge_kind | niz znakova | null | Samo za bridged: cold_fallback (odbijeni hladni prijenos koji je ThunderPhone povezao) ili warm (dvije osobe iz toplog prijenosa nakon što se agent isključio) |
bridge_seconds | cijeli broj | null | Samo za bridged: vrijeme povezivanja koje je ThunderPhone naplatio, u sekundama |
bridge_total_cents | cijeli broj | null | Samo za bridged: cijena mosta u američkim centima nakon primjene eventualnog besplatnog kredita za poziv, naplaćena zasebno od billing_total_cents poziva |
Iste su vrijednosti na objektu poziva
kao transfer_outcome, transfer_destination, transfer_sip_status,
transfer_bridge_kind, transfer_bridge_seconds i
transfer_bridge_total_cents. event_id je isti pri svakoj isporuci
za poziv, pa ponovljeno izvješće nikada ne stvara drugi događaj.
call.billed
Šalje se za poziv naplaćen prema izmjerenoj potrošnji: kada se njegova naknada obračuna, nekoliko
minuta nakon završetka poziva kada pristignu podaci o potrošnji, te ponovno kad god
naknadno pristigli podaci o potrošnji povećaju naknadu. Događaj poziva
telephony.complete / web.complete
sadrži billing_pending: true i polja za naplatu null. Ne blokira,
a isporučuje se samo krajnjim točkama (nikada naslijeđenom webhooku s jednim URL-om).
Pozivi naplaćeni po završetku sadrže podatke o naplati u događaju završetka
i ne primaju call.billed.
Redoslijed nije zajamčen: naknada obično čeka događaj završetka,
ali call.billed može stići prije njega (ako je događaj završetka zadržan
sat vremena ili su isporuke ponovno pokušane u različito vrijeme), a dva
događaja call.billed mogu stići izvan redoslijeda. Za svaki call_id zadržite
događaj s najvećim billing_seq.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
call_id | integer | Poziv koji je naplaćen |
agent_id | integer | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, ako je bio dodijeljen |
reason | string | settled: naknada za poziv. adjusted: potrošnja koja je pristigla nakon naknade i povećala je (naknada se nikada ne smanjuje) |
billing_seq | integer | 1 za naknadu, zatim 2, 3, ... za svako povećanje. Najveća primljena vrijednost predstavlja trenutačnu naplatu poziva |
billable_minutes | number | Naplaćene minute, zaokružene na najbližu četvrtinu minute |
billing_total_cents | integer | Sve što je dosad naplaćeno za poziv u američkim centima, nakon eventualnog kredita za besplatan poziv, uključujući povećanja adjusted |
adjustment_cents | integer | null | Samo adjusted: ovo povećanje u američkim centima, nakon eventualnog kredita za besplatan poziv |
Isti su ukupni iznosi na objektu poziva
kao billable_minutes i billing_total_cents. event_id je isti pri
svakoj isporuci jednog billing_seq, pa ponovljena prijava nikada ne stvara
drugi događaj.
call.status_changed
Šalje se dok je poziv u tijeku, svaki put kada dosegne novu fazu: ThunderPhone počinje birati broj, osoba ili njezin telefon odgovori, agent dosegne govornu poštu ili je agent stavljen na čekanje pa vraćen s čekanja. Upotrijebite ga za prikaz napretka aktivnog poziva, primjerice „Biranje…”, „Odgovoreno”, „Na čekanju” i „Čekanje završeno nakon 4 minute” u niti razgovora koja prati poziv. Ne blokira izvršavanje i isporučuje se samo krajnjim točkama (nikad naslijeđenom webhooku s jednim URL-om).
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
call_id | integer | Poziv |
agent_id | integer | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, ako je bio dodijeljen |
direction | string | Smjer poziva, kao na objektu poziva |
status | string | Faza koju je poziv dosegnuo; pogledajte tablicu u nastavku |
occurred_at | timestamp | Kada se dogodilo |
hold_seconds | integer | null | Samo za off_hold: trajanje čekanja u sekundama. null za svaki drugi status |
status | Kada se šalje |
|---|---|
dialing | Odlazni pozivi: ThunderPhone uspostavlja poziv. Šalje se neposredno prije nego što biranje ode mrežnom operateru, nakon što prođe svaku provjeru koja bi mogla odbiti poziv. Testni pozivi pokrenuti s nadzorne ploče ne šalju ga |
answered | Odlazni pozivi: mrežni operater prijavio je da je na poziv odgovoreno. Odgovor sandučića govorne pošte ili sustava za filtriranje poziva također se računa, pa može slijediti voicemail. Kada ThunderPhone o odgovoru sazna tek iz izvješća na kraju poziva, answered se šalje pri završetku poziva |
voicemail | Odlazni pozivi: agent je dosegnuo sandučić govorne pošte i ostavlja poruku ili prekida poziv, kako navodi agentov voicemail_action. Šalje se kada je sandučić potvrđen (zvučnim signalom ili izostankom odgovora), a ne pri prvoj pretpostavci |
on_hold | Agent je stavljen na čekanje i tiho čeka (alat wait_on_hold) |
off_hold | Osoba se vratila na liniju i agent ponovno razgovara. hold_seconds navodi koliko je čekanje trajalo |
Svaki poziv šalje svaki status najviše jednom, osim on_hold i off_hold,
koji se šalju jednom za svako čekanje. Tipičan odlazni poziv koji čeka na liniji
šalje dialing, answered, on_hold, off_hold, a zatim
telephony.complete kada završi.
Zvono se ne prijavljuje: to hoće li operater signalizirati zvono previše varira da bi se na to moglo osloniti. U rijetkim pozivima s voicemail_action: "prompt" u kojima upit glasovnog agenta, a ne ThunderPhone, odlučuje što učiniti s govornom poštom, ne šalje se status voicemail; answered_by u telephony.complete i dalje navodi voicemail. Korisni tereti ne sadržavaju prijepis, telefonske brojeve ni varijable, stoga se call.status_changed šalje čak i za pozive čije je snimanje isključeno.
SMS događaji
SMS događaji opisuju poruke poslane putem povezanog Twilio ili Telnyx računa organizacije. Tijelo poruke izostavljeno je, a to je redigiran.
Dohvatite poruku na razini organizacije putem
GET /v1/sms/{message_id} kada su potrebni njezin
sadržaj ili primatelj. source može biti api, agent_tool, followup
ili pre_call (tekst kampanje prije poziva), kao na
objektu poruke.
Svaki SMS događaj sadrži scheduled_send_id: ID
zakazanog slanja za koje je tekst poslan ili
null za tekst koji nije bio zakazan. Zakazani tekstovi imaju source
"scheduled".
sms.sent
Šalje se kada korisnikov operater prihvati zahtjev za odlazni SMS. Ovo nije potvrda isporuke na uređaj.
{
"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
Šalje se nakon trajnog odbijanja od strane operatera, nakon što su iscrpljeni
privremeni ponovni pokušaji, kada je ishod trajno nepoznat ili kada Twilio prijavi
da prihvaćena poruka nije isporučena ili nije uspjela. U potonjem slučaju poruka je već
poslala sms.sent, a status ostaje "accepted". error_code je stabilan
ThunderPhone kôd, a error_message navodi radnju koju korisnik treba poduzeti kada je dostupna.
status: "unknown" znači da je operater možda prihvatio SMS; uskladite ga
u zapisniku operatera jer ga ThunderPhone neće automatski ponovno poslati.
sms.received
Rezervirano za podršku za dolazne SMS poruke. U trenutačnom izdanju ne šalju se
događaji sms.received. Konfiguracija webhooka dolaznog operatera i provjera
potpisa bit će isporučene zasebno.
Zakazani događaji
Zakazana slanja koja se ne izvrše pokreću jedan
od ovih događaja. Slanje koje se izvrši umjesto toga pokreće uobičajene događaje:
događaje sms.* s postavljenim scheduled_send_id za tekstnu poruku, događaje poziva za
poziv, s scheduled_send_id u njegovu telephony.complete. Oba nisu blokirajuća. Kada slanje ima agenta, događaje primaju i krajnje točke
tog agenta ograničene na agenta.
Korisni teret sadrži samo ID-ove, status i vremena: nikada sadržaj tekstne
poruke ni varijable ili kontekst poziva, a to je redigiran. Dohvatite
GET /v1/scheduled/{id}
za ostalo.
scheduled.skipped
Šalje se kada se slanje namjerno ne pošalje. reason je expired (nije se moglo
izvršiti prije expires_at), opted_out (broj se nalazi na
popisu za odjavu, uključujući broj dodan nakon što je slanje
izrađeno), quiet_hours (dospjelo je izvan razdoblja od 8 do 21 sat u
vremenskoj zoni primatelja), sender_not_ready (broj za tekstne poruke više ne
može slati) ili outbound_tcpa_unconfirmed (poziv je dospio prije nego što je
zabilježena TCPA potvrda organizacije).
{
"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
Šalje se kada je ThunderPhone pokušao poslati poruku, ali ona nije poslana. reason je
vlastita pogreška slanja: kod pogreške SMS-a kao što je
carrier_rejected za poruku ili razlog odbijanja ili neuspjeha poziva,
kao što je pravilo blokiranog odredišta (premium_rate, na primjer) ili
agent_deleted. Korisni teret ima ista
polja kao scheduled.skipped.
| Polje | Vrsta | Opis |
|---|---|---|
id | niz znakova | ID zakazanog slanja |
type | niz znakova | sms ili call |
status | niz znakova | skipped ili failed |
reason | niz znakova | Zašto, kako je navedeno gore; ista vrijednost kao status_reason slanja |
detail | niz znakova | Čitljivo objašnjenje |
source | niz znakova | Što je stvorilo slanje: api |
external_id | niz znakova | null | Vaš ključ za slanje ili null |
from_number | niz znakova | Broj s kojeg se šalje |
to | niz znakova | Uvijek "[REDACTED]" |
agent_id | cijeli broj | null | Pozivi: agent; poruke: null |
send_at, expires_at, created_at | vremenska oznaka | ISO 8601 |
Glasovni događaji
Izrada prilagođenog glasa asinkrona je. Ovi neblokirajući događaji omogućuju Vam reakciju na konačni rezultat umjesto anketiranja krajnje točke s pojedinostima klona.
voice.ready i voice.failed isporučuju se samo krajnjoj točki za cijelu
organizaciju s events: []. Ne mogu se odabrati kao izričiti filtri događaja.
voice.ready
Šalje se kada prilagođeni glas završi obradu i može se dodijeliti agentu.
{
"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
Šalje se kada obrada prilagođenog glasa dosegne trajni neuspjeh.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
voice.id | string | Javni ID prilagođenog glasa |
voice.name | string | Vrijednost glasa agenta u obliku custom:<public_id> |
voice.display_name | string | Naziv glasa vidljiv organizaciji |
voice.language | string | Jedinstveni jezični kôd klona |
voice.gender | string | male, female ili prazan niz |
voice.status | string | ready za voice.ready; failed za voice.failed |
voice.failure_reason | string | Prazno pri uspjehu; pojedinosti o neuspjehu obrade pri neuspjehu |
voice.created_at, voice.updated_at | timestamp | Vremenske oznake ISO 8601 |
reason | string | Pojedinosti o neuspjehu; prisutno samo za voice.failed |
Događaji kvalitete
call.graded
Šalje se svaki put kada se za poziv dovrši pokretanje AI ocjenjivanja. Ne blokira.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, ako je bio dodijeljen |
grade.id | integer | ID ocjene |
grade.score | integer | null | 0–100 |
grade.call_outcome | string | success, failure, unknown ili no_conversation |
grade.summary | string | Sažetak u jednom odlomku |
grade.detected_issues | array | Nizovi znakova problema koje je pronašao ocjenjivač |
grade.status | string | Uvijek completed — samo dovršena izvođenja emitiraju događaj |
grade.grader_model | string | Ocjenjivač koji je proizveo rezultat: heuristic-v1 (ili drugi ThunderPhone ocjenjivač temeljen na pravilima) za brzu privremenu ocjenu, thunderphone-grader za potpunu ocjenu. Oznaka ThunderPhonea, a ne naziv AI modela |
grade.graded_at, grade.created_at | timestamp | |
report | object | null | Izvješće o pozivu namijenjeno korisniku: oznaka ishoda, zastavica potrebe za pažnjom i razlog, pozivatelj, sažetak u jednom retku, iskustvo pozivatelja. U ranoj heurističkoj ocjeni ono je null ili izvješće pending čija su polja rezervirana mjesta; događaj potpune ocjene sadrži dovršeno izvješće |
call.data_extracted
Šalje se svaki put kada se uspješno dovrši izdvajanje strukturiranih podataka,
uključujući kasni ponovni pokušaj nakon telephony.complete / web.complete ili
ručno ponovno pokretanje putem
POST /v1/calls/{call_id}/extract.
Ne blokira.
U načinu blokirajućeg izdvajanja događaj dovršetka obično ne čeka dulje od
proračuna od 75 sekundi za izdvajanje. Ako se izgubi proces radnika za
izdvajanje, produkcijsko pražnjenje finalizacije (svakih pet minuta) šalje
dovršetak čiji je blocking_deadline_at istekao prije pokretanja drugog
pokušaja izdvajanja. Kasniji uspjeh isporučuje se zasebno putem ovog događaja.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, ako je bio dodijeljen |
summary | string | null | Dovršeni sažetak poziva kada agent ima uključenu opciju Generirajte sažetak poziva, pa događaj naknadne ekstrakcije isporučuje i sažetak koji je propustio prozor dovršetka; u suprotnom null. Agenti sa sažetkom, ali bez polja za ekstrakciju, nikada ne šalju ovaj događaj: naknadni sažetak dohvatite putem GET /v1/calls/{call_id} |
extracted_data.status | string | Za ovaj događaj uvijek completed |
extracted_data.fields | object | Vrijednosti označene konfiguriranim ključevima polja za ekstrakciju; nedostupne vrijednosti su null |
extracted_data.evidence | object | Dokazi označeni poljem za ekstrakciju. Vrijednost različita od null sadrži točan citat provjeren strukturnom provjerom (najviše 1.000 znakova), speaker_role (caller ili agent) i turn_index; dulji citati koje vrati model odbacuju se umjesto da se skrate, a dokazi su null kad god je njihovo polje null |
extracted_data.verification | string | verified samo kada je nezavisna provjera dokaza vratila točno jednu valjanu potvrdu za svako kandidatno polje. unavailable znači da provjera nije uspjela, prekoračila je vrijeme, nije imala dovoljno resursa ili je vratila neispravan ili djelomičan izlaz. Potpuno nedostupna provjera zadržava strukturno utemeljene vrijednosti za pregled korisnika. Za djelomičan izlaz primjenjuju se valjane potvrde, a svako kandidatno polje bez točno jedne valjane potvrde postavlja se na null |
extracted_data.field_reasons | object | Razlozi označeni poljima koja su postavljena na null strukturnim utemeljenjem ili nezavisnim provjeravateljem |
extracted_data.schema_version | string | Hash točne sheme polja upotrijebljene za ovu ekstrakciju |
extracted_at | timestamp | Vrijeme dovršetka u formatu ISO 8601 |
model | string | Uvijek thunderphone-extractor: ThunderPhone oznaka za model ekstrakcije, a ne naziv AI modela |
campaign.completed
Šalje se jednom kada kampanja prijeđe iz running u completed, bilo zato što je
njezin raspored završio ili su svi kontakti dosegli završna stanja. Ponovni
pokušaji pokretača ne šalju drugi događaj. Ovaj događaj životnog ciklusa na
razini organizacije isporučuje se samo krajnjim točkama na razini organizacije,
a ne krajnjim točkama na razini agenta. Ne blokira.
{
"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"
}Četiri broja ishoda međusobno se isključuju i njihov je zbroj contacts_total:
completed sadrži uspješne kontakte; no_answer sadrži terminalno neuspjele/iscrpljene kontakte čiji je konačni ishod bio neodgovaranje; failed sadrži sve ostale terminalno neuspjele/iscrpljene kontakte; a remaining sadrži kontakte na čekanju, zakazane kontakte ili kontakte koji su trenutačno u pozivu. Kontakt koji čeka ponovni pokušaj jest remaining, čak i kada je njegov najnoviji pokušaj završio bez odgovora. Pozivi u tijeku usklađuju se prije jednokratne snimke dovršetka. started_at je konfigurirani početak kampanje ili vrijeme stvaranja kampanje ako početak nije konfiguriran. skipped nije peta kategorija: broji kontakte unutar failed za koje je filtar vrste broja završio bez poziva.
issue.reported
Šalje se kada se izradi prijava problema —
bilo da je korisnik pošalje s nadzorne ploče (source: "user") ili je
automatski izradi ocjenjivanje poziva (source: "system"). Ne blokira.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, ako je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, ako je bio dodijeljen |
issue_report.severity | string | critical, warning ili info |
issue_report.status | string | open ili resolved |
issue_report.source | string | user (poslano s nadzorne ploče) ili system (izradilo ocjenjivanje) |
issue.escalated
Šalje se kada se obrazac problema pošalje ThunderPhoneu na pregled osoblja: nakon opcije Prijavite ThunderPhoneu ili kada značajka Popravite s AI-jem ne može potvrditi ispravak na strani korisnika te automatski usmjeri problem. Samo krajnje točke za cijelu organizaciju primaju ovaj događaj.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
automatic | boolean | true za automatsku eskalaciju; false za ručnu eskalaciju |
cluster_id | UUID | Eskalirani obrazac problema |
escalation_id | UUID | Zapis eskalacije |
status | string | open kada se događaj šalje |
Ovo je obavijest, a ne paket dokaza. Upotrijebite cluster_id za povezivanje s
obrascem problema. Pogledajte Prijavite ThunderPhoneu.
Događaji testnih poziva
test-call.completed
Šalje se kada
pokretanje testnog poziva
dosegne završni status — completed ili failed, uključujući pokretanja
koja nisu uspjela pri pokretanju i nikada nisu uspostavila poziv. Ne blokira. Korisno
za povezivanje skupnih CI pokretanja s vašim sustavima za chat i obavijesti.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
agent_id | integer | null | Agent koji je obradio poziv, kada je bio dodijeljen |
agent_name | string | null | Agent koji je obradio poziv, kada je bio dodijeljen |
test_call_run.target_type | string | agent ili phone_number |
test_call_run.target_id | integer | ID agenta ili ID telefonskog broja na koji je pokretanje bilo usmjereno, u skladu s target_type |
test_call_run.status | string | completed ili failed |
test_call_run.call_id | integer | null | null kada pokretanje nije uspjelo prije uspostavljanja poziva |
test_call_run.error_message | string | Prazno pri uspjehu |
Događaji upozorenja
alert.triggered
Šalje se kada pravilo upozorenja s uključenim kanalom Dostavi na webhookove za razvojne programere prijeđe svoj prag. Ne blokira. Pravilo se aktivira jednom, a zatim poštuje razdoblje hlađenja, stoga trajna povreda proizvodi jedan događaj po razdoblju hlađenja.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
event_id (u data) | UUID | ID aktiviranja upozorenja — razlikuje se od event_id isporuke u omotnici |
rule_id, rule_name | UUID, string | Pravilo koje se aktiviralo |
metric | string | success_rate, failure_rate, avg_score, call_volume ili suite_regression |
comparator | string | lt, lte, gt ili gte |
metric_value | number | Vrijednost metrike tijekom prozora kada se pravilo aktiviralo |
threshold | number | Konfigurirani prag |
window_hours | integer | Završni evaluacijski prozor |
fired_at | timestamp |
Pogledajte vodič za upozorenja za izradu pravila, metrike, razdoblja hlađenja te kanale e-pošte i Slacka.
Događaji telefonskog broja
phone_number.spam_risk_changed
Šalje se kada praćenje oznaka za neželjene pozive (plaćeni dodatak, dostupan na zahtjev putem podrške) otkrije da je rizik od neželjenih poziva za praćeni broj porastao na medium ili high (s low, bez prethodnog očitanja ili s medium na high). Ne blokira rad. Broj koji ostane označen ne šalje se ponovno; broj čiji se rizik vrati na low pa kasnije ponovno bude označen šalje se. Događaj nema kontekst agenta, pa ga primaju samo krajnje točke na razini organizacije. Vlasnici i administratori organizacije također primaju e-poruku.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
phone_number | niz znakova | Broj u formatu E.164 |
phone_number_id | cijeli broj | null | Njegov ID u odjeljku Telefonski brojevi |
spam_risk | niz znakova | medium ili high |
previous_spam_risk | niz znakova | null | Rizik pri posljednjem očitanju; null prije prvog očitanja |
spam_category | niz znakova | null | Oznaka koju operateri mogu prikazati, kao što su Telemarketer ili Survey. Tretirajte je kao slobodan tekst |
scores | objekt | Svaka vrijednost od 0 do 100 ili null dok nema dovoljno poziva: maturity (koliko je broj etabliran), connection (javljaju li se ljudi), engagement (ostaju li na vezi), sentiment (blokiraju li ga ili prijavljuju) |
checked_at | vremenska oznaka | Kada je ThunderPhone očitao rezultat |
Događaji migracije
migration.call.complete
Šalje se kada završi poziv upućen putem
POST /v1/migrations/{id}/calls,
bez obzira na to koja ga je platforma preuzela. Ne blokira. Stiže do otprilike 5 minuta
nakon završetka poziva. data sadrži sva polja iz
telephony.complete te blok migration. Poziv koji je
ThunderPhone uputio također uobičajeno šalje telephony.complete, s istim
call_id. answered_by je null za poziv koji je preuzela druga platforma. Poziv na drugoj platformi koji ne završi nakon 2
sata ili čija migracija prije završi ili izgubi ključ šalje se sa
status: "unknown" i bez prijepisa.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
migration.id | UUID | Migracija |
migration.routing_id | UUID | Usmjereni poziv, kako je vraćen kada ste ga uputili |
migration.arm | string | ours (ThunderPhone ga je uputio) ili vendor (uputila ga je druga platforma) |
migration.vendor | string | retell, vapi, elevenlabs ili bland |
migration.vendor_call_id | string | null | ID poziva druge platforme; null za ours |
migration.metadata | object | metadata koji ste poslali pri upućivanju poziva |
migration.vendor_cost_usd | string | null | Trošak poziva koji je prijavila druga platforma, kada ga je prijavila |
call_id | integer | null | ID ThunderPhone poziva; null za vendor |
status | string | Za vendor: completed kada je pozvana osoba razgovarala, failed kada nije, unknown kako je navedeno iznad. Za ours: kao u telephony.complete |
Za poziv vendor ThunderPhone nema podatke o naplati ni izdvajanju:
billable_minutes, billing_total_cents i extracted_data imaju vrijednost null,
product i voice su prazni, recording_mode je vendor, a
recording_url je poveznica druge platforme kada ju je ona pružila.
migration.rollback
Šalje se kada postupno prebacivanje migracije samo vrati svaki poziv na drugu platformu: 3 poziva nisu se uspjela povezati s ThunderPhoneom unutar 15 minuta, 2 poziva poslana ThunderPhoneu završila su prije nego što je agent odgovorio ili je stopa ishoda zadataka ThunderPhonea pala za više od konfiguriranog razmaka ispod stope druge platforme. Ne blokira, jednom po vraćanju. Nakon toga udio ThunderPhonea iznosi 0 % i migracija je pauzirana dok je netko ne nastavi na kartici Migracija agenta. Sadržaj ne uključuje telefonske brojeve, transkripte ni ID-jeve poziva.
{
"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"
}| Polje | Vrsta | Opis |
|---|---|---|
migration_id | UUID | Migracija |
vendor | string | retell, vapi, elevenlabs ili bland |
reason | string | ours_failed_burst (3 neuspjela povezivanja u 15 minuta), dropped_calls (2 poziva završila su prije nego što je agent odgovorio, unutar 30 minuta) ili rate_gap (razmak u stopi ishoda zadataka pri najmanje rollback_min_calls ocijenjenih poziva po strani) |
previous_percent | integer | Udio poziva ThunderPhonea prije vraćanja |
ours_percent | integer | Uvijek 0 |
step | integer | null | Korak rasporeda na kojem se nalazila (indeksirano od 0) |
ours / theirs | object | null | Ocijenjeni pozivi u trenutačnom koraku i njihova stopa uspjeha; theirs može obuhvaćati zadnjih 30 dana kada korak ima premalo poziva. null ako ih nije bilo |
ours_failed | integer | Neuspjela povezivanja zabilježena u zadnjih 15 minuta |
dropped | integer | Pozivi evidentirani kao prekinuti u zadnjih 30 minuta |
rolled_back_at | timestamp |
Povezano
Blokirajući korisni sadržaj dolaznog poziva na koji morate odgovoriti.
Transkript i metrike nakon poziva.
Pretplatite URL na podskup ovih događaja.
Kako se generiraju događaji telephony.tool / web.tool.