Webhookit - Shifton Help

Webhookit mahdollistavat Shiftonin lähettämään reaaliaikaisia ilmoituksia ulkoisiin järjestelmiin, kun yrityksessäsi tapahtuu tapahtumia.

Vaiheittaiset ohjeet

Webhooks-välilehdelle pääsy

Napsauta vasemmassa sivupalkissa Integraatiot.

Siirry Kehittäjä-sivulle → Webhookit-välilehti.

Uuden webhookin luominen

Napsauta “Uusi webhook”.

Täytä määritykset:

Kenttä	Kuvaus
URL	Päätepiste tapahtumatietojen vastaanottamiseen
Tapahtumat	Shifton-tapahtumat, jotka aktivoivat webhookin
Aktiivinen	Käyttöön/pois-kytkin

Tallenna. Shifton lähettää HTTP POST -pyynnöt määritettyyn URL-osoitteeseen.

Webhookien hallinta

Napsauta webhookia muokataksesi URL-osoitetta, päivittääksesi tapahtumia tai muuttaaksesi aktiivisuustilaa.

Webhookin testaaminen

Käynnistä vastaava tapahtuma Shiftonissa (esimerkiksi luo testivuoro).

Tarkista palvelimesi lokit — tietojen tulisi saapua.

Aiheeseen liittyvät artikkelit

Usein kysytyt kysymykset

K: Missä muodossa vuoroon lähettää tietoja?
HTTP POST JSON-muotoisella sisällöllä. Tietorakenne tapahtumatyypeittäin löytyy API-dokumentaatiosta.

K: Voiko samalle tapahtumalle luoda useita webhookeja?
Kyllä, eri URL-osoitteilla.

K: Mitä jos palvelin ei ole käytettävissä webhookin lauetessa?
Toimitus voi epäonnistua. Uudelleenyritysperiaatteen tiedot löytyvät API-dokumentaatiosta.

K: Webhook ei laukea — miksi?
Varmista, että Aktiivinen-kytkin on päällä ja URL on julkisesti saatavilla.

K: Miten tarkistaa, että webhook vastaanottaa tietoja?
Luo testitapahtuma Shiftonissa (esimerkiksi lisää vuoro) ja tarkista palvelimesi lokit saapuvan POST-pyynnön varalta.

K: Voiko webhookin todennusta määrittää?
Kyllä. Lisää salainen avain tai token webhookin URL-osoitteeseen tai otsikoihin. Tarkemmat tiedot API-dokumentaatiossa.

K: Miltä webhookin pyynnön sisältö näyttää?
JSON-objekti tapahtumatiedoilla. Rakenne riippuu tapahtumatyypistä — katso API-dokumentaatio esimerkkejä varten.

K: Voiko yksi webhook seurata useita tapahtumia?
Kyllä. Webhookia luotaessa valitse useita tapahtumia — yksi URL vastaanottaa ilmoitukset kaikista valituista.

K: Mikä on webhookin “uudelleenyritysperiaate”?
Jos palvelin palauttaa virheen (ei 200), Shifton voi yrittää pyyntöä uudelleen. Tarkemmat tiedot riippuvat alustan konfiguraatiosta.

K: Onko webhookien määrää rajoitettu?
Dokumentaatiossa ei ole ilmoitettu rajoituksia, mutta suositellaan luomaan vain tarpeelliset.

K: Pitääkö webhookin URL-osoitteen käyttää HTTPS-protokollaa?
Suositellaan. HTTP-osoitteet voivat toimia, mutta HTTPS varmistaa turvallisen tiedonsiirron.

K: Voiko webhook-ilmoituksia vastaanottaa jokaisesta työvuoroListaaan muutoksesta?
Kyllä. Lisää tapahtumatyypit kuten “Vuoro luotu” tai “schedule updated” webhookin määrityksiin.

K: Kenellä on pääsy webhookien luomiseen?
Vain omistajalla ja ylläpitäjällä. Esimiehet ja työntekijät eivät näe Developer-osiota.

K: Voiko webhookin poistaa käytöstä poistamatta sitä?
Kyllä. Kytke Aktiivinen-kytkin pois päältä webhookin asetuksissa — se lakkaa laukeamasta, mutta säilyttää konfiguraation.

K: Lokitetaanko webhookien laukeamiset vuoroonissa?
Yksityiskohtaisia webhookin toimituslokeja ei tarjota käyttöliittymässä. Seuranta on palvelimesi puolella.

K: Voiko webhookia suodattaa projektin tai työvuoroListaaan mukaan?
Ei. Webhook laukeaa kaikista valitun tyypin tapahtumista koko yrityksessä. Suodatus on vastaanottavan palvelimen puolella.

K: Mitä webhookeille tapahtuu yrityksen poistamisen yhteydessä?
Kaikki webhookit poistetaan yrityksen mukana.