Blog

Een scheduling marketplace aandrijven

Sydney OlejnikNov 16, 2022

Een scheduling marketplace: wat betekent dat? Hoe gebruiken we het?

Cal.com is gebouwd om je scheduling marketplace aan te drijven, maar veel mensen raken in de war wanneer ze de woorden “scheduling marketplace” horen.

Wat betekent het precies om een scheduling marketplace aan te drijven?

Het ideale scenario voor elk bedrijf is dat een klant op hun site blijft en niet wordt doorgestuurd naar een andere site voor welke actie dan ook. De scheduling infrastructure van Cal.com maakt het voor organisaties eenvoudig om dat voor elkaar te krijgen.

De beste manier om uit te leggen hoe dit werkt, is met een voorbeeld.

Stel dat je ervoor hebt gekozen om de API's van Cal.com te gebruiken om de scheduling marketplace van je bedrijf aan te drijven. Hoe ziet dat eruit? Het begint allemaal wanneer een klant zich aanmeldt op je gloednieuwe platform, dat we BestDogSitting gaan noemen. Wanneer de klant een account aanmaakt op BestDogSitting, wordt dat account ook aangemaakt op Cal.com via de API (Single Sign On); de klant kan daarna zijn beschikbaarheden toevoegen, die via API worden opgehaald in het Cal.com-platform, en vervolgens kan hij de event pages selecteren die hij wil. Terwijl Cal.com groeit en meer API's toevoegt, profiteren beide kanten van de solide infrastructuur.

Met de scheduling infrastructure van Cal.com kan BestDogSitting ook front-end UI-componenten bouwen en, met een van onze meer dan 40+ API-endpoints, die data heen en weer sturen naar het Cal.com-platform. Zo ontstaat een native scheduling-ervaring voor klanten zonder dat de hele scheduling-oplossing opnieuw gebouwd hoeft te worden. Als ons team iets heeft geleerd, dan is het wel dat planning en tijdzones extreem lastig zijn en veel meer werk kosten dan de meeste engineers zich realiseren.

Waar komt dit allemaal vandaan? Het antwoord is simpel: Lean Hire.

Lean Hire is een hiring marketplace die oorspronkelijk is gemaakt door onze CEO, Peer Richelsen. Bij gebruik van Lean Hire hebben organisaties de optie om contract-to-hire te gebruiken als proefperiode met hun potentiële kandidaten, in plaats van meteen vol in te stappen. Het idee werd veel gebruikt bij OnDeck (waar het uiteindelijk werd overgenomen) en wordt bij Cal.com nog steeds gebruikt als de belangrijkste manier om nieuwe teamleden aan te nemen.

Met Lean Hire moest elke keer dat een nieuwe gebruiker werd aangemaakt, de kandidaat óf zelf zijn Calendly-link toevoegen, óf moest Peer handmatig een nieuw account voor hen aanmaken. Dat was niet de beste ervaring, omdat het hen weghaalde van de Lean Hire-website, en Peer geen data of controle had over wat er aan de ontvangende kant gebeurde.

Toen hij in probleemoplossingsmodus ging, realiseerde Peer zich dat hij een scheduling product nodig had dat óf volledig in de website ingebed kon worden, óf robuuste API's had om taken zoals een nieuwe gebruiker aanmaken, scheduling links aanmaken, beschikbaarheden aanmaken en meer te automatiseren.

Oké, dat is interessant, maar wat betekent dat allemaal?

Het volledig aandrijven van een scheduling marketplace vereist sterke automatisering via API's. Deze API's maken het mogelijk om de scheduling-ervaring voor bedrijven volledig te creëren, zodat deze net zo native aanvoelt alsof ze die zelf hebben gebouwd.

Cal.com lost dit probleem op grote schaal op. Terwijl we blijven groeien en meer API's toevoegen, wordt ons Platform-product krachtiger, en organisaties kunnen bovendien self-hosten zodat ze toegang hebben tot alle data van begin tot eind. Elke organisatie kan meerdere soorten queries uitvoeren om te begrijpen wat hun gebruikers doen. Dit is momenteel niet mogelijk met andere producten en is specifiek voor wat Cal.com biedt. Met Cal hebben organisaties volledige controle over hun data om hun behoeften zo goed mogelijk te bedienen.

On-premise

Het Platform-product is ook een van de weinige on-premise producten die wordt aangeboden. On-premise betekent dat organisaties hun data op hun eigen servers kunnen self-hosten. Door self-hosting hebben organisaties volledige controle over hun gebruikersdata. Met deze holistische controle kunnen bedrijven hun gebruikersdata gebruiken zoals zij dat passend vinden. Daarnaast geeft dit hen veel meer controle en veiligheid.

Dit is geweldig; hoe kan ik dit gebruiken om mijn bedrijf te helpen?

Wanneer je self-host met Cal.com, creëer je de mogelijkheid om weer controle te krijgen over je data. Dit doe je het best via onze krachtige API-endpoints met ons Platform-product. Om wat ideeën te geven van wat er mogelijk is, volgen hier enkele van onze populairste API-endpoints tot nu toe:

API-endpoints [CRUD]:

Deelnemers

Beschikbaarheden

Boekingsreferenties

Boekingen

Aangepaste invoervelden

Doelkalenders

Eventreferenties

Scheduling links

Lidmaatschappen

Betalingen

Schema's

Geselecteerde kalenders

Teams

Gebruikers

Webhooks

Hier zijn enkele voorbeelden van hoe je die API-endpoints kunt gebruiken:

Scheduling Link API

Onze API's kunnen worden aangepast en geforkt om exact aan je behoeften te voldoen. Hieronder staan een paar voorbeelden van enkele huidige en in gebruik zijnde aanpassingen.

Om een nieuwe scheduling link aan te maken, kun je bijvoorbeeld het volgende doen:

[POST] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Body Raw Parameters:

{

    "userId": 4,

    "title": "Tennis class",

    "slug": "tennis-class-{{$guid}}",

    "length": 60,

    "hidden": false,

    "position": 0,

    "teamId": null,

    "eventName": null,

    "timeZone": null,

    "periodType": "UNLIMITED",

    "periodStartDate": null,

    "periodEndDate": null,

    "periodDays": null,

    "periodCountCalendarDays": null,

    "requiresConfirmation": true,

    "recurringEvent": {

        "interval": 2,

        "count": 10,

        "freq": 2

    },

    "disableGuests": false,

    "hideCalendarNotes": false,

    "minimumBookingNotice": 120,

    "beforeEventBuffer": 0,

    "afterEventBuffer": 0,

    "schedulingType": null,

    "price": 0,

    "currency": "usd",

    "slotInterval": null,

    "successRedirectUrl": null,

    "description": null,

    "locations": [

        {

            "address": "London",

            "type": "inPerson"

        }

    ],

    "metadata": {}

}

Om alle scheduling links op te halen, kun je bijvoorbeeld het volgende doen:

[GET] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Om een individueel planningslink bij te werken/PATCHen, kun je iets doen zoals het volgende:

[PATCH] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

waar :id de event-type-ID is (numeriek)

Body Raw Parameters:

{

    "title": "Football class",

     ...other_changes

}

Om een individuele planningslink te verwijderen, kun je iets doen zoals het volgende:

[DELETE] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

waar :id de event-type-ID is (numeriek)

Om een individueel eventtype op te halen, kun je iets doen zoals het volgende:

[GET] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

waar :id de event-type-ID is (numeriek)

Cal.com is de toonaangevende planningsoplossing die prioriteit geeft aan jouw vermogen om een planningsmarktplaats aan te sturen. We helpen je hier om je organisatie succesvol te maken.

Wil je aan de slag? Bekijk hier onze documentatie: https://developer.cal.com/api/quick-start 

Cal.com is nu GRATIS voor individuen - meld je hier aan

Sydney Olejnik

Post by

Sydney Olejnik

Administrative Coordinator