Siirry sisältöön
AurionAI

Ilmoitus-webhookit

Lukuaika 3 minKirjoittanut Emmanuel Yazbeck

Ilmoituswebhook lähettää AurionAI-ilmoitustapahtumat toiseen järjestelmään, esimerkiksi chat-työkaluun. AurionAI lähettää jokaisen tapahtuman JSON-sisältönä POST-pyyntönä syöttämääsi osoitteeseen.

Saatavuus: Helpdesk- ja AI Voice + Helpdesk-profiilit. Vain järjestelmänvalvojille.

Edellytykset

  • Sinulla on Omistaja- tai Ylläpitäjä-rooli. Muut käyttäjät näkevät Pääsy estetty.
  • Organisaatiosi käyttää Helpdesk- tai AI Voice + Helpdesk-profiilia.
  • Julkinen HTTPS-osoite, joka hyväksyy POST-pyynnöt JSON-sisällöllä.

Avaa ilmoituswebhookit

  1. Valitse sivupalkista Asetukset.
  2. Avaa Järjestelmä-kategoria.
  3. Valitse Ilmoituswebhookit.

Ilmoituswebhookit-sivu, jossa näkyy webhookien luettelo.

Lisää webhook

  1. Valitse Lisää webhook.
  2. Kirjoita nimi kenttään Nimi.
  3. Kirjoita osoite kenttään URL. Sen on alettava merkinnällä https://.
  4. Valinnainen: kirjoita salaisuus kenttään Salaisuus (valinnainen). AurionAI allekirjoittaa tällöin jokaisen pyynnön. Jätä kenttä tyhjäksi, jos haluat lähettää allekirjoittamattomia pyyntöjä.
  5. Valitse tapahtumat:
    • Jos haluat vastaanottaa kaikki ilmoitustapahtumat, ota käyttöön Tilaa kaikki tapahtumat.
    • Muussa tapauksessa valitse tapahtumat luettelosta.
  6. Valitse Luo.

Viesti Webhook luotu tulee näkyviin. Uusi webhook on Käytössä.

Testaa webhook

  1. Valitse webhookissa Testaa.
  2. Valitse Lähetetäänkö testihyötykuorma?-valintaikkunassa Lähetä testi.

AurionAI lähettää webhook.test-tapahtuman välittömästi. Viesti Testihyötykuorma lähetettiin onnistuneesti tai Testihyötykuorman lähetys epäonnistui tulee näkyviin.

Tarkista allekirjoitus

Kun webhookilla on salaisuus, jokaisessa pyynnössä on kaksi lisäotsikkoa:

  • X-Webhook-Timestamp: pyynnön aika sekunteina 1. tammikuuta 1970 (UTC) lähtien.
  • X-Webhook-Signature: sha256= ja sen jälkeen allekirjoitus.

Voit tarkistaa pyynnön laskemalla HMAC-SHA256-arvon aikaleimasta, pisteestä ja raakamuotoisesta sisällöstä salaisuutesi avulla. Kirjoita tulos heksadesimaalimuodossa. Sen on vastattava sha256=-merkkijonon jälkeistä osaa.

Muokkaa, poista käytöstä tai poista webhook

  • Voit muuttaa webhookia valitsemalla Muokkaa webhookia, muuttamalla kenttiä ja valitsemalla Tallenna. Jätä salaisuuskenttä tyhjäksi säilyttääksesi sen, tai valitse Poista salaisuus lähettääksesi allekirjoittamattomia pyyntöjä.
  • Voit keskeyttää toimitukset hetkeksi avaamalla Muokkaa webhookia ja kääntämällä kytkimen asentoon Pois käytöstä. Tallenna sitten.
  • Voit poistaa webhookin valitsemalla Poista. Valitse Poistetaanko tämä webhook?-valintaikkunassa Poista webhook. Tämä poistaa myös toimitushistorian ja salaisuuden. Toimintoa ei voi kumota.
  • Voit tarkastella aiempia toimituksia valitsemalla webhookissa Historia. Jokainen rivi näyttää tilan Toimitettu, Epäonnistui tai Ohitettu sekä epäonnistumisen syyn.

Tulos

AurionAI lähettää jokaisen valitun tapahtuman sen tapahtuessa. Jos osoitteesi ei vastaa tai vastaa 5xx-tilakoodilla, AurionAI yrittää uudelleen välittömästi, enintään kolme kertaa yhteensä. 4xx-vastaus on lopullinen: AurionAI ei yritä uudelleen.

Jos jokin menee pieleen

  • URL-osoitteen on alettava merkkijonolla https://. Aloita osoite merkinnällä https://.
  • Pilven metatietojen päätepisteet estetään aina. tai viesti, jonka mukaan IP-osoite on estetyllä alueella. AurionAI ei lähetä webhookeja yksityisiin tai sisäisiin osoitteisiin. Käytä julkista osoitetta.
  • Viesti ilmoittaa, että DNS-selvitys epäonnistui. Isäntänimeä ei ole olemassa tai sillä ei ole DNS-tietuetta. Tarkista osoite.
  • Valitse vähintään yksi tapahtuma tai valitse ”Tilaa kaikki tapahtumat”. Valitse vähintään yksi tapahtuma tai ota käyttöön Tilaa kaikki tapahtumat.
  • Testihyötykuorman lähetys epäonnistui Lue syy, HTTP-tilakoodi ja yritysten määrä viestistä. Tarkista, että vastaanottimesi on verkossa ja vastaa 2xx-tilakoodilla.
  • Tämä webhook on poistettu käytöstä Ota webhook ensin käyttöön. Jos valitset Lähetä silti, AurionAI kirjaa vain ohitetun yrityksen.
  • Toimitus näyttää tilan Ohitettu. Webhook oli poistettu käytöstä tai osoite ei läpäissyt turvatarkistusta ennen lähettämistä. Lue syy historiasta.
  • Webhookien lataaminen epäonnistui tai Ilmoitustapahtumien lataaminen epäonnistui Valitse Yritä uudelleen.

Aiheeseen liittyvät artikkelit

Etkö vieläkään löytänyt apua? Lähetä pyyntö tai .