Skip to main content
Valmistumistapahtuma käynnistyy jokaisen puhelun päätyttyä — saapuvan puhelun, lähtevän puhelun, verkkopuhelun tai testipuhelun (rakentajan mikrofonisessio) jälkeen. Se on ei-estävä: vastaa millä tahansa 2xx-vastauksella. Tapahtuma toimitetaan molempia reittejä pitkin:

Pyyntöhyötykuorma (päätepistetoimitukset)

Päättymissyyt

Puheenvuorojen muoto

Jokainen transcripts-taulukon merkintä on yksi keskustelun puheenvuoro. Roolit ovat user (soittajan puhe), model (agentin puhe ja työkalukutsut), tool (työkalujen tulokset) ja system (puhelutapahtumat, kuten kielen vaihdot).
Jos tarvitset täysin jäsennellyn puheenvuorohistorian (keskeytysmerkintöineen, kuittauskehotteineen ja raakapositiotietoineen), käytä GET /v1/calls/{call_id}/history.

Vanhan hyötykuorman erot

Vanhan yhden URL-osoitteen webhook-kääre on {"type": "telephony.complete" | "web.complete", "data": {…}}, jossa ei ole event_id-kenttää, ja sen data poikkeaa päätepisteen hyötykuormasta:
  • Puheenvuorotaulukko on history-kentässä, ei transcripts-kentässä (sama puheenvuoriskeema kuin yllä).
  • Kenttäjoukko on käsittelemätön puhelun päättymisraportti, ja se voi sisältää muita sisäisiä kenttiä yllä olevan taulukon lisäksi — käsittele tuntemattomia kenttiä tiedoksi tarkoitettuina.
  • Verkkopuhelut (direction: "web") jättävät pois from_number / to_number ja lisäävät origin_domain-kentän.
  • Builderin mikrofonitestipuhelut raportoidaan vanhalla polulla muodossa telephony.complete (päätepistejärjestelmä yhdistää ne muotoon web.complete).
  • Siirron koordinointi: kun puhelu päättyy siirtoon, vanhaa webhookia kutsutaan synkronisesti, ja se voi vastata {"transfer_ready": false} ilmoittaakseen, ettei siirron kohde ole valmis. Mikä tahansa muu vastaus (tai vanhan webhookin puuttuminen) sallii siirron jatkua. Päätepistetoimituksia ei koskaan käytetä tähän.

Esimerkkikäsittelijä


Yleiset käyttötapaukset

CRM-integraatio

Tallenna jokaisen puhelun litterointi ja tallenteen URL-osoite asiakastietojesi yhteyteen.

Analytiikka

Suoratoista litteroinnit käsittelyputkeen aiheiden mallinnusta, CSAT-signaalien poimintaa tai siirtoasteen seurantaa varten.

Laadun tarkastus

Avaa puhelut QA-työkalussa ihmisen tarkastettaviksi tai suorita ne oman arviointimallisi läpi.

Ilmoitukset

Ilmoita ihmistiimin jäsenelle siirrosta tai virheestä.

Aiheeseen liittyvät

telephony.incoming / web.incoming

Estävä vastine, joka suoritetaan puhelun alkaessa.

Tapahtumaluettelo

Muut tapahtumatyypit, jotka voit tilata.

Puheluhistoria-API

Samat tiedot ovat käytettävissä RESTin kautta täydennystä tai uudelleentoistoa varten.