KoppelingenVirtuagym
Virtuagym koppelen aan je website.
Virtuagym is de software waarmee sportscholen, studio’s en clubs hun leden, lesrooster en abonnementen beheren. Voor een eigen website loopt de koppeling de andere kant op dan je zou denken: je bouwt zelf het formulier, en Virtuagym neemt de inschrijving of de lead in ontvangst.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Virtuagym je oplevert.
Je eigen inschrijfformulier. Een formulier in jouw huisstijl, in jouw flow, dat een lid aanmaakt in Virtuagym.
Proeflessen als lead. Een aanvraag komt binnen in de Lead Module en niet in een mailbox, dus opvolging is te sturen.
Rooster op je site. Het lesrooster staat op je eigen pagina’s met een embedcode die meebeweegt met je ontwerp.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- Twee API’s voor een eigen site: Club Member (V1) en Lead (V3). Het rooster gaat met een embedcode en niet via de API
- Authenticatie
- V1 met een API Key en Club Key uit de systeeminstellingen; V3 met een client id en secret die je inwisselt voor een token
- Richting
- Van de site naar het systeem
- Verversing
- Leden en leads gaan direct mee bij het versturen; het rooster ververst zichzelf via de embedcode
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De documentatie is niet openbaar, ook al is de API dat wel. Virtuagym zet hem op GitHub en geeft toegang op aanvraag: je mailt api@virtuagym.com met je GitHub-gebruikersnaam. Dat is geen formaliteit maar een stap met doorlooptijd, en zonder die toegang valt er niets te bouwen. Zet hem aan het begin van het traject.
- De koppeling gaat naar Virtuagym toe, niet ervandaan. Wat hun eigen artikel over website-integratie beschrijft zijn twee API’s die iets aanmaken: een lid via de Club Member API en een lead via de Lead API. Je lesrooster op je site zetten staat er los van en gaat met een embedcode. Reken er dus niet op dat je met deze twee API’s je aanbod uit Virtuagym trekt.
- Het formulier is van jou. Virtuagym zegt het zo: het online inschrijfformulier moet je zelf maken en bouwen, zij leveren alleen de API. Dat is precies waarom deze koppeling de moeite waard is — je bent niet gebonden aan hun vormgeving — maar het betekent ook dat validatie, foutafhandeling en de bevestiging aan de bezoeker jouw werk zijn.
- De twee API’s beveiligen zich verschillend, en dat verwart. V1 werkt met een API Key en een Club Key, allebei te vinden onder systeeminstellingen, bedrijfsinformatie, geavanceerd; je Club ID is de eerste cijferreeks in de Club Key. V3 werkt met een client id en een client secret die je eerst inwisselt voor een token. Twee stelsels in één koppeling, dus leg vast welke sleutel waarbij hoort.
Virtuagym koppelen
Wat je moet weten voor je begint.
Wat is Virtuagym?
Virtuagym is software voor sportscholen, studio’s en clubs. Ledenbeheer, abonnementen en facturatie, het lesrooster met reserveringen, toegangscontrole en een app voor leden zitten in hetzelfde pakket.
De naam is ook bekend bij consumenten, want er is een app voor sporters zelf. Voor een clubwebsite gaat het om de zakelijke kant: wie er lid is, wat er op het rooster staat en hoe iemand zich aanmeldt.
Dat laatste is waar een website het verschil maakt. Een bezoeker die een proefles wil of lid wil worden, is op dat moment het dichtst bij een beslissing. Waar dat formulier staat en hoe het eruitziet bepaalt hoeveel er doorheen komt.
Hoe de koppeling met je website werkt
Virtuagym noemt in hun eigen artikel twee API’s voor een website, en allebei schrijven ze iets weg.
De Club Member API, versie 1, maakt een lid aan. Meldt iemand zich via een formulier op jouw site, dan staat het account daarna in Virtuagym. Er is een instelling om de uitnodigingsmail automatisch te versturen; die moet aan staan, anders krijgt het nieuwe lid niets. De Lead API, versie 3, doet hetzelfde voor een lead en zet die in de Lead Module, zodat een proeflesaanvraag opvolgbaar wordt in plaats van in een mailbox te belanden.
Het lesrooster is een ander verhaal. Dat zet je op je site met een embedcode uit de roosterinstellingen: systeeminstellingen, roosterinstellingen, het gewenste rooster, geavanceerd, en onderaan staat de code. Het rooster past zich aan de breedte van je site aan en de kleuren zijn aan je huisstijl aan te passen.
Wat de API wel en niet kan
Wel: een lid aanmaken en een lead aanmaken, vanuit een formulier dat jij bouwt en vormgeeft. Dat is de kern, en voor een clubsite die op aanmeldingen stuurt is dat ook het belangrijkste.
Niet, althans niet volgens wat Virtuagym over website-integratie publiceert: je aanbod of je rooster eruit halen om er eigen pagina’s van te maken. Daar wijzen ze naar de embedcode. Wat er verder in de API zit is niet na te lezen zonder toegang tot hun GitHub, en wij schrijven hier niet op wat we niet hebben gezien.
Dat is ook precies de eerste vraag die we stellen als je hierover belt: wat moet er op je site staan, en wat moet erin komen. Voor het tweede is er een API. Voor het eerste kijken we samen naar de embed, of vragen we de documentatie aan om te zien wat er wél kan.
Een embed of je eigen pagina’s
De embedcode is snel klaar en past zich aan je huisstijl aan. Voor een rooster dat vooral bestaande leden bekijken is dat prima.
Het verschil zit in wat er van je aanbod overblijft voor iemand die je nog niet kent. Wat in een embed staat komt niet in de HTML van je eigen pagina: geen eigen adres per les of per locatie, geen eigen tekst eromheen, niets wat een zoekmachine als jouw aanbod herkent. Wie zoekt op een lesvorm in jouw plaats, vindt die pagina niet.
Daar zit voor een sportclub de winst, en daarom kijken we bij zo’n traject verder dan de koppeling alleen: eigen pagina’s voor wat je aanbiedt en waar je zit, met het formulier erop dat via de API in Virtuagym landt. De embed kan daarnaast blijven staan voor het rooster zelf.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn lesrooster uit Virtuagym op mijn eigen website tonen?
Ja, met een embedcode. Die staat in de systeeminstellingen onder de roosterinstellingen: kies het rooster, ga naar geavanceerd, en onderaan staat de code. Het rooster past zich aan de breedte van je site aan en de kleuren zijn aan je huisstijl aan te passen.
Heeft Virtuagym een API?
Ja, twee voor website-integratie: de Club Member API om een lid aan te maken en de Lead API om een lead aan te maken. De documentatie staat op GitHub en is niet openbaar; je vraagt toegang aan via api@virtuagym.com met je GitHub-gebruikersnaam.
Kan iemand zich via mijn eigen website inschrijven?
Ja, dat is precies waar de Club Member API voor is. Het formulier bouw je zelf, in je eigen vormgeving en je eigen flow, en de inschrijving maakt daarna een lid aan in Virtuagym. Zet wel de instelling aan die de uitnodigingsmail automatisch verstuurt.
Waar komt een proeflesaanvraag terecht?
In de Lead Module van Virtuagym, als je de Lead API gebruikt. Dat is een ander stelsel dan de Club Member API: je hebt er een client id en secret voor die je inwisselt voor een token. Het voordeel is dat opvolging meetbaar wordt in plaats van in een mailbox te verdwijnen.
Waar vind ik mijn API Key en Club Key?
In Virtuagym onder systeeminstellingen, bedrijfsinformatie, geavanceerd. Je Club ID is de eerste cijferreeks in de Club Key. Die twee horen bij de Club Member API; de Lead API werkt met een aparte set gegevens die je bij Virtuagym opvraagt.
Werkt een Virtuagym-koppeling ook op WordPress?
Ja. Het formulier bouwen we in je WordPress-site en de aanmelding gaat vanaf de server naar Virtuagym, zodat de sleutels niet in de paginabron staan. De embedcode voor het rooster plaatsen we op de pagina waar dat hoort.
Let’s work together.
Je eigen inschrijfformulier, je leden in Virtuagym.