- Webhook-päätepisteet vastaanottavat
telephony.complete-tapahtuman (puhelut) taiweb.complete-tapahtuman (verkkopuhelut ja rakentajan mikrofonitestipuhelut) alla dokumentoidulla vakaalla hyötykuormalla, toimituskohtaisellaevent_id-tunnuksella, 30 s:n aikakatkaisulla ja uudelleenyrityksillä enintään 24 tunnin ajan. - Vanha yhden URL-osoitteen webhook vastaanottaa yhden synkronisen yrityksen (10 s:n aikakatkaisu, ei uudelleenyrityksiä) hieman erilaisella hyötykuormalla — katso Vanhan hyötykuorman erot.
Pyyntöhyötykuorma (päätepistetoimitukset)
Päättymissyyt
Puheenvuorojen muoto
Jokainentranscripts-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ä, eitranscripts-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 poisfrom_number/to_numberja lisäävätorigin_domain-kentän. - Builderin mikrofonitestipuhelut raportoidaan vanhalla polulla 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 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.