Skip to main content
Valmistumistapahtuma käynnistyy jokaisen puhelun päätyttyä — saapuva puhelinliikenne, lähtevä puhelinliikenne, verkkopuhelu tai testipuhelu (rakentajan mikrofonisessio). Se on ei-estävä: vastaa millä tahansa 2xx-vastauksella. Tapahtuma toimitetaan molempiin polkuihin:

Pyynnön hyötykuorma (päätepistetoimitukset)

Lopetussyyt

Transkriptimuoto

Jokainen transcripts-merkintä on yksi keskusteluvuoro. Roolit ovat user (soittajan puhe), model (agentin puhe sekä työkalukutsut), tool (työkalun tulokset) ja system (puhelutapahtumat, kuten kielen vaihdot).
Käytä täysin jäsenneltyyn vuorohistoriaan (keskeytysmerkkeineen, vahvistuskehotteineen ja raakapositioineen) GET /v1/calls/{call_id}/history-päätepistettä.

Vanhan hyötykuorman erot

Vanhan yhden URL-osoitteen webhook-kuori on {"type": "telephony.complete" | "web.complete", "data": {…}}, eikä siinä ole event_id-kenttää. Sen data eroaa päätepisteen hyötykuormasta:
  • Vuorotaulukko on history-kentässä, ei transcripts-kentässä (sama vuorokaava kuin yllä).
  • Kenttäjoukko on puhelun päättymisen raaka raportti, ja se voi sisältää taulukossa esitettyjen kenttien lisäksi sisäisiä kenttiä — käsittele tuntemattomia kenttiä tiedoksi tarkoitettuina.
  • Web-puhelut (direction: "web") jättävät pois kentät from_number / to_number ja lisäävät kentän origin_domain.
  • Builderin mikrofonitestipuhelut raportoidaan vanhassa polussa 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 tarkisteta tätä varten.

Esimerkkikäsittelijä


Yleiset käyttötapaukset

CRM-integraatio

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

Analytiikka

Suoratoista transkriptiot työnkulkuun aiheiden mallintamista, CSAT-signaalien poimintaa tai siirtoasteen seurantaa varten.

Laatuarviointi

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

Ilmoitukset

Ilmoita ihmistiimin jäsenelle siirrosta / epäonnistumisesta.

Aiheeseen liittyvät

telephony.incoming / web.incoming

Estävä vastine, joka suoritetaan puhelun alkaessa.

Tapahtumaluettelo

Muut tapahtumatyypit, joita voit tilata.

Puheluhistoria-API

Samat tiedot ovat saatavilla RESTin kautta täyttöä / uudelleentoistoa varten.