Webhookien hallinta

Webhookit lähettävät Klangin tapahtumia omalle palvelimellesi. Käytä niitä CRM:n päivittämiseen, keskustelutyökalussa julkaisemiseen tai muun prosessin käynnistämiseen kokouksen käsittelyn valmistuttua.

Webhookit ovat henkilökohtaisia ja vastaanottavat vain tapahtumia sisällöstä, johon käyttäjällä on käyttöoikeus.

Webhookin luominen

1. Avaa Asetukset → Kehittäjät → Webhookit
2. Napsauta Luo webhook

3. Kirjoita URL-osoite, jonka on oltava julkinen HTTPS-rajapintapiste
4. Valinnainen: lisää Kuvaus
5. Valitse tilattavat tapahtumat. Kaikki kolme on valittu oletuksena.
6. Napsauta Luo

Klang näyttää allekirjoitussalaisuuden luonnin jälkeen. Kopioi se ja säilytä turvallisesti. Voit lukea sen myöhemmin myös webhookin tietosivulta. Sen avulla varmistat, että saapuvat pyynnöt tulevat Klangilta.

Käytettävissä olevat tapahtumat

• conversation.ready: litterointi ja tekoälyanalyysi ovat valmiita
• conversation.failed: kokouksen tai tiedoston käsittely epäonnistui
• conversation.deleted: kokous tai tiedosto poistettiin

Katso skeema, allekirjoitusotsake ja vahvistusesimerkit webhook-dokumentaatiosta.

Tapahtumat ja automaatiot

Tämän sivun rajapintapiste voi ottaa vastaan kahdenlaista sisältöä, ja on hyvä tietää, kumpaa olet määrittämässä.

Tapahtumat kertovat, että jotain on tapahtunut. conversation.ready sisältää id:n, otsikon ja tilan, ja palvelimesi hakee sen jälkeen tarvitsemansa sisällön rajapinnasta.

Automaatiot lähettävät itse sisällön. Automaatio suoritetaan vain valitsemillesi kokouksille ja toimittaa valmiin raportin valitsemillasi kenttänimillä, ilman että palvelimesi tarvitsee hakea mitään. Sen määrität automaation Webhook-kohteessa, ei täällä. Se käyttää samoja rajapintapisteitä, joten osoite, allekirjoitusavain ja toimitushistoria pysyvät yhtenä kummassakin tapauksessa.

Rajapintapiste, jota käyttävät vain automaatiot, ei tilaa yhtään tapahtumaa, joten täällä ei näy valittuja tapahtumia. Näin kuuluukin olla.

Toimitusten seuranta

Sivu näyttää tilan ja URL-osoitteen, salaisuuden, 24 tunnin tilastot sekä viimeisimmät toimitukset. Avaa toimitus nähdäksesi pyynnön ja palvelimesi vastauksen.

Klang yrittää epäonnistunutta toimitusta uudelleen enintään kuusi kertaa pitenevin välein, noin seitsemän tunnin ajan. Webhook keskeytetään automaattisesti, kun viisi toimitusta peräkkäin on epäonnistunut ja ne ovat epäonnistuneet vähintään vuorokauden ajan. Lyhyt katko ei siis sammuta sitä. Korjaa rajapintapiste ja ota Vastaanota tapahtumia uudelleen käyttöön.

Testitapahtuman lähettäminen

1. Avaa webhookin tiedot
2. Napsauta Lähetä testitapahtuma
3. Valitse tapahtuma tarvittaessa
4. Tarkista uusi rivi Viimeisimmät toimitukset -kohdassa

Testeillä on TEST-tunniste ja tunnisteet, jotka alkavat tekstillä evt_test_. Skeema vastaa todellista tapahtumaa.

Keskeyttäminen tai poistaminen

Poista Vastaanota tapahtumia käytöstä, jos haluat keskeyttää lähetykset säilyttäen historian. Poista webhook napsauttamalla Muokkaa ja Poista webhook. Voit käyttää myös luettelon kolmen pisteen valikkoa.

Seuraavat vaiheet

• Lue webhook-dokumentaatio
• Hallitse integraatioita