Agenda-API's
Google Calendar en Microsoft 365 hebben volwassen API's: vrij-bezet opvragen, afspraken wegschrijven en een seintje krijgen bij wijzigingen. iCloud kan via het oudere CalDAV-protocol, maar dat werkt minder soepel.
Een afsprakentool zoals Calendly nabouwen: dit komt erbij kijken
Een afsprakentool zoals Calendly bestaat uit een boekingspagina, beschikbaarheid die live uit gekoppelde agenda's komt, tijdzone-logica, herinneringen en eventueel betalingen en team-routing. Veel van die bouwstenen bestaan kant-en-klaar, van agenda-API's tot betaal-PSP's. De echte complexiteit zit in betrouwbare agenda-sync en het voorkomen van dubbele boekingen.
01
/
07
Wat een tool als Calendly allemaal doet
Achter een simpele boekingslink zit een flinke featureset. Dit is de inventaris.
Calendly oogt eenvoudig: je deelt een link, iemand kiest een tijdslot en de afspraak staat in beide agenda's. Onder die eenvoud zit veel functionaliteit. De tool leest je agenda's, Google, Outlook of iCloud, en vertaalt je vrije tijd naar boekbare sloten, met buffers tussen afspraken, een minimale aanlooptijd en een maximum per dag. De bezoeker ziet die sloten in zijn eigen tijdzone op een boekingspagina per afspraaktype, bijvoorbeeld een korte kennismaking of een langer consult.
Daarna neemt de tool het regelwerk over: bevestigingsmails, herinneringen per mail of SMS, verzetten en annuleren via een link, en automatisch een videobel-link aanmaken. Wie wil, koppelt er betalingen aan, zodat een consult pas geboekt is na het afrekenen. Voor teams komen daar routing en verdeling bij: een aanvraag komt binnen en de tool bepaalt bij wie die terechtkomt.
Voor de duidelijkheid: OneDayBuild is niet verbonden aan Calendly. We gebruiken de tool als bekend voorbeeld om te laten zien wat er bij een eigen afsprakentool komt kijken.
02
/
07
Wat je niet zelf hoeft te bouwen
De zwaarste onderdelen van zo'n tool bestaan als dienst. Je bouwt de logica eromheen, niet de infrastructuur.
Betalingen
Een PSP zoals Mollie of Stripe handelt de hele betaalstap af, van iDEAL tot creditcard, inclusief terugbetalingen. Jij koppelt alleen de status van de betaling aan de status van de boeking.
Mail en SMS
Bevestigingen en herinneringen verstuur je via diensten als Postmark, SendGrid of Twilio. Alleen de templates, de verzendmomenten en de koppeling met je boekingen richt je zelf in.
Ook videobellen hoef je niet zelf op te lossen: Zoom, Teams en Google Meet kunnen via hun API's automatisch een vergaderlink aanmaken bij elke boeking. En tijdzonedata houd je nooit zelf bij, elke serieuze programmeertaal leunt daarvoor op de internationale tijdzonedatabase.
03
/
07
Waar de complexiteit zit
De moeilijkheid zit niet in de schermen, maar in een paar factoren die bepalen hoeveel werk het wordt.
- Tijdzone-logica. Een bezoeker in New York boekt bij jou in Amsterdam, rond de zomertijdwissel, voor een moment dat bij hem op een andere datum valt. Al die combinaties moeten kloppen, ook in de herinneringen.
- Dubbele boekingen. Twee bezoekers kijken naar hetzelfde slot en klikken vrijwel tegelijk. Zonder goede afhandeling boeken ze allebei. Dit vraagt om het vasthouden van een slot tijdens het afronden, en een nette afwijzing voor de tweede.
- Betrouwbare agenda-sync. Koppelingen verlopen, seintjes van de agenda-API blijven soms uit, en mensen zetten afspraken in hun agenda buiten de tool om. De getoonde beschikbaarheid moet dan toch kloppen.
- Randregels. Buffers, aanlooptijd, een maximum per dag, vakanties en uitzonderingen. Elke regel is op zichzelf simpel, de combinatie bepaalt of mensen de tool durven te vertrouwen.
04
/
07
Team-routing: pas nodig als er meer agenda's meedoen
Voor één agenda is zo'n tool overzichtelijk. Met een team komt er een laag verdeel-logica bij.
Werk je alleen, dan is de kern: één agenda uitlezen en sloten tonen. Met een team wordt het groter. Round robin verdeelt aanvragen om de beurt over teamleden, een gezamenlijke afspraak vereist dat meerdere agenda's tegelijk vrij zijn, en een routingformulier stuurt een aanvraag op basis van een paar vragen naar de juiste persoon. Die verdeel-logica is goed te bouwen, maar telt stevig mee in de omvang. Begin daarom bij de vraag wie er daadwerkelijk geboekt wordt, en door wie.
Zoek je vooral iets voor eigen gebruik, bijvoorbeeld het inplannen van bezichtigingen, intakes of servicebezoeken door je eigen mensen, dan lijkt je tool meer op een interne tool dan op een publiek boekingsproduct. Dat scheelt flink in wat er nodig is: geen accounts voor bezoekers, geen betaalstap, geen publieke pagina's.
05
/
07
Wat je in één dag valideert
De kern van een afsprakentool is de boekingsflow. Precies dat deel kun je als klikbaar prototype aan echte gebruikers voorleggen.
-
Stap 1
De boekingspagina
Een bezoeker kiest een afspraaktype, ziet beschikbare sloten in een agendaweergave en prikt een moment. Hier merk je of je aanbod en je sloten logisch overkomen.
-
Stap 2
Gegevens en bevestiging
Naam, mailadres en eventueel een intakevraag, gevolgd door een bevestigingsscherm. Je test hoeveel je kunt vragen voordat mensen afhaken.
-
Stap 3
De betaalstap
Werk je met betaalde afspraken, dan zit de checkout in de flow. In het prototype zie je of vooraf afrekenen logisch voelt voor jouw doelgroep.
-
Stap 4
De beheerkant
Het scherm waarop jij of je team beschikbaarheid instelt en boekingen ziet binnenkomen. Vaak onderschat, terwijl je er zelf dagelijks in werkt.
Zo'n klikbaar prototype gedraagt zich als de echte tool, zonder dat er al een agenda-koppeling of betaalsysteem achter zit. Je legt het voor aan mensen die echt bij je zouden boeken en ziet waar ze aarzelen. Wil je daarna door naar een werkende eerste versie met echte boekingen, kijk dan bij booking-MVP laten maken.
Ga je hiermee naar een bouwer, dan zet de projectbrief-generator de scope alvast in een korte briefing.
06
/
07
Eerlijk over: wanneer een Calendly-abonnement gewoon slimmer is
Zelf bouwen is niet altijd het juiste antwoord. De vergelijking is snel gemaakt.
Een abonnement is genoeg als
- Je vooral je eigen afspraken wilt laten inplannen, alleen of met een klein team.
- De standaardflow past: link delen, slot kiezen, klaar.
- Boeken geen onderdeel is van een product dat je zelf wilt uitbouwen.
- Je vandaag wilt beginnen zonder iets te hoeven beheren.
Zelf bouwen wordt interessant als
- Boeken de kern is van je platform, zoals bij een marktplaats voor diensten.
- Je regels of flows nodig hebt die niet in een standaardtool passen.
- De boekingsdata en de klantrelatie in je eigen product moeten leven.
- Je de hele flow in je eigen merk en omgeving wilt.
Bouw je een platform waar vraag en aanbod elkaar vinden en waar het boeken van een dienst de kern is, dan lijkt je project meer op onze teardown van een platform zoals Werkspot dan op een losse agenda-tool.
07
/
07
Veelgestelde vragen
Mag ik zomaar een tool zoals Calendly nabouwen?
Ja, functionaliteit zoals een agenda-koppeling of het boeken van tijdsloten is niet beschermd, veel tools werken zo. Wat je niet mag: de naam, het logo of het letterlijke ontwerp van Calendly kopiëren. Je bouwt je eigen variant onder je eigen merk.
Heb ik toestemming van Google of Microsoft nodig voor de agenda-koppeling?
Je hebt geen aparte deal nodig, de API's zijn openbaar. Wel doorloop je bij Google een verificatieproces voordat je app gebruikers om toegang tot hun agenda mag vragen, omdat agendadata gevoelig is. Dat is een kwestie van aanvragen en aan de eisen voldoen.
Kan mijn eigen tool ook betalingen afhandelen?
Ja, via een betaaldienst zoals Mollie of Stripe. De bezoeker rekent af tijdens het boeken en de afspraak staat pas vast na een geslaagde betaling. Je bouwt zelf geen betaalsysteem en je komt niet aan kaartgegevens.
Werkt zo'n tool met alle agenda's?
Google en Microsoft 365 zijn goed te koppelen via hun eigen API's. iCloud en andere agenda's kunnen via het CalDAV-protocol, maar dat is bewerkelijker en minder betrouwbaar. Voor de meeste zakelijke doelgroepen dekken Google en Microsoft vrijwel alles.
Ik wil alleen een boekingsknop op mijn site, moet ik dan iets bouwen?
Nee. Als een standaard boekingspagina volstaat, kun je een bestaande tool op je site embedden en ben je klaar. Zelf bouwen wordt pas logisch als het boeken onderdeel is van iets groters dat van jou moet zijn.
Wat heb ik na één dag bij OneDayBuild in handen?
Een klikbaar prototype van de boekingsflow en de kernschermen, plus een technisch fundament en een roadmap voor de vervolgstappen. Daarmee kun je je plan toetsen bij echte gebruikers en gericht beslissen wat je laat bouwen.
