Qruuk
Ühendused ja automaatika

Iga skaneering võib käivitada järgmise sammu.

Iga broneering, kohalolek, tempel ja müük on Qruukis sündmus. Saada see oma tabelisse, uudiskirja, meeskonna vestlusesse või oma programmi ning lase kassal või e-poel müügid Qruukile edastada.

Miks Qruuk?

QR + hook.

Nimi tuleb sõnadest QR ja hook (konks, nagu sõnas webhook ehk veebikonks). Qruuk sai alguse arendajate tööriistana selle jaoks, mis juhtub pärast QR-koodi skannimist: automaatika ja kõik, mis skaneeringuga käima läheb. Praegu on see tööriist väikestele saalidele ja kohvikutele, aga skaneering on endiselt konks, mille külge kõik muu kinnitub.

Välja: sündmused

Mis Qruukis juhtub, jõuab sinna, kus seda vaja on.

Vali sündmused, millest soovid teada saada. Qruuk saadab iga sündmuse allkirjastatud POST-päringuna sinu aadressile koos kaardi, programmi ja kliendi andmetega.

Trennid ja broneeringud

  • session.bookedKlient broneeris koha
  • session.booking_cancelledBroneering tühistati
  • session.checked_inKlient märkis end kohale
  • session.check_in_undoneKohalolek võeti tagasi
  • session.no_showBroneeris, aga ei tulnud
  • session.cancelledTrenn või üritus jäi ära

Kaardid ja külastused

  • card.issuedUus kaart
  • entry.recordedLiikmekaardi või kuukaardiga külastus
  • ticket.usedPilet kontrolliti uksel
  • stamp.addedLisati templeid
  • reward.earnedPreemia on välja teenitud
  • reward.redeemedPreemia kasutati ära

Kliendid ja raha

  • customer.opted_inKlient nõustus sinult teateid saama
  • customer.unsubscribedKlient loobus teadetest
  • order.paidTellimus on makstud
Ideid

Milleks inimesed seda kasutavad.

Igaüks neist on üks sündmus ja üks samm Zapieris, Make'is või n8n-is.

session.checked_in

Kohalolek tabelisse

Iga kohalolek lisab Google Sheetsi rea: kuupäev, trenn, treener, klient. Klubi juhatuse aruanne on valmis.

session.no_show

Sõbralik meeldetuletus

Kes broneeris, aga ei tulnud, saab järgmisel hommikul e-kirja või SMS-i: „Eile jäid trennist puudu. Kohtume neljapäeval?“

session.booked

Teade treenerile

Uus broneering jõuab treeneri Slacki või Telegrami kanalisse.

customer.opted_in

Uudiskirja saajaks

Klient, kes nõustus sinult teateid saama, lisatakse Mailchimpi (või mõne muu teenuse) uudiskirja saajate hulka; kes loobub, see eemaldatakse.

order.paid

Raamatupidajale

Iga makstud tellimus lisab rea tabelisse, mille raamatupidaja kuu lõpus ette võtab.

reward.earned

Aitäh püsikliendile

Kui kaart saab täis, saab klient tänukirja või kupongi järgmiseks korraks.

Sisse: müük ja tegevused

Sinu teised süsteemid saavad Qruukiga suhelda.

Kassa, e-pood või sinu enda programm saab Qruukile müügist teada anda ja kaarte väljastada.

  • KassaÜhenda Loyverse või Erply ja ostu eest lisatakse templid automaatselt. Loyverse'is tehtud tagastus võtab templid tagasi. Core ja Pro paketis.
  • E-pood või muu süsteemSaada müük Qruukile („Record sale“): Qruuk leiab kliendi e-posti, telefoninumbri või kaardikoodi järgi ja lisab templid sinu reeglite järgi. Kaks korda saadetud tellimus läheb arvesse ühe korra.
  • Kaardid ja kliendidVäljasta kaart, kontrolli kaarti, lisa või muuda klienti, otsi klienti. Näiteks saab sinu kodulehe vormi kaudu liitunud uus liige kohe liikmekaardi.
Sinu veebileht

Tunniplaan ja kaardid sinu enda lehel.

Kleebi oma lehele kaks rida koodi: külastajad näevad nädala trenne, broneerivad koha ja ostavad kaardi otse sinu lehel. Andmed on samad mis broneerimislehel; töötab Wixis, WordPressis, Voogis, Squarespace'is ja tavalises HTML-is.

<script src="https://app.qruuk.com/embed.js" data-qruuk="your-studio"></script>
  • WixAdd → Embed code → Embed HTML. Kleebi kood ja lohista plokk sinna, kus tunniplaan peab olema.
  • WordPressLisa Custom HTML plokk (Elementoris Code plokk) ja kleebi kood sinna.
  • VoogLisa tekstiala, lülita HTML-vaatesse (<>) ja kleebi kood.
  • SquarespaceLisa Code plokk, kleebi kood ja jäta valituks „HTML“.
  • Oma lehtKleebi kood lehel sinna, kus tunniplaan peab olema.

Tasuta trenni broneerimiseks piisab eesnimest ja see käib otse plokis. Kaardi või ühekordse trenni eest maksmiseks avaneb sinu Qruuki makseleht ja kaart saadetakse e-postiga. Sinu aadressiga koodi ja eelvaate leiad: Seaded → Veebileht.

data-view näitab ainult tunniplaani (schedule), kaarte (passes) või lisasid (products); data-accent määrab nuppude värvi sinu lehe järgi, data-lang keele ja data-coach näitab ühe treeneri trenne.

Kuidas ühendada

Neli võimalust, üks API-võti.

  • VeebikonksudSeaded → Webhooks: lisa https-aadress ja vali sündmused. Iga päring on HMAC-allkirjaga, ebaõnnestunud saatmist proovitakse uuesti ja iga saatmine jääb logisse. Aadresside arv: 1 / 5 / piiramatult (tasuta / Core / Pro).
  • Zapier, Make ja n8nQruuki rakendused nendele platvormidele on valmis ja ootavad platvormide kataloogidesse lisamist. Seni kasuta nende veebikonksu- ja HTTP-samme koos Qruuki API-võtmega: sündmused saabuvad veebikonksuna, müügid ja kaardid saadad HTTP-päringuga.
  • APIREST API aadressil api.qruuk.com/v1: kaardid, kliendid, programmid, sündmused, veebikonksud ja müügid. Igal API-võtmel on ainult need õigused, mis sa talle annad. Võtmete arv: 1 / 5 / piiramatult.
  • Sinu AI-abilineClaude, ChatGPT ja teised saavad sinu eest tunniplaani koostada, kassa ühendada ja veebikonksud luua. Kõik, mis maksab raha, ootab sinu kinnitust. Kuidas →
Arendajale

Allkirjad ja korduskatsed.

Igal veebikonksu päringul on päis Qruuk-Signature: t=<aeg>,v1=<hmac>: HMAC-SHA256 sinu otspunkti salajase võtmega, arvutatud tekstist <aeg>.<keha>. Kui vastad koodiga 410, saatmine lõpetatakse. Ümbrise id on sündmuse id, nii et korduva saatmise tunned ära.

POST https://your-endpoint.example
Content-Type: application/json
Qruuk-Signature: t=1792646400,v1=5f2b…

{ "id": "e3b0c442-…", "type": "session.checked_in", "createdAt": "…", "data": { … } }

Täielik kirjeldus (OpenAPI, veebikonksud, MCP) on /llms.txt ja MCP ressurssides.

Pane skaneeringud enda heaks tööle.

Alusta tasuta. Veebikonks ja API-võti on olemas ka tasuta paketis.

Alusta tasuta →