ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Webhooks

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:

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"
}
PoljeVrstaOpis
agent_idcijeli broj | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_nameniz znakova | nullAgent koji je obradio poziv, ako je bio dodijeljen
returning_callobjektPrisutan 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_headersobjektPrisutan 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.

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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.

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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"
}
PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, kada je bio dodijeljen
positionintegerIndeks segmenta u povijesti poziva — stabilan identifikator za redoslijed
rolestringassistant (govor agenta) ili user (govor pozivatelja)
textstringTekst transkripta segmenta kakav je poznat u trenutku slanja
entry_typestringVrsta temeljne stavke povijesti: completion (agent) ili user_turn / span (pozivatelj)
start_ms, end_msintegerPomaci 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.

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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".

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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.

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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.

PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent 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"
}
PoljeVrstaOpis
call_idcijeli brojPoziv koji je preusmjeren
agent_idcijeli broj | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_nameniz znakova | nullAgent koji je obradio poziv, ako je bio dodijeljen
transfer_outcomeniz znakovarefer_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
destinationniz znakova | nullBroj na koji je poziv preusmjeren
sip_statuscijeli broj | nullSIP 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_kindniz znakova | nullSamo 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_secondscijeli broj | nullSamo za bridged: vrijeme povezivanja koje je ThunderPhone naplatio, u sekundama
bridge_total_centscijeli broj | nullSamo 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"
}
PoljeVrstaOpis
call_idintegerPoziv koji je naplaćen
agent_idinteger | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, ako je bio dodijeljen
reasonstringsettled: naknada za poziv. adjusted: potrošnja koja je pristigla nakon naknade i povećala je (naknada se nikada ne smanjuje)
billing_seqinteger1 za naknadu, zatim 2, 3, ... za svako povećanje. Najveća primljena vrijednost predstavlja trenutačnu naplatu poziva
billable_minutesnumberNaplaćene minute, zaokružene na najbližu četvrtinu minute
billing_total_centsintegerSve što je dosad naplaćeno za poziv u američkim centima, nakon eventualnog kredita za besplatan poziv, uključujući povećanja adjusted
adjustment_centsinteger | nullSamo 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"
}
PoljeVrstaOpis
call_idintegerPoziv
agent_idinteger | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, ako je bio dodijeljen
directionstringSmjer poziva, kao na objektu poziva
statusstringFaza koju je poziv dosegnuo; pogledajte tablicu u nastavku
occurred_attimestampKada se dogodilo
hold_secondsinteger | nullSamo za off_hold: trajanje čekanja u sekundama. null za svaki drugi status
statusKada se šalje
dialingOdlazni 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
answeredOdlazni 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
voicemailOdlazni 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_holdAgent je stavljen na čekanje i tiho čeka (alat wait_on_hold)
off_holdOsoba 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.

PoljeVrstaOpis
idniz znakovaID zakazanog slanja
typeniz znakovasms ili call
statusniz znakovaskipped ili failed
reasonniz znakovaZašto, kako je navedeno gore; ista vrijednost kao status_reason slanja
detailniz znakovaČitljivo objašnjenje
sourceniz znakovaŠto je stvorilo slanje: api
external_idniz znakova | nullVaš ključ za slanje ili null
from_numberniz znakovaBroj s kojeg se šalje
toniz znakovaUvijek "[REDACTED]"
agent_idcijeli broj | nullPozivi: agent; poruke: null
send_at, expires_at, created_atvremenska oznakaISO 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"
}
PoljeVrstaOpis
voice.idstringJavni ID prilagođenog glasa
voice.namestringVrijednost glasa agenta u obliku custom:<public_id>
voice.display_namestringNaziv glasa vidljiv organizaciji
voice.languagestringJedinstveni jezični kôd klona
voice.genderstringmale, female ili prazan niz
voice.statusstringready za voice.ready; failed za voice.failed
voice.failure_reasonstringPrazno pri uspjehu; pojedinosti o neuspjehu obrade pri neuspjehu
voice.created_at, voice.updated_attimestampVremenske oznake ISO 8601
reasonstringPojedinosti 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"
}
PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, ako je bio dodijeljen
grade.idintegerID ocjene
grade.scoreinteger | null0–100
grade.call_outcomestringsuccess, failure, unknown ili no_conversation
grade.summarystringSažetak u jednom odlomku
grade.detected_issuesarrayNizovi znakova problema koje je pronašao ocjenjivač
grade.statusstringUvijek completed — samo dovršena izvođenja emitiraju događaj
grade.grader_modelstringOcjenjivač 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_attimestamp
reportobject | nullIzvješć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"
}
PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, ako je bio dodijeljen
summarystring | nullDovrš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.statusstringZa ovaj događaj uvijek completed
extracted_data.fieldsobjectVrijednosti označene konfiguriranim ključevima polja za ekstrakciju; nedostupne vrijednosti su null
extracted_data.evidenceobjectDokazi 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.verificationstringverified 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_reasonsobjectRazlozi označeni poljima koja su postavljena na null strukturnim utemeljenjem ili nezavisnim provjeravateljem
extracted_data.schema_versionstringHash točne sheme polja upotrijebljene za ovu ekstrakciju
extracted_attimestampVrijeme dovršetka u formatu ISO 8601
modelstringUvijek 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"
}
PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, ako je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, ako je bio dodijeljen
issue_report.severitystringcritical, warning ili info
issue_report.statusstringopen ili resolved
issue_report.sourcestringuser (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"
}
PoljeVrstaOpis
automaticbooleantrue za automatsku eskalaciju; false za ručnu eskalaciju
cluster_idUUIDEskalirani obrazac problema
escalation_idUUIDZapis eskalacije
statusstringopen 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"
}
PoljeVrstaOpis
agent_idinteger | nullAgent koji je obradio poziv, kada je bio dodijeljen
agent_namestring | nullAgent koji je obradio poziv, kada je bio dodijeljen
test_call_run.target_typestringagent ili phone_number
test_call_run.target_idintegerID agenta ili ID telefonskog broja na koji je pokretanje bilo usmjereno, u skladu s target_type
test_call_run.statusstringcompleted ili failed
test_call_run.call_idinteger | nullnull kada pokretanje nije uspjelo prije uspostavljanja poziva
test_call_run.error_messagestringPrazno 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"
}
PoljeVrstaOpis
event_id (u data)UUIDID aktiviranja upozorenja — razlikuje se od event_id isporuke u omotnici
rule_id, rule_nameUUID, stringPravilo koje se aktiviralo
metricstringsuccess_rate, failure_rate, avg_score, call_volume ili suite_regression
comparatorstringlt, lte, gt ili gte
metric_valuenumberVrijednost metrike tijekom prozora kada se pravilo aktiviralo
thresholdnumberKonfigurirani prag
window_hoursintegerZavršni evaluacijski prozor
fired_attimestamp

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"
}
PoljeVrstaOpis
phone_numberniz znakovaBroj u formatu E.164
phone_number_idcijeli broj | nullNjegov ID u odjeljku Telefonski brojevi
spam_riskniz znakovamedium ili high
previous_spam_riskniz znakova | nullRizik pri posljednjem očitanju; null prije prvog očitanja
spam_categoryniz znakova | nullOznaka koju operateri mogu prikazati, kao što su Telemarketer ili Survey. Tretirajte je kao slobodan tekst
scoresobjektSvaka 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_atvremenska oznakaKada 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"
}
PoljeVrstaOpis
migration.idUUIDMigracija
migration.routing_idUUIDUsmjereni poziv, kako je vraćen kada ste ga uputili
migration.armstringours (ThunderPhone ga je uputio) ili vendor (uputila ga je druga platforma)
migration.vendorstringretell, vapi, elevenlabs ili bland
migration.vendor_call_idstring | nullID poziva druge platforme; null za ours
migration.metadataobjectmetadata koji ste poslali pri upućivanju poziva
migration.vendor_cost_usdstring | nullTrošak poziva koji je prijavila druga platforma, kada ga je prijavila
call_idinteger | nullID ThunderPhone poziva; null za vendor
statusstringZa 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"
}
PoljeVrstaOpis
migration_idUUIDMigracija
vendorstringretell, vapi, elevenlabs ili bland
reasonstringours_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_percentintegerUdio poziva ThunderPhonea prije vraćanja
ours_percentintegerUvijek 0
stepinteger | nullKorak rasporeda na kojem se nalazila (indeksirano od 0)
ours / theirsobject | nullOcijenjeni 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_failedintegerNeuspjela povezivanja zabilježena u zadnjih 15 minuta
droppedintegerPozivi evidentirani kao prekinuti u zadnjih 30 minuta
rolled_back_attimestamp

Povezano