Julkinen API ja webhookit

Thrilin julkisen API:n avulla oma kehittäjänne tai integraatiokumppaninne voi käyttää yrityksenne tietoja Thrilissä omista järjestelmistänne. Webhookit toimivat toiseen suuntaan: Thril lähettää järjestelmillenne viestin, kun jokin muuttuu.

---

API:n käyttökohteitaKopioi ankkurilinkki

• Oma raportointi. Hakekaa maksut ja hyvitykset raportointityökaluun tai taulukkoon ja raportoikaa niin kuin hallitus tai kirjanpitäjä haluaa.
• Ajan tasalla pysyvä CRM. Hakekaa asiakkaanne ja heidän jäsenyytensä CRM:ään. Webhookit kertovat CRM:lle, kun uusi asiakas liittyy, kun jäsenyys myönnetään ja kun jäsenyys on päättymässä.
• Aikataulunne omilla verkkosivuillanne. Näyttäkää tapahtumanne, kurssinne, turnauksenne ja vapaat ajat Thrilistä verkkosivuilla, joita ylläpidätte itse.
• Kausivuorot toisesta järjestelmästä. Seuran tai koulun järjestelmä varaa viikoittaisen vakiovuoron koko kaudeksi sovittuun hintaan.
• Lahjakortit ja kampanjakoodit omista työkaluistanne. Antakaa maksuton lahjakortti palkinnoksi tai hyvitykseksi valituksesta, tai luokaa kampanjakoodi kumppanin kampanjaan.
• Hinnat samassa tahdissa toisen järjestelmän kanssa. Lukekaa ja muuttakaa resurssienne hinnoittelusääntöjä.

---

API:n tiedot ja toiminnotKopioi ankkurilinkki

API lukee toimipisteenne, resurssit, vapaat ajat ja hinnat, varaukset ja vakiovuorot, tapahtumat, kurssit ja turnaukset osallistujineen, asiakkaat, maksut ja hyvitykset, lahjakortit, saldolataukset ja kampanjakoodit. Sillä voi varata vakiovuoroja, antaa lahjakortteja, luoda kampanjakoodeja ja muuttaa resurssien hinnoittelusääntöjä.

API:n asiakkaat ovat ihmisiä, joilla on Thril-tili. Vapaat ajat tulevat sellaisina kuin liikuntapaikkanne ne näkee. Verkkosivu, joka näyttää ne, soveltaa varausikkunat, jäsenyyssäännöt ja alennukset itse. Asiakkaat tekevät yksittäiset varaukset, tapahtumailmoittautumiset ja maksut Thrilissä. API:n kautta tehdyistä varauksista, lahjakorteista ja kampanjakoodeista ei lähde asiakkaalle viestiä, ja järjestelmänne toimittaa lahjakortin koodin.

Yrityksenne saa Thrililtä yhden API-tunnisteen. Se ulottuu yrityksenne kaikkiin toimipisteisiin. Käsitelkää sitä kuin salasanaa, sillä kuka tahansa, jolla tunniste on, voi lukea asiakkaidenne tiedot. Pyyntöjen määrälle on päiväkohtainen raja.

Kehittäjänne löytää kuvauksen jokaisesta pyynnöstä ja webhookista osoitteesta api-public.thril.fi/docs.

Samalla tunnisteella voi yhdistää myös Clauden, ChatGPT:n ja muut tekoälyavustajat tietoihinne ilman kehittäjää. Lue lisää sivulta Thril Claudessa, ChatGPT:ssä ja muissa tekoälyavustajissa.

---

WebhookitKopioi ankkurilinkki

Webhook on viesti, jonka Thril lähettää omassa järjestelmässänne olevaan osoitteeseen, kun jotain tapahtuu. Kehittäjänne määrittää vastaanottavat osoitteet API:n kautta ja valitsee, mitkä muutokset kukin saa:

• varaus tehty, muutettu tai peruttu sekä vakiovuorosarja tehty, muutettu tai peruttu
• osallistuja liittynyt tapahtumaan tai poistunut siitä sekä tapahtuma tai turnaus peruttu
• uusi asiakas liittynyt yritykseenne
• jäsenyys myönnetty asiakkaalle tai jäsenyys päättymässä

Webhookit työnkuluistaKopioi ankkurilinkki

Työnkulun Lähetä webhook -askel kertoo järjestelmillenne, että asiakas, varaus, lasku tai jäsenyys on edennyt työnkulussa siihen kohtaan. Nimeätte tapahtuman ja valitsette arvot, jotka se välittää, esimerkiksi asiakkaan sähköpostiosoitteen ja jäsenyyden nimen. CRM voi silloin aloittaa oman jatkotoimensa samasta kohdasta.