- Webhook-päätepisteet vastaanottavat
telephony.complete-tapahtuman (puhelut) taiweb.complete-tapahtuman (verkkopuhelut ja rakentajan mikrofonitestipuhelut) alla dokumentoidulla vakaalla hyötykuormalla, toimituskohtaisellaevent_id:llä, 30 sekunnin aikakatkaisulla ja uudelleenyrityksillä enintään 24 tunnin ajan. - Vanha yhden URL-osoitteen webhook vastaanottaa yhden synkronisen yrityksen (10 sekunnin aikakatkaisu, ei uudelleenyrityksiä) hieman erilaisella hyötykuormalla — katso Vanhan hyötykuorman erot.
Pyynnön hyötykuorma (päätepistetoimitukset)
Lopetussyyt
Transkriptimuoto
Jokainentranscripts-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ä, eitranscripts-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ätfrom_number/to_numberja lisäävät kentänorigin_domain. - Builderin mikrofonitestipuhelut raportoidaan vanhassa polussa muodossa
telephony.complete(päätepistejärjestelmä yhdistää ne muotoonweb.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.
